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

ヒント:

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

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


プロパティ	説明
ノード名	トピックフローでこのノードを識別する名前。
変数名	このプロンプトに対するユーザー応答を格納する変数の名前です。変数名は、ノード名プロパティから自動的に作成されます。
自動スロット入力を許可	このノードの値を、トピックディスカバリー中に他のノードによって自動的に設定できるようにする場合に切り替えます。この切り替えを有効にすると、[詳細な説明] フィールドが、動的なデータピルピッカーとスクリプトオプションから静的テキストフィールドに変わります。
詳細な説明	ユーザーからの必要な情報の説明。[ 自動スロット入力を許可 ] トグルが無効になっている場合は、[データピルピッカー] アイコンを選択して、動的な詳細記述を作成できます。をクリックして条件を定義するか、[エディターを開く] アイコン [ をクリックしてスクリプトを入力します。[自動スロット入力を許可 (Allow automatic slot filling)] トグルが有効になっている場合は、静的な説明のみを入力できます。
カルーセルアイテムを定義	カルーセルで選択する項目を作成するためにスクリプトを使用します。スクリプトは、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. カルーセルユーザー入力コントロールのチャネルサポート
チャネル	LLM サポート	NLU/キーワードのサポート	制約
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 (音声アシスト機能)	サポートされていません	サポート対象	画面デバイスの場合は、タッチスクロールを使用します。画面以外のデバイスの場合は、音声ページネーションを使用します。