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

トピックで仮想エージェントカルーセルユーザー入力コントロールを使用して、(NLU/キーワード) トピックのラベル付き画像の自然言語理解 (NLU)水平方向のシーケンスを表示します。ユーザーは、カルーセルから単一のアイテムを選択することができます。

ヒント:

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

LLM トピック検出のカルーセル入力コントロールのプロパティ

プロパティ	説明
ノード名	トピックフローでこのカルーセルユーザー入力コントロールノードを識別する名前です。
詳細な説明	ユーザーが行った選択を格納する変数の名前です。変数名は、ノード名プロパティから自動的に作成されます。
カルーセルアイテムを定義	カルーセルで選択する項目を作成するためにスクリプトを使用します。スクリプトは、1 つ以上の項目を含む配列を返す必要があります。後述するカルーセル項目の式の例を参照してください。
詳細
ユーザープロンプトを強制	切り替えて、LLM によって生成されたメッセージの代わりにユーザーに表示されるカスタムメッセージのフィールドを開きます。
LLM に対する追加指示	データ形式、制限、またはユーザー応答のデフォルト値の追加など、LLM への詳細な指示。データピルピッカーを使用して、分かりやすい言葉で追加の指示を作成したり、スクリプトを入力したり、条件を定義したりすることができます。
このノードを非表示
次の場合、このノードを条件付きで表示します	会話でこのノードを表示するための条件を指定するノーコード条件ステートメントまたはローコードスクリプト。条件は [true] と評価される必要があります。

LLM トピック検出のカルーセル入力コントロールの例

カルーセルのプロパティ	カルーセルプロンプト
図 : 1. カルーセルユーザー入力コントロールの基本プロパティ 図 : 2. LLM トピック検出のための詳細なカルーセルユーザー入力オプション	図 : 3. Web UI カルーセルプロンプト

NLU トピック検出のカルーセル入力コントロールのプロパティ

プロパティ	説明
ノード名	トピックフローでこのカルーセルユーザー入力コントロールノードを識別する名前です。
変数名	ユーザーが行った選択を格納する変数の名前です。変数名は、ノード名プロパティから自動的に作成されます。
プロンプト	ユーザーへのプロンプトまたは質問。プロンプトは、テキスト文字列またはテキストを返すスクリプトのいずれかです。この値は、デフォルト値が指定されていない場合にのみ使用されます。例：[名前は何ですか (What's your name?)]
NLU エンティティ	NLU エンティティをノードに関連付けるオプション。NLU エンティティがこのノードの入力変数に関連付けられている場合、仮想エージェントはユーザーの発言に基づいて指定された値をスロットに入力できます。トピックインテントに関連付けられているエンティティのリストからエンティティを選択します。 ノードのエンティティを指定すると、[認識されたエンティティの確認をユーザーに依頼しない (Do not ask users to confirm recognized entity)] トグルスイッチが表示されます。有効にすると、ユーザーは抽出されたエンティティの確認を求められません。 このフィールドは、インスタンスで 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 を有効にしてトピックを切り替える	このノードの NLU 予測を有効にするオプション。有効にすると、ユーザーは、使用されている入力コントロールのタイプに関係なく、質問に回答するテキストを入力できます。仮想エージェントは、この発言を使用して既存の別のインテントを照合し、ユーザーがトピックを切り替えられるようにします。
このノードを非表示またはスキップ
次の場合、このノードを条件付きで表示します	会話でこのノードを表示するための条件を指定するノーコード条件ステートメントまたはローコードスクリプト。条件は [true] と評価される必要があります。
次の場合、ユーザーにこのノードのスキップを許可	会話でユーザーにこのノードをスキップさせるための条件を指定するノーコード条件ステートメントまたはローコードスクリプト。

NLU トピック検出のカルーセル入力コントロールの例

注:

仮想エージェントデザイナーコントロールは、他のチャネルでは表示や機能が異なる場合があります。

カルーセルのプロパティ	カルーセルプロンプト
	図 : 4. Web UI カルーセルプロンプト
	図 : 5. ServiceNow Mobile カルーセルプロンプト

カルーセル項目の式の例

(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'
            }
       );
       options.push(
            {
                'Name': 'Item 2',
                'Value': 'item_2',
                'Description': 'Acme keyboard model 300',
                'Body': 'https://images.pexels.com/photos/916472/pexels-photo-916472.jpeg'
            }
       );
       return options;

})()

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

表 : 1. コードキーの例

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

チャネルサポート

表 : 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	サポート対象	なし
Alexa (音声アシスト機能)	サポート対象	画面デバイスの場合は、タッチスクロールを使用します。画面以外のデバイスの場合は、音声ページネーションを使用します。