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

ヒント:

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

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

注:

カルーセルユーザー入力コントロールは、 Now Assist in 仮想エージェントではサポートされていません。


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