---
sourceDocument: Yokohama 対話型インターフェース
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/yokohama/conversational-interfaces

 Release :

    - yokohama

ft:locale :

    - ja-JP

ft:publication_title :

    - Yokohama 対話型インターフェース

ft:clusterId :

    - convint

bundleId :

    - convint

workflow :

    - Platform


---

# 仮想エージェントデザイナーユーザー入力コントロール

# 仮想エージェントデザイナーユーザー入力コントロール {#ariaid-title1}

* リリースバージョン: Yokohama
* 
* 更新日 2025年01月30日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：3分

仮想エージェントデザイナーに用意されている一連の入力コントロール使用して、会話中のユーザーからの情報を求めてキャプチャします。

## 一般的な入力コントロールプロパティ {#va-user-inputs__section_a4j_hsb_vcc}

[データピルと条件コントロール](https://servicenow-prod.fluidtopics.net/7n87ycZjp9CKZcjlCeGDew "仮想エージェントトピックは、トピックフロー内のコントロールのコレクションで構成されます。これらのコントロールを使用して、ユーザーに情報を収集、処理、提供します。コントロールは、インスタンス上のレコードを読み取り、作成し、更新することもできます。")に加えて、各入力コントロールには次の共通プロパティがあります。  

ユーザー応答の入力変数
:   各コントロールは、`getValue` メソッドおよび `getDisplayValue` メソッドを使用して、ユーザーの応答を、同じトピック内の他のコントロールからアクセス可能な入力変数に格納します。変数名は、入力コントロールに割り当てた名前に基づいています。たとえば、入力コントロールに <kbd class="ph userinput">First prompt</kbd> という名前を割り当てた場合、変数名は `first_prompt` になります。変数名は小文字で、スペースの代わりにアンダースコア文字を使用します。これらのメソッドの詳細については、「[仮想エージェント スクリプト](https://servicenow-prod.fluidtopics.net/REB1hgd8nxeXvKa95iuQeQ "ServiceNow 仮想エージェント スクリプトのメソッドと変数を使用して、応答、トリガー、フロースクリプトなどのチャットスクリプトを記述します。変数は、ライブサポートトピックと会話のコンテキストを提供することもできます。")」を参照してください。
:
    図 : 1. 自動的に入力される \[変数名\] フィールド

## 大規模言語モデル (LLM) ユーザー入力コントロール {#va-user-inputs__section_bn4_dy3_jcc}

LLM 仮想エージェント トピックを作成すると、次のユーザー入力コントロールが LLM トピックでサポートされます。LLM ユーザー入力には次のものがあります。

* [入力コレクター](https://servicenow-prod.fluidtopics.net/uX36tITYPwYjZQMHW5Xz2A "入力コレクターコントロールを使用して、大規模言語モデル (LLM) トピックディスカバリーを使用する会話で Now Assist が使用するデータを収集します。")
* [テキスト入力](https://servicenow-prod.fluidtopics.net/N6miRZHIAxXKVguMG6~WHg "仮想エージェントトピック内のテキストユーザー入力コントロールは、ユーザーにテキスト文字列の入力を求めます。")
* [静的選択リスト](https://servicenow-prod.fluidtopics.net/~8apGte50jPHFM012pot_w "仮想エージェントトピックの静的選択ユーザー入力コントロールを使用して、ユーザーが使用できる事前定義された選択肢を一覧表示します。選択リストから 1 つの項目のみを選択できます。")
* [ダイナミック選択肢リスト](https://servicenow-prod.fluidtopics.net/gDHE4v~O_zAR_7AsVsxDmQ "仮想エージェント トピックでダイナミック選択肢ユーザー入力コントロールを使用して、ユーザーに使用可能な選択肢のリストを動的に作成します。これらの選択肢は、表を照会するか、動的に作成されるようスクリプトを使用して作成します。")
* [ブール入力](https://servicenow-prod.fluidtopics.net/X~lAOSqzrSITlzHzE9W23g "仮想エージェントトピックでブールユーザー入力コントロールを使用して、ユーザーに「はい / いいえ」プロンプトを表示します。")
* [日時入力](https://servicenow-prod.fluidtopics.net/iXTnduUQSMtWs82a80k1Uw "日時ユーザー入力コントロールを仮想エージェントトピックで使用し、ユーザーがカレンダーの日付、時刻 (時および分)、またはその両方を選択できるようにします。")
* [カルーセル入力](https://servicenow-prod.fluidtopics.net/IjPHQgVb63Ip_lIGAg~RMw "仮想エージェントトピックでカルーセルユーザー入力コントロールを使用し、プロンプトと水平方向の一連のラベル付き画像を表示します。ユーザーは、カルーセルから単一のアイテムを選択することができます。")
{#va-user-inputs__ul_r2f_4y3_jcc}  
注:  
1 つの LLM トピックに 5 つ以上のユーザー入力コントロールを配置したり、1 つの入力コレクターに 5 つ以上のユーザー入力コントロールを配置したりしないでください。過剰なユーザー入力コントロールは LLM を圧倒し、不正確または予期しない応答につながる可能性があります。

## 自然言語理解 (NLU) (NLU) エンティティプロパティ {#va-user-inputs__id_kxn_knb_vcc}

:   NLU を有効にすると、テキスト、静的選択、ダイナミック選択、ブール値、日時、およびカルーセルの入力コントロールに対する以下のプロパティがプロパティシートに表示されます。これらのプロパティを表示または有効にするには、 \[詳細オプション\] セクションに移動します。

    * NLU エンティティ：コントロールの入力変数に対応するエンティティです。トピックに使用している NLU モデルでの定義に従って、トピックインテントに関連付けられたエンティティのリストからエンティティを選択します。仮想エージェント がユーザーの発言におけるエンティティ値を認識し、その値がエンティティ予測の信頼性しきい値内に収まっている場合、仮想エージェント はその値を抽出します。この値は、ノードの入力変数に保存されます。この格納アクションは、スロット入力と呼ばれます。スロット入力では、会話で同じ NLU エンティティに対して複数の値が発生した時点を認識します。複数のノードが同じ NLU エンティティに関連付けられている場合、選択するノード値を確認するためにリストが表示されます。このプロパティは、 NLU トピックディスカバリーでのみ使用できます。  
      図 : 2. NLU エンティティのプロパティ ![トピックディスカバリーが有効になっている場合は、NLU エンティティトグルをスライドして NLU トピックを選択します。]()
    * NLU を有効にしてトピックを切り替える：ノードの NLU 予測を有効にします。有効にすると、使用している入力コントロールのタイプに関係なく、ユーザーはテキストを入力して質問に回答できます。仮想エージェント はこの発言を使用して別の既存のインテントを照合し、ユーザーがトピックを切り替えられるようにします。ノードでこのプロパティを有効にするには、 詳細オプショントピックの切り替え.  
      図 : 3. NLU を有効にしてトピックを切り替えるプロパティ ![\[詳細オプション\] - \[トピックの切り替え\] で、\[NLU を有効にしてトピックを切り替える\] トグルをスライドしてトピックプロパティを切り替えます。]()
    {#va-user-inputs__ul_h3d_jwn_thb}

デフォルト値
:   入力プロンプトには、定義したプリセット値を含めることができます。この値は、文字列か、文字列を返すスクリプトのいずれかです。このプロパティは \[詳細オプション\] セクションにあります。
:
    図 : 4. デフォルト値のプロパティ

確認メッセージ
:   これらのボット応答メッセージは、ノードインタラクションの終了を示し、ユーザーに応答を確認するように求めます。このプロパティは \[詳細オプション\] セクションにあります。
:
    図 : 5. 確認メッセージのプロパティ
* **[入力コレクターのユーザー入力コントロール](https://servicenow-prod.fluidtopics.net/uX36tITYPwYjZQMHW5Xz2A)**   
  入力コレクターコントロールを使用して、大規模言語モデル (LLM) トピックディスカバリーを使用する会話で Now Assist が使用するデータを収集します。
* **[テキストユーザー入力コントロール](https://servicenow-prod.fluidtopics.net/N6miRZHIAxXKVguMG6~WHg)**   
  仮想エージェントトピック内のテキストユーザー入力コントロールは、ユーザーにテキスト文字列の入力を求めます。
* **[静的選択ユーザー入力コントロール](https://servicenow-prod.fluidtopics.net/~8apGte50jPHFM012pot_w)**   
  仮想エージェントトピックの静的選択ユーザー入力コントロールを使用して、ユーザーが使用できる事前定義された選択肢を一覧表示します。選択リストから 1 つの項目のみを選択できます。
* **[\[グループ化された選択肢\] ユーザー入力コントロール](qSKiIKs92NbE_SA2Wsr9Ug)**   
  仮想エージェント トピックの \[グループ化された選択肢\] ユーザー入力コントロールを使用して、1 つのメッセージに複数の選択肢のグループをリストします。
* **[ダイナミック選択肢ユーザー入力コントロール](https://servicenow-prod.fluidtopics.net/gDHE4v~O_zAR_7AsVsxDmQ)**   
  仮想エージェント トピックでダイナミック選択肢ユーザー入力コントロールを使用して、ユーザーに使用可能な選択肢のリストを動的に作成します。これらの選択肢は、表を照会するか、動的に作成されるようスクリプトを使用して作成します。
* **[ブールユーザー入力コントロール](https://servicenow-prod.fluidtopics.net/X~lAOSqzrSITlzHzE9W23g)**   
  仮想エージェントトピックでブールユーザー入力コントロールを使用して、ユーザーに「はい / いいえ」プロンプトを表示します。
* **[日時ユーザー入力コントロール](https://servicenow-prod.fluidtopics.net/iXTnduUQSMtWs82a80k1Uw)**   
  日時ユーザー入力コントロールを仮想エージェントトピックで使用し、ユーザーがカレンダーの日付、時刻 (時および分)、またはその両方を選択できるようにします。
* **[ファイルピッカーのユーザー入力コントロール](https://servicenow-prod.fluidtopics.net/Q~xXNKBqzCr511uoho4aVA)**   
  仮想エージェントトピックでファイルピッカーのユーザー入力コントロールを使用して、ユーザーに画像または任意タイプのファイルをアップロードするよう求めます。ユーザーが画像ファイルをアップロードすると、画像はすぐに仮想エージェントクライアントに表示されます。
* **[カルーセルユーザー入力コントロール](https://servicenow-prod.fluidtopics.net/IjPHQgVb63Ip_lIGAg~RMw)**   
  仮想エージェントトピックでカルーセルユーザー入力コントロールを使用し、プロンプトと水平方向の一連のラベル付き画像を表示します。ユーザーは、カルーセルから単一のアイテムを選択することができます。
* **[安全なテキストユーザー入力コントロール](https://servicenow-prod.fluidtopics.net/sDJB3OlKMS2CIWxI6A4cfw)**   
  安全なテキストコントロールは、単純なテキストまたはその他の形式で提供される機密情報を暗号化する手段を提供します。このコントロールを使用して、大規模言語モデル (LLM) ディスカバリーを使用するトピックの機密情報を暗号化します。