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

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間:9分
  • 要求送信タスクを実行するための再利用可能なトピックブロックを含めることにより、Now LLM を活用した仮想エージェントでトピック会話を設計できます。

    カタログアイテムの要求 (Now LLM)

    このトピックブロックを使用して、生成 AI に基づく会話型の簡素化されたエクスペリエンスを通じてカタログアイテムを要求できます。会話型カタログ要求での Now Assist の構成については、「Configure Now Assist in Conversational Catalog Request」を参照してください。

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

    カタログアイテムが会話モードでサポートされていない、またはユーザーがアイテムへのアクセス権を持っていない場合は、-1 が返されます。

    record_table レコードが生成されるテーブルの名前。
    status 要求のステータス。オプションとなり得るのは [成功] または [エラー] です。
    variables カタログアイテムに関連する質問。
    message メッセージは、エラーが発生した場合に追加情報を提供します。
    used_LLM アイテムの要求中に Now LLM が使用されたかどうか、つまり、生成 AI を使用してカタログアイテムで定義された質問に対してスロット入力が行われたかどうかを示すオプション。

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

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

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

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

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

    • カタログアイテムには、sn_now_assist_cr.llm.conversational.request.question.limit プロパティで指定された数を超える質問を含めることはできません。デフォルトでは、この数は 500 に設定されています。このプロパティの詳細については、「サービスカタログ のプロパティ」を参照してください。
    • カタログアイテムはスクリプト化されたカタログ UI ポリシーを持つことができます。ただし、サポートされていないメソッドまたは関数を含むスクリプト化された UI ポリシーがカタログアイテムにある場合、カタログアイテムは非会話型になります。
    • 次のメソッドまたはクラスは、カタログアイテムを会話型にするためのカタログクライアントスクリプトまたはスクリプト化された UI ポリシーでサポートされています。
      • moment
      • window.location.href
      • top.location.href
      • top.window.open
      • window.open
      • open
      • Array
      • Boolean
      • Date
      • Error
      • GlideAjax
      • GlideRecord
      • JSON
      • Math
      • Number
      • Object
      • RegExp
      • String
      • alert
      • console.info
      • console.error
      • console.debug
      • console.warn
      • console.log
      • console.clear
      • console.count
      • console.countReset
      • console.dir
      • console.dirxml
      • console.table
      • decodeURI
      • decodeURIComponent
      • encodeURI
      • evalexec
      • g_form.addErrorMessage
      • g_form.addInfoMessage
      • g_form.addOption
      • g_form.clearMessage
      • g_form.clearOptions
      • g_form.clearValue
      • g_form.getActionName
      • g_form.getDisplayValue
      • g_form.getEditableFields
      • g_form.getIntValue
      • g_form.getReference
      • g_form.getSysId
      • g_form.getTableName
      • g_form.getUniqueValue
      • g_form.getValue
      • g_form.hasField
      • g_form.hideAllFieldMsgs
      • g_form.hideErrorBox
      • g_form.hideFieldMsg
      • g_form.isMandatory
      • g_form.isNewRecord
      • g_form.isReadOnly
      • g_form.isVisible
      • g_form.removeOption
      • g_form.save
      • g_form.setDisabled
      • g_form.setDisplay
      • g_form.setLabel
      • g_form.setLabelOf
      • g_form.setMandatory
      • g_form.setReadOnly
      • g_form.setReadonly
      • g_form.setValue
      • g_form.setVariablesReadOnly
      • g_form.setVisible
      • g_form.showErrorBox
      • g_form.showFieldMsg
      • g_form.submit
      • g_user
      • ga.addParam
      • ga.getXML
      • indexOf
      • isLoading
      • isNaN
      • newValue
      • oldValue
      • onChange
      • parseFloat
      • parseInt
      • this
      • toFixed
      • trim
      • undefined
      • escape
      • unescape
    • カタログアイテムはカタログクライアントスクリプトを持つことができます。ただし、サポートされていないメソッドまたは関数を含むカタログクライアントスクリプトがカタログアイテムにある場合、カタログアイテムは非会話型になります。
    • 想定される価格を含む変数はサポートされていません。
    • sn_now_assist_cr.llm.reference_question_choices.limitプロパティのテーブルに対応する参照型変数のレコード数の上限を指定できます。デフォルトでは、制限は 2000000 です。2000000 を超える値を指定すると、応答時間に影響する可能性があります。
    • UI ページがサービスポータルで無視されるのと同様に、UI ページ変数タイプは仮想エージェントで無視されます。詳細については、「サービスカタログ変数のタイプ」を参照してください。
    • カスタム変数をサポートするには、ユーザーがトピックブロックをカスタム変数に関連付けて、対話型インターフェースで表す必要があります。ユーザーがトピックブロックを関連付けない場合、カスタム変数を含むカタログアイテムは非会話型になります。
    • 変数によってカタログアイテムが非会話型になることがわかっている場合は、[ 対話型インターフェースから削除] オプションを選択して、対話型インターフェースからそのような変数を削除できます。このオプションは、 Now Platform の質問フォームの [可用性] タブにあります。
    • 次のシナリオでは、フィールドメッセージは要求者に表示されません。
      • 既に回答されている質問に対してフィールドメッセージが表示されている場合。
      • 質問が読み取り専用であるか、非表示であるか、既に自動入力されているために質問が要求者に表示されない場合。
    • 次の変数属性がサポートされています。
      • ref_ac_order_by
      • allowed_extensions
      • max_file_size
      注:
      その他のすべての変数属性は、仮想エージェントでは無視されます。
    • カタログアイテムには単一行変数セットを設定できますが、複数行の変数セットは設定できません。
    • カタログアイテムに質問のデフォルト値が設定されている場合は、デフォルト値は仮想エージェントに表示されるため、ユーザーは手動で選択しなくてもデフォルト値を使用できます。ユーザーは、デフォルト値以外の値を選択することもできます。
    • ユーザーは、カタログアイテムの次のタイプの質問はスキップできません。
      • 複数選択肢をルックアップ
      • 選択ボックス
      • 選択ボックスのルックアップ
      • はい/いいえ
      • 数値スケール ([第一選択肢を選択しない] 設定が選択されていない場合)
      • 複数選択肢 ( [第一選択肢を選択しない] 設定が選択されていないか、[「なし」を選択肢に含める] 設定が選択されている場合)
    • ユーザーが Microsoft Teams などのサポートされている別のコラボレーションツールで仮想エージェントを使用している場合:
      • フィールドの選択肢タイプでの検索アイコンを使用した値の検索はサポートされていません。
        図 : 1. Microsoft Teams の選択肢タイプフィールド
        での選択肢フィールドの検索 Microsoft Teams
        図 : 2. 仮想エージェント の選択肢タイプフィールド
        の選択肢フィールドの検索 仮想エージェント
      • フィールドの参照タイプの値の検索は、質問の形式で実行されます。
        図 : 3. Microsoft Teams の参照タイプフィールド
        での参照フィールドの検索 Microsoft Teams
        図 : 4. 仮想エージェントの参照タイプフィールド

        での参照フィールドの検索 仮想エージェント
    注:
    対話型カタログ要求アプリケーションに Now Assist をインストールしている場合、これらの条件は Now LLM を活用した仮想エージェントのカタログアイテムの会話モードに対応します。

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

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

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

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

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