仮想エージェントの Service Catalog トピックブロック

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む7読むのに数分

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

    次のプラグインを有効にします。
    1. Glide 仮想エージェントプラグイン (com.glide.cs.chatbot) または Glide 仮想エージェント Lite プラグイン (com.glide.cs.chatbot.lite)
    2. Service Management 仮想エージェントトピックブロック
 プラグイン (com.glideapp.cs.sm_topic_blocks)


    カタログアイテムの検索

    このトピックブロックを使用して、検索条件に基づいてカタログアイテムを検索できます。検索結果が複数ある場合は、カルーセルビューから 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 レコードが生成されるテーブルの名前。
    変数 カタログアイテムに関連する質問。

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

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

    会話モードでのカタログアイテムの要求

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

    ユーザーが会話モードでカタログアイテムを要求する場合は、次の条件を満たす必要があります。

    • カタログアイテムには、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
      注:
      その他の変数属性はすべて では無視されます 仮想エージェント。
    • カタログアイテムには 1 行の変数セットを設定できますが、複数行の変数セットを設定することはできません。
    • カタログアイテムに質問のデフォルト値が設定されている場合は、デフォルト値は VA に表示されるため、ユーザーは手動で選択しなくてもデフォルト値を使用できます。ユーザーは、デフォルト値以外の値を選択することもできます。
    • カタログアイテムに質問のデータルックアップが設定されている場合は、セッター値は VA に表示されるため、ユーザーはセッター値を使用するか、別の値を選択できます。セッターの質問が照合の質問に先行する場合、データルックアップを含むカタログアイテムは会話アイテムとしてサポートされません。
    • ユーザーは、カタログアイテムの次のタイプの質問はスキップできません。
      • 複数選択肢をルックアップ
      • 選択ボックス
      • 選択ボックスをルックアップ
      • はい/いいえ
      • 数値スケール ([第一選択肢を選択しない] 設定が選択されていない場合)
      • 複数選択肢 ( [第一選択肢を選択しない] 設定が選択されていないか、[「なし」を選択肢に含める] 設定が選択されている場合)
    • ユーザーが MS Teams などのサポートされている別のコラボレーションツールで VA を使用している場合：
      • フィールドの選択肢タイプでの検索アイコンを使用した値の検索はサポートされていません。
        図 : 1. MS Teams の選択肢タイプフィールド
        MS Teams での選択肢フィールドの検索
        図 : 2. VA の選択肢タイプフィールド
        VA での選択肢フィールドの検索
      • フィールドの参照タイプの値の検索は、質問の形式で実行されます。
        図 : 3. MS Teams の参照タイプフィールド
        MS Teams での参照フィールドの検索
        図 : 4. VA の参照タイプフィールド

        VA での参照フィールドの検索

    ポップアップとしてのカタログアイテムの要求

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

    カタログアイテムをウィンドウとして要求する

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

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