静的選択ユーザー入力コントロール
仮想エージェントトピックの静的選択ユーザー入力コントロールを使用して、ユーザーが使用できる事前定義された選択肢を一覧表示します。選択リストから 1 つの項目のみを選択できます。
選択肢の表示
選択リストには、ページあたり最大 10 個のアイテムが含まれます。10 個を超えるアイテムが存在する場合、追加のアイテムを表示して、検索結果をフィルタリングすることができます。選択リストのプロンプトには、ユーザーが結果をフィルタするために選択できる検索アイコン (
) が含まれています。
-
ヘッダーカードには、大小の画像または YouTube ビデオカードを、説明テキストとともに含めることができます。選択リストにはデフォルトで最大 5 個のアイテムが含まれますが、検索機能は非表示になります。アイテムが 5 個より多くある場合、ユーザーは追加のアイテムを表示することを選択できます。
-
ヘッダーカードの下に表示されるアイテムの数を制御するには、com.glide.cs.web_header_picker_page_limit システムプロパティを追加します。[値] を使用して、選択リストに表示されるアイテムの数を指定します。システムプロパティの作成の詳細については、「システムプロパティを追加する」を参照してください。
LLM トピックディスカバリー用の静的選択肢ユーザー入力コントロールのプロパティ
| プロパティ | 説明 |
|---|---|
| 名前 | トピックフローでこの静的選択ユーザーコントロールノードを識別する名前です。 |
| 選択肢 | |
| 表示名 |
各選択について、その選択用にユーザーに表示されるテキストです。選択リスト内では短いフレーズを使用してください。
|
| 値 | 各選択について、対応する選択肢が選択されたときに変数に格納される文字列です。 |
| [Advanced (詳細)] | |
| ヘッダーカード |
切り替えて、画像または YouTube 動画を含む可能性があるカードを追加するためのフィールドを開きます。詳細については、「静的選択肢またはダイナミック選択肢コントロールにヘッダーカードを挿入する」を参照してください。 |
| ユーザーにプロンプトを強制 |
切り替えて、大規模言語モデル (LLM) が生成するメッセージの代わりに、ユーザーに表示するカスタムメッセージのフィールドを開きます。分かりやすい言葉でカスタムメッセージを作成したり、スクリプトを入力したり、データピルピッカーを使用して条件を定義したりすることができます。 |
| 妥当性検証 |
ユーザー入力を検証するスクリプトを追加します。たとえば、ユーザーが有効なメールアドレスを入力したかどうかを確認します。 |
| LLM に対する追加指示 |
データ形式、制限、またはユーザー応答のデフォルト値の追加など、LLM への詳細な指示。分かりやすい言葉で追加の指示を作成したり、スクリプトを入力したり、データピルピッカーを使用して条件を定義したりすることができます。 |
| このノードを非表示またはスキップ | |
| 次の場合、このノードを条件付きで使用します： | 会話でこのノードを表示するための条件を指定するノーコード条件ステートメントまたはローコードスクリプト。条件は true と評価される必要があります。 |
| 次の場合、ユーザーにこのノードのスキップを許可 |
会話でユーザーにこのノードをスキップさせるための条件を指定するノーコード条件ステートメントまたはローコードスクリプト。条件は true と評価される必要があります。このフィールドは、条件ビルダーまたはスクリプトのいずれかを使用して設定できます。 |
LLM トピックディスカバリー用の静的選択肢ユーザー入力コントロールの例
| 入力プロパティ | リストプロンプト |
|---|---|
|
|
選択リストには、ページあたり 10 個のアイテムが表示されます。10 件以上の結果が返された場合、以下が発生します。
|
NLU トピックディスカバリー用の静的選択肢ユーザー入力コントロールのプロパティ
| プロパティ | 説明 |
|---|---|
| ノード名 | トピックフローでこの静的選択ユーザーコントロールノードを識別する名前です。 |
| 詳細な説明 | ユーザーに提供してもらう必要がある情報。たとえば、 必要なサービスカタログアイテムをユーザーに尋ねます。 |
| 変数名 | このプロンプトに対するユーザー応答を格納する変数の名前です。変数名は、ノード名プロパティから自動的に作成されます。 |
| プロンプト |
ユーザーへのプロンプトまたは質問。プロンプトは、テキスト文字列またはテキストを返すスクリプトのいずれかです。この値は、デフォルト値が指定されていない場合にのみ使用されます。例：[名前は何ですか (What's your name?)] リッチテキストを作成して、プロンプトのスタイルを変更できます。
|
| NLU エンティティ |
NLU エンティティをノードに関連付けるオプション。NLU エンティティがこのノードの入力変数に関連付けられている場合、仮想エージェント はユーザーの発言に基づいて指定された値をスロットに入力できます。トピックインテントに関連付けられているエンティティのリストからエンティティを選択します。 ノードのエンティティを指定すると、[認識されたエンティティの確認をユーザーに要求しない] トグルスイッチが表示されます。有効にすると、ユーザーは抽出されたエンティティの確認を求められません。 このフィールドは、インスタンスで NLU ディスカバリーが有効になっている場合にのみ使用できます。 |
| 選択肢 | |
| 表示名 |
各選択について、その選択用にユーザーに表示されるテキストです。選択リスト内では短いフレーズを使用してください。
|
| 値 | 各選択について、対応する選択肢が選択されたときに変数に格納される文字列です。 |
| 詳細 | |
| ヘッダーカード |
切り替えて、画像または 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 トピックディスカバリー用の静的選択肢ユーザー入力コントロールの例
| 入力プロパティ | リストプロンプト |
|---|---|
|
|
選択リストには、ページあたり 10 個のアイテムが表示されます。10 件以上の結果が返された場合、以下が発生します。
|
|
選択リストには、ページあたり 5 個のアイテムが含まれます。5 個以上の結果が返された場合、リストにはさらに多くの結果を表示するオプションが表示されます。
注: ヘッダーカードを使用すると、検索機能は非表示になります。 |
チャネルサポート
| チャネル | サポート | 制約 |
|---|---|---|
| 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] テーブルにあります。 |
| サポート対象 | なし | |
| Apple Messages for Business | サポート対象 | なし |
| Alexa (音声アシスト機能) | サポート対象 | 画面デバイスの場合は、タッチスクロールを使用します。画面以外のデバイスの場合は、音声ページネーションを使用します。 |