NLU を活用した仮想エージェントのサービスカタログトピックブロック

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：8分

    • 要求送信タスクを実行するための再利用可能なトピックブロックを含めることにより、自然言語理解 (NLU) (NLU) を活用した仮想エージェントでトピック会話を設計できます。

    カタログアイテムの検索

    このトピックブロックを使用して、検索条件に基づいてカタログアイテムを検索できます。検索結果が複数ある場合は、カルーセルビューから 1 つ選択できます。
    表 : 1. 入力パラメーター
    パラメーター 説明
    query_term カタログアイテムを検索するためのキーワード。カタログアイテムのキーワード検索の設定については「カタログアイテムのキーワード検索の設定」を参照してください。
    catalogs カタログアイテムを検索する必要があるカタログのカンマ区切りリスト。
    result_limit 表示する必要がある検索結果の数。デフォルトでは 5 に設定されています。
    表 : 2. 出力パラメーター
    パラメーター 説明
    catalog_item_id カタログアイテムが選択されている場合は、アイテムの sys_id が返されます。

    カタログアイテムが選択されていない、つまりこれらのオプションが全く選択されていない場合は -1 が返されます。
    item_type ユーザーが選択したカタログアイテムの sys_class_name。
    is_conversational 仮想エージェントの会話モードでカタログアイテムを要求できるかどうかを指定します。

    カタログアイテムを要求する

    このトピックブロックを使用して、カタログアイテムを要求できます。

    表 : 3. 入力パラメーター
    パラメーター 説明
    catalog_item_id 要求する必要があるカタログアイテムの sys_id。
    execute_contextual_search レコードプロデューサーの構成に基づいてコンテキスト検索を実行するかどうかを指定するオプション。レコードプロデューサーのコンテキスト検索の定義については「レコードプロデューサーのコンテキスト検索の定義 (Define contextual search for record producer)」を参照してください。
    confirm_catalog_item ユーザーが次のステップに進む前にカタログアイテムを確認する必要があるかどうかを指定するオプション。false に設定されている場合、ユーザーは確認をスキップしてカタログアイテムの質問に回答できます。
    show_end_state_card 生成されたレコードに関する終了ステータスカード情報をユーザーに表示するオプション。
    表 : 4. 出力パラメーター
    パラメーター 説明
    record_id アイテム送信後に生成されるレコードの sys_id。

    カタログアイテムが会話モードでサポートされていない、またはユーザーがアイテムへのアクセス権を持っていない場合は、-1 が返されます。
    record_table レコードが生成されるテーブルの名前。
    変数 カタログアイテムに関連する質問。

    仮想エージェントの表示タイプ

    カタログアイテムは、仮想エージェントで会話、ウィンドウ、ポップアップ、またはインラインとして表示できます。

    会話の表示タイプを使用したカタログアイテム要求

    (インラインで質問に回答することで) ユーザーは要求を会話モードで送信できます。
    会話として表示される仮想エージェント

    ユーザーが NLU を利用する仮想エージェントの会話モードでカタログアイテムを要求する場合は、次の条件を満たす必要があります。

    • カタログアイテムには、glide.sc.conversational.request.question.limit プロパティで指定された数を超える質問を含めることはできません。デフォルトでは 10 に設定されます。このプロパティの詳細については「サービスカタログ のプロパティ」を参照してください。
    • カタログアイテムには、スクリプト化されていないカタログ UI ポリシーを含めることができます。これらの UI ポリシーは変数が順次影響を受けるように、つまり下位の変数が上位の変数に影響を与えるように定義する必要があります。
    • Now Mobile またはサービスポータル用に定義されたカタログクライアントスクリプトは、カタログアイテムに含めることができません。
    • 次の変数のみがサポートされています。
      • 添付ファイル
      • チェックボックス (チェックボックス変数のグループはサポートされていません)
      • 日付
      • 日付/時刻
      • メール
      • IP アドレス
      • ラベル
      • ルックアップ複数の選択肢 (想定価格および詳細参照修飾子なし)
      • ルックアップ選択ボックス (想定価格および詳細参照修飾子なし)
      • 複数の選択肢 (想定価格なし)
      • 複数行テキスト
      • 数値スケール (想定価格なし)
      • 参照 (想定価格および詳細参照修飾子なし)
        注:
        7000 を超えるレコードを持つテーブルに対応する参照タイプ変数はサポートされていません。レコード数の上限は glide.sc.va.reference_question_choices.limit プロパティで指定できます。デフォルトでは、7000 に設定されています。
      • 要求元 (想定価格および詳細参照修飾子なし)
      • リッチテキストラベル
      • 選択ボックス (想定価格なし)
      • 1 行テキスト
      • URL
      • ワイドな 1 行テキスト
      • はい/いいえ
      • コンテナ変数
    • 次の変数属性がサポートされています。
      • ref_ac_order_by
      • allowed_extensions
      • max_file_size
      注:
      その他のすべての変数属性は、仮想エージェントでは無視されます。
    • カタログアイテムには単一行変数セットを設定できますが、複数行の変数セットは設定できません。
    • カタログアイテムに質問のデフォルト値が設定されている場合は、デフォルト値は仮想エージェントに表示されるため、ユーザーは手動で選択しなくてもデフォルト値を使用できます。ユーザーは、デフォルト値以外の値を選択することもできます。
    • カタログアイテムに質問のデータルックアップが設定されている場合は、セッター値は仮想エージェントに表示されるため、ユーザーはセッター値を使用するか、別の値を選択できます。セッターの質問が照合の質問に先行する場合、データルックアップを含むカタログアイテムは会話アイテムとしてサポートされません。
    • ユーザーは、カタログアイテムの次のタイプの質問はスキップできません。
      • 複数選択肢をルックアップ
      • 選択ボックス
      • 選択ボックスのルックアップ
      • はい/いいえ
      • 数値スケール ([第一選択肢を選択しない] 設定が選択されていない場合)
      • 複数選択肢 ( [第一選択肢を選択しない] 設定が選択されていないか、[「なし」を選択肢に含める] 設定が選択されている場合)
    • ユーザーが Microsoft Teams などのサポートされている別のコラボレーションツールで仮想エージェントを使用している場合：
      • フィールドの選択肢タイプでの検索アイコンを使用した値の検索はサポートされていません。
        図 : 1. Microsoft Teams の選択肢タイプフィールド
        Microsoft Teamsでの選択肢フィールドの検索
        図 : 2. 仮想エージェント の選択肢タイプフィールド
        仮想エージェントでの選択肢フィールドの検索
      • フィールドの参照タイプの値の検索は、質問の形式で実行されます。
        図 : 3. Microsoft Teams の参照タイプフィールド
        Microsoft Teamsでの参照フィールドの検索
        図 : 4. 仮想エージェントの参照タイプフィールド

        参照フィールドの検索 - 仮想エージェント
    カタログアイテムが非会話型の場合、要求フォームは次のいずれかの表示タイプとして表示されます。
    • インライン
    • ポップアップ
    • ウィンドウ
    条件に応じて、非会話型カタログアイテムのカタログアイテムフォームがインライン、ポップアップ、またはウィンドウのいずれで表示されるかが決まります。
    注:
    質問の数に基づいて、 glide.sc.va.inline_render.question.limit プロパティによってカタログアイテムフォームがインラインまたはポップアップのどちらで表示されるかが決まります。デフォルトでは、プロパティの値は 20 です。
    カタログアイテムフォームの表示タイプ 条件
    インライン
    • カタログアイテムに、カスタム変数または UI ページ変数が含まれていない。
    • カタログアイテムに含まれる質問数が 20 以下の場合、アイテムフォームはインラインとして表示される。glide.sc.va.inline_render.question.limit プロパティのデフォルト値は 20 です。
    • カタログアイテムに複数行の変数セット (MRVS) が含まれていない。
    ポップアップ
    • カタログアイテムに、カスタム変数または UI ページ変数が含まれていない。
    • カタログアイテムに含まれる質問数が 20 超の場合、アイテムフォームはポップアップとして表示される。glide.sc.va.inline_render.question.limit プロパティのデフォルト値は 20 です。
    ウィンドウ
    • カタログアイテムにカスタム変数または UI ページ変数が含まれている。
    • glide.sc.va.render_type.legacy プロパティが true に設定されている。

    インライン表示タイプを使用したカタログアイテム要求

    カタログアイテムの要求者は、NLU を活用した仮想エージェントでフォームにインライン入力してカタログアイテムを送信できます。要求者は、インライン表示タイプでマークされたカタログアイテムを要求しながら、仮想エージェントの会話内でそのアイテムとオプションを入力できます。

    たとえば、要求者は仮想エージェントの会話でインラインでフォームに入力し、アイテムを送信できます。
    図 : 5. カタログアイテムのインライン要求

    カタログアイテムのインライン要求

    カタログアイテムのインライン要求

    カタログアイテムのインライン要求

    ポップアップ表示タイプを使用したカタログアイテム要求

    ユーザーは、アイテムのポップアップとしてカタログアイテム要求を送信できますが、これは会話型ではありません。ポップアップでは、仮想エージェントは、ユーザーが新しいタブに移動せずにポップアップで要求を送信するためのリンクを提供します。非会話型カタログアイテムは、カスタム変数、ラベル付きカスタム変数、または UI ページ変数がない場合にのみ、ポップアップとして表示できます。
    注:
    仮想エージェントの会話をポップアップとして表示しない場合は、glide.sc.va.render_type.legacy プロパティを true に設定します。これにより、構成されたポータル内のすべての非会話型カタログアイテムが新しいタブで表示されます。
    ポップアップとして表示される仮想エージェント

    ウィンドウ表示タイプを使用したカタログアイテム要求

    ユーザーはウィンドウでカタログアイテム要求を送信できます。ウィンドウには、仮想エージェントにより、sn_itsm_va.com.snc.itsm.virtualagent.portal_url プロパティで定義された サービスポータルで要求を送信するためのリンクが提供されています。非会話型アイテムは、カスタム変数、カスタムラベル付き変数、または UI ページ変数がある場合には、ウィンドウとして表示されます。

    カタログアイテムは、次のタイプの場合にウィンドウとして表示されます。
    • コンテンツアイテム
    • 注文ガイド
    • ウィザードランチャ
    • 標準的な変更テンプレート
    ウィンドウとして表示された仮想エージェント