カルーセルユーザー入力コントロール

ヒント:

1 ページに表示されるデフォルトのアイテム数を変更するには、com.glide.cs.picker_page_limit システムプロパティを変更します。デフォルト値は 10 です。

LLM トピックディスカバリー用のカルーセル入力コントロールのプロパティ


プロパティ	説明
ノード名	トピックフローでこのカルーセルユーザー入力コントロールノードを識別する名前です。
カルーセルアイテムを定義	カルーセルで選択する項目を作成するためにスクリプトを使用します。スクリプトは、1 つ以上の項目を含む配列を返す必要があります。このトピックの、カルーセル項目の式の例のセクションを参照してください。
詳細 (オプション)
ユーザープロンプトの実行
ユーザープロンプトの実行	切り替えて [ユーザープロンプト] フィールドを開きます。LLM によって生成されたメッセージではなく、[ユーザープロンプト] フィールドの値がユーザーに表示されます。わかりやすい言葉を使用してカスタムメッセージを作成したり、データピルピッカーで条件を定義したりすることができます。
妥当性検証	ユーザー入力を検証するスクリプトを追加します。たとえば、ユーザーが有効なメールアドレスを入力したかどうかを確認します。
LLM に対する追加指示	データ形式、制限、またはユーザー応答のデフォルト値の追加など、LLM への詳細な指示。分かりやすい言葉で追加の指示を作成したり、スクリプトを入力したり、データピルピッカーを使用して条件を定義したりすることができます。
このノードを非表示またはスキップ
次の場合、このノードを条件付きで表示します：	会話でこのノードを表示するための条件を指定するノーコード条件ステートメントまたはローコードスクリプト。条件は true と評価される必要があります。このフィールドは、カルーセルノードが入力コレクターノード内で使用されている場合は適用されません。
次の場合、ユーザーにこのノードのスキップを許可	会話でユーザーにこのノードをスキップさせるための条件を指定するノーコード条件ステートメントまたはローコードスクリプト。条件は true と評価される必要があります。このフィールドは、条件ビルダーまたはスクリプトのいずれかを使用して設定できます。

LLM トピックディスカバリー用のカルーセル入力コントロールの例


カルーセルのプロパティ	カルーセルプロンプト
	図 : 1. Web UI カルーセルプロンプト

NLU トピックディスカバリー用のカルーセル入力コントロールのプロパティ


