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