静的選択ユーザー入力コントロール

仮想エージェントトピックの静的選択ユーザー入力コントロールを使用して、ユーザーが使用できる事前定義された選択肢を一覧表示します。選択リストから 1 つの項目のみを選択できます。

選択肢の表示

選択リストには、ページあたり最大 10 個のアイテムが含まれます。NLU 会話に 10 個を超えるアイテムが存在する場合は、追加のアイテムを表示し、検索結果をフィルタリングすることもできます。選択リストのプロンプトには、検索アイコン ユーザーが選択して結果をフィルタリングできます。LLM チャット会話に 10 を超えるアイテムが存在する場合、スクロールバーが表示されます。LLM チャット会話に 16 を超えるアイテムが存在する場合、検索バーが表示されます。

静的選択コントロールには、選択リストの上に表示されるヘッダーカードを追加するオプションがあります。ヘッダーカードは、Web およびモバイルチャネルでサポートされています。

• ヘッダーカードには、大小の画像または YouTube ビデオカードを、説明テキストとともに含めることができます。選択リストにはデフォルトで最大 5 個のアイテムが含まれますが、検索機能は非表示になります。アイテムが 5 個より多くある場合、ユーザーは追加のアイテムを表示することを選択できます。

• ヘッダーカードの下に表示されるアイテムの数を制御するには、com.glide.cs.web_header_picker_page_limit システムプロパティを追加します。[値] を使用して、選択リストに表示されるアイテムの数を指定します。システムプロパティの作成の詳細については、「システムプロパティを追加する」を参照してください。

LLM トピックディスカバリー用の静的選択肢ユーザー入力コントロールのプロパティ