プロパティ	説明
ノード名	トピックフローでこのカルーセルユーザー入力コントロールノードを識別する名前です。
変数名	ユーザーが行った選択を格納する変数の名前です。変数名は、ノード名プロパティから自動的に作成されます。
プロンプト	ユーザーへのプロンプトまたは質問。プロンプトは、テキスト文字列またはテキストを返すスクリプトのいずれかです。この値は、デフォルト値が指定されていない場合にのみ使用されます。例：`[名前は何ですか (What's your name?)]`
NLU エンティティ	NLU エンティティをノードに関連付けるオプション。NLU エンティティがこのノードの入力変数に関連付けられている場合、仮想エージェントはユーザーの発言に基づいて指定された値をスロットに入力できます。トピックインテントに関連付けられているエンティティのリストからエンティティを選択します。ノードのエンティティを指定すると、[認識されたエンティティの確認をユーザーに要求しない] トグルスイッチが表示されます。有効にすると、ユーザーは抽出されたエンティティの確認を求められません。このフィールドは、インスタンスで NLU ディスカバリーが有効になっている場合にのみ使用できます。
カルーセルアイテムを定義	カルーセルで選択する項目を作成するためにスクリプトを使用します。スクリプトは、1 つ以上の項目を含む配列を返す必要があります。このトピックの、カルーセル項目の式の例のセクションを参照してください。
レコード応答メッセージなし	レコードが見つからなかったことを示すユーザーへのメッセージ。メッセージは、文字列か、文字列を返すスクリプトのいずれかです。
詳細
デフォルト値
デフォルト値	質問またはプロンプトに対するユーザー応答の事前定義済みの値です。[デフォルト値の確認] フィールドで定義された応答では、ユーザーにデフォルト値の確認を求めます。ユーザーが「 `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. Web UI カルーセルプロンプト
	図 : 3. ServiceNow モバイルカルーセルプロンプト

カルーセル項目の式の例

(function execute() {
    var options = [];
       options.push(
            {
                'Name': 'Item 1',
                'Value': 'item_1',
                'Description': 'Acme keyboard model 200',
                'Body': 'https://images.pexels.com/photos/688666/pexels-photo-688666.jpeg'
                'Card_name': 'AcmeCard'
                'Card_data': {"identifier":"IT hardware and software","header":"Acme keyboard model 200","description":"The model 200 keyboard is a ten-key-less keyboard."}
            }
       );
       options.push(
            {
                'Name': 'Item 2',
                'Value': 'item_2',
                'Description': 'Acme keyboard model 300',
                'Body': 'https://images.pexels.com/photos/916472/pexels-photo-916472.jpeg'
                'Card_name': 'AcmeCard'
                'Card_data': {"identifier":"IT hardware and software","header":"Acme keyboard model 300","description":"The model 300 keyboard is a full-size keyboard with a ten-key pad."}
            }
       );
       return options;

})()

カルーセル項目の式プロパティのスクリプトは、カルーセルに表示される項目を含む配列を定義して返します。この配列の要素には、 名前、 値、 および本文 のキーが含まれている必要があります。この例では、スクリプトは options というアレイを作成し、それぞれが必要なキーを持つ 2 つの要素を追加しています。ここで、画像は例としてハードコードされています。

表 : 1. コードキーの例
キー	説明
名前	カルーセル項目の名前です。この名前はカルーセルの画像の下に表示されます。
値	アイテムの値です。ユーザーがカルーセル項目を選択すると、この値は変数名プロパティで名前付けされた変数内に格納されます。
説明	カルーセル項目を説明するテキスト文字列です。説明は画像名の下に表示されます。アイテムが 3 個を超えるカルーセルには、画像をスクロールするための左右の矢印と、各アイテムの下に [選択] ボタンが表示されます。説明が 140 文字を超える場合、ユーザーはコンテンツを展開できます。
本文	カルーセル項目で使用される画像です。値は画像ファイルの URL です。
Card_name	カルーセルに表示されるカードを識別するテキスト文字列ヘッダー。
Card_data	カードに表示されるテキスト文字列を含むアレイ。値には、識別子、ヘッダー、および説明が含まれます。

チャネルサポート

表 : 2. カルーセルユーザー入力コントロールのチャネルサポート
チャネル	サポート	制約
Web UI	サポート対象	なし
モバイル UI	サポート対象	なし
Now Assist パネル	サポート対象	なし
Microsoft Teams	サポート対象	なし。カルーセルに 10 個を超えるアイテムが含まれている場合、ユーザーは [次へ] を選択して残りのアイテムを確認する必要があります。
Slack	サポート対象	なし
Workplace	サポート対象	なし
Facebook Messenger	サポート対象	画像のタイトルの最大文字数は 40 文字です。画像のテキストの最大文字数は 60 文字です。ユーザーに対して一度に表示される画像の数は 10 個です。画像が 10 個を超える場合、その他のオプションを表示するためにページネーション形式が使用されます。1 ページあたりのカルーセルの画像の最大数のデフォルト値は、sn_va_fb_messenger.max_carousel_cards システムプロパティで設定されます。このプロパティは、システムプロパティ [sys_properties] テーブルにあります。
SMS Twilio	サポート対象外	適用外
LINE	サポート対象	画像のタイトルの最大文字数は 40 文字です。画像のテキストの最大文字数は 60 文字です。ユーザーに対して一度に表示される画像の数は 10 個です。画像が 10 個を超える場合、その他のオプションを表示するためにページネーション形式が使用されます。1 ページあたりのカルーセルの画像の最大数のデフォルト値は、sn_va_line.max.carousel.cards システムプロパティで設定されます。プロパティは、システムプロパティ [sys_properties] テーブルにあります。
WhatsApp	サポート対象	なし
Apple Messages for Business	サポート対象	なし
Alexa (音声アシスト機能)	サポート対象	画面デバイスの場合は、タッチスクロールを使用します。画面以外のデバイスの場合は、音声ページネーションを使用します。