プロパティ	説明
名前	トピックフローでこのノードを識別する名前。
変数名	このプロンプトに対するユーザー応答を格納する変数の名前です。変数名は、ノード名プロパティから自動的に作成されます。
自動スロット入力を許可	このノードの値を、トピックディスカバリー中に他のノードによって自動的に設定できるようにする場合に切り替えます。この切り替えを有効にすると、[詳細な説明] フィールドが、動的なデータピルピッカーとスクリプトオプションから静的テキストフィールドに変わります。
詳細な説明	ユーザーからの必要な情報の説明。[ 自動スロット入力を許可 ] トグルが無効になっている場合は、[データピルピッカー] アイコン を選択して、動的な詳細記述を作成できます。 をクリックして条件を定義するか、[エディターを開く] アイコン [ をクリックしてスクリプトを入力します。[自動スロット入力を許可 (Allow automatic slot filling)] トグルが有効になっている場合は、静的な説明のみを入力できます。
選択肢
表示名	各選択について、その選択用にユーザーに表示されるテキストです。選択リスト内では短いフレーズを使用してください。 Slack では、選択リストのラベルに 30 文字の制限があります。 Workplace では、選択リストのラベルに 20 文字の制限があります。
値	各選択について、対応する選択肢が選択されたときに変数に格納される文字列です。
詳細
ヘッダーカード	切り替えて、画像または YouTube 動画を含む可能性があるカードを追加するためのフィールドを開きます。詳細については、「静的選択肢またはダイナミック選択肢コントロールにヘッダーカードを挿入する」を参照してください。
ユーザーにプロンプトを強制	切り替えて、大規模言語モデル (LLM) が生成するメッセージの代わりに、ユーザーに表示するカスタムメッセージのフィールドを開きます。分かりやすい言葉でカスタムメッセージを作成したり、スクリプトを入力したり、データピルピッカーを使用して条件を定義したりすることができます。
妥当性検証	ユーザー入力を検証するスクリプトを追加します。たとえば、ユーザーが有効なメールアドレスを入力したかどうかを確認します。
LLM に関する追加説明	データ形式、制限、またはユーザー応答のデフォルト値の追加など、LLM への詳細な指示。分かりやすい言葉で追加の指示を作成したり、スクリプトを入力したり、データピルピッカーを使用して条件を定義したりすることができます。
このノードを非表示またはスキップ
次の場合、このノードを条件付きで使用します：	会話でこのノードを表示するための条件を指定するノーコード条件ステートメントまたはローコードスクリプト。条件は true と評価される必要があります。
次の場合、ユーザーにこのノードのスキップを許可	会話でユーザーにこのノードをスキップさせるための条件を指定するノーコード条件ステートメントまたはローコードスクリプト。条件は true と評価される必要があります。このフィールドは、条件ビルダーまたはスクリプトのいずれかを使用して設定できます。 条件でスキップが許可されていない場合にユーザーが「このステップを省略」などの値を入力すると、ノードをスキップできないことを示すメッセージが表示され、回答を入力するように再度求められます。

LLM トピックディスカバリー用の静的選択肢ユーザー入力コントロールの例

注:

仮想エージェントデザイナーコントロールは、他のチャネルでは表示や機能が異なる場合があります。

入力プロパティ	リストユーザープロンプト
	図 : 1. 静的選択リストのプロンプトの例

NLU トピックディスカバリー用の静的選択肢ユーザー入力コントロールのプロパティ

プロパティ	説明
ノード名	トピックフローでこのノードを識別する名前。
詳細な説明	ユーザーに提供してもらう必要がある情報。たとえば、必要なサービスカタログアイテムをユーザーに尋ねます。
変数名	このプロンプトに対するユーザー応答を格納する変数の名前です。変数名は、ノード名プロパティから自動的に作成されます。
プロンプト	ユーザーへのプロンプトまたは質問。プロンプトは、テキスト文字列またはテキストを返すスクリプトのいずれかです。この値は、デフォルト値が指定されていない場合にのみ使用されます。例：[名前は何ですか (What's your name?)] リッチテキストを作成して、プロンプトのスタイルを変更できます。 斜体のテキストには、単一のアスタリスクまたはアンダースコアを使用します。たとえば、*text* や _text_ などです。 太字のテキストには二重のアスタリスクまたはアンダースコアを使用します。たとえば、**text** や __text__ などです。 斜体と太字のテキストには、3 つのアスタリスクまたはアンダースコアを使用します。たとえば、***text*** や ___text___ などです。 行に箇条書きを追加するには、間隔を空けたハイフンを使用します。たとえば、- text などです。 ブロック引用符を作成するには、間隔を空けた右山括弧を使用します。たとえば、 > text などです。 ヘッダーを作成するには 1 ～ 6 個のハッシュマークを使用します。たとえば、#text# や ######text###### などです。 ハイパーリンクを作成するには、角括弧と丸括弧を使用します。たとえば、[Link text](url) などです。画像を表示するには、ハイパーリンクに感嘆符を追加します。たとえば、 などです。
NLU エンティティ	NLU エンティティをノードに関連付けるオプション。NLU エンティティがこのノードの入力変数に関連付けられている場合、仮想エージェント はユーザーの発言に基づいて指定された値をスロットに入力できます。トピックインテントに関連付けられているエンティティのリストからエンティティを選択します。 ノードのエンティティを指定すると、[認識されたエンティティの確認をユーザーに要求しない] トグルスイッチが表示されます。有効にすると、ユーザーは抽出されたエンティティの確認を求められません。 このフィールドは、インスタンスで NLU ディスカバリーが有効になっている場合にのみ使用できます。
選択肢
表示名	各選択について、その選択用にユーザーに表示されるテキストです。選択リスト内では短いフレーズを使用してください。 Slack では、選択リストのラベルに 30 文字の制限があります。 Workplace では、選択リストのラベルに 20 文字の制限があります。
値	各選択について、対応する選択肢が選択されたときに変数に格納される文字列です。
詳細
ヘッダーカード	切り替えて、画像または YouTube 動画を含む可能性があるカードを追加するためのフィールドを開きます。詳細については、「静的選択肢またはダイナミック選択肢コントロールにヘッダーカードを挿入する」を参照してください。
デフォルト値
デフォルト値	質問またはプロンプトに対するユーザー応答の事前定義済みの値です。[デフォルト値の確認] フィールドで定義された応答では、ユーザーにデフォルト値の確認を求めます。ユーザーが「 no」で応答した場合、値は null になります。デフォルト値は、テキスト文字列またはテキストを返すスクリプトのいずれかです。たとえば、ドット連結を使用している場合、デフォルト値は Script Variables > Last username になります。または、スクリプトを使用している場合、デフォルト値は {{vaScripts.lastUsername}} になります。
確認メッセージ
入力完了確認	ノードのインタラクションが完了したときにユーザーに表示されるボット応答。メッセージは、テキスト文字列またはテキストを返すスクリプトのいずれかです。たとえば、ドット連結を使用している場合は、次のようになります。Thanks, (Input Variables > Username)! または、スクリプトを使用している場合、確認応答は次のようになります。Thanks, {{vaInputs.username}}!
デフォルト値の確認	[デフォルト値 (Default value)]フィールドの値が正しいことを検証するようにユーザーに求めるメッセージ。このメッセージは、 [プロンプト (Prompt)] フィールドの値の代わりに使用されます。テキスト文字列またはテキストを返すスクリプトのいずれかが含まれる可能性があります。たとえば、ドット連結を使用している場合は、次のようになります。Are you (Input Variables > Username)? またはスクリプトを使用している場合、確認メッセージは次のようになり ます。Are you {{vaScripts.lastUsername}}?
会話の切り替え
このセクションは、インスタンスで NLU ディスカバリーが有効な場合にのみ使用できます。
ユーザーが件名を変更できるようにするにはオンにします	このノードの NLU 予測を有効にするオプション。有効にすると、使用している入力コントロールのタイプに関係なく、ユーザーはテキストを入力して質問に回答できます。仮想エージェント はこの発言を使用して別の既存のインテントを照合し、ユーザーがトピックを切り替えられるようにします。
このノードを非表示またはスキップ
次の場合、このノードを条件付きで表示します	会話でこのノードを表示するための条件を指定するノーコード条件ステートメントまたはローコードスクリプト。条件は true と評価される必要があります。
次の場合、ユーザーにこのノードのスキップを許可	会話でユーザーにこのノードをスキップさせるための条件を指定するノーコード条件ステートメントまたはローコードスクリプト。条件は true と評価される必要があります。このフィールドは、条件ビルダーまたはスクリプトのいずれかを使用して設定できます。
次の場合、再プロンプトをスキップ	会話でユーザーが再プロンプトをスキップできるようにするための条件を指定するノーコード条件ステートメントまたはローコードスクリプト。トピックループバックまたはダイアログアクションで先行するノードに再度アクセスすると、仮想エージェントはこのノードをバイパスし、元の値を自動的に保持します。

NLU トピックディスカバリー用の静的選択肢ユーザー入力コントロールの例

注:

仮想エージェントデザイナーコントロールは、他のチャネルでは表示や機能が異なる場合があります。

入力プロパティ	リストプロンプト
図 : 2. 静的選択入力コントロールの基本プロパティ 図 : 3. [カードを追加] ダイアログボックス (ヘッダーカードの詳細オプション)	図 : 4. Web UI 静的選択リストプロンプト 図 : 5. 10 個を超えるアイテムを含む Web UI 静的選択リストプロンプト 選択リストには、ページあたり 10 個のアイテムが表示されます。10 件以上の結果が返された場合、以下が発生します。 リストの最後に、さらに多くの結果を表示するためのリンクがあります。 検索結果をフィルタリングするための検索アイコンがプロンプトに表示されます。このアイコンを選択して検索ボックスを開き、フィルターを入力します。
	図 : 6. ヘッダーカードを含む Web UI 静的選択リスト 選択リストには、ページあたり 5 個のアイテムが含まれます。5 個以上の結果が返された場合、リストにはさらに多くの結果を表示するオプションが表示されます。 注: ヘッダーカードを使用すると、検索機能は非表示になります。

チャネルサポート

表 : 1. 静的選択ユーザー入力コントロールのチャネルサポート

チャネル	LLM サポート	NLU/キーワードのサポート	制約
Web UI	サポート対象外	サポート対象	なし
モバイル UI	サポート対象外	サポート対象	なし
Now Assist パネル	サポート対象外	サポート対象	なし
Microsoft Teams	サポート対象	サポート対象	なし
Slack	サポート対象外	サポート対象	ヘッダーカードはサポートされていません。 選択リストに選択肢が 3 つ以下の場合、Slack ではそのリストがボタンとして表示されます。
Workplace	サポート対象外	サポート対象	ヘッダーカードはサポートされていません。
Facebook Messenger	サポート対象外	サポート対象	クイック返信でのラベルの最大文字数は 20 文字です。一度に表示できるクイック返信の数は 13 件です。クイック返信の数が 13 を超える場合は、その他のオプションを表示するためにページネーション形式が使用されます。1 ページあたりの返信の最大数のデフォルト値は、sn_va_fb_messenger.max_quick_replies システムプロパティで設定されます。このプロパティは、システムプロパティ [sys_properties] テーブルにあります。
SMS Twilio	サポート対象	サポート対象	ヘッダーカードはサポートされていません。
LINE	サポート対象外	サポート対象	クイック返信でのラベルの最大文字数は 20 文字です。一度に表示できるクイック返信の数は 13 件です。クイック返信の数が 13 を超える場合は、その他のオプションを表示するためにページネーション形式が使用されます。1 ページあたりの返信の最大数のデフォルト値は、sn_va_line.max.picker.choices システムプロパティで設定されます。このプロパティは、システムプロパティ [sys_properties] テーブルにあります。
WhatsApp	サポート対象	サポート対象	なし
Apple Messages for Business	サポート対象外	サポート対象	なし
Alexa (音声アシスト機能)	サポート対象外	サポート対象	画面デバイスの場合は、タッチスクロールを使用します。画面以外のデバイスの場合は、音声ページネーションを使用します。