会話エクスペリエンスを通じてカタログアイテムを要求するためのトピックブロック

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：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 に設定されています。このプロパティの詳細については、「サービスカタログ のプロパティ」を参照してください。
    • 選択ボックスをルックアップ変数に、JavaScript を含む参照修飾子などの詳細参照修飾子を含めることはできません。[ルックアップ] 選択ボックスを持つカタログアイテムにこのような詳細参照修飾子が含まれている場合、そのアイテムは非会話型になります。また、カタログアイテムに 20 を超える選択肢がある [選択ボックスをルックアップ] 変数が含まれている場合、アイテムは非会話型になります。この動作は、 sn_now_assist_cr.llm.lookup_select_choice_limit システムプロパティの値 (デフォルト値は 20) によって管理されます。
    • カタログアイテムはスクリプト化されたカタログ 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 ページ変数タイプは仮想エージェントで無視されます。詳細については、「サービスカタログ変数のタイプ」を参照してください。
    • カスタム変数をサポートするには、ユーザーはトピックブロックをカスタム変数に関連付けて、対話型インターフェースで表す必要があります。ユーザーがトピックブロックを関連付けない場合、カスタム変数を含むカタログアイテムは非対話型になります。
    • 変数によってカタログアイテムが非対話型になることがわかっている場合は、[対話型インターフェースから削除] オプションを選択することで、そのような変数を対話型インターフェースから削除できます。ServiceNow AI 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 を活用した仮想エージェントのカタログアイテムの会話モードに対応します。

    Now LLMの翻訳

    enable_alternative_translation プロパティを使用して、 Now LLMの翻訳を有効にすることができます。デフォルトでは、翻訳はオフになっています。
    注:

    ユーザープロファイル言語とセッション言語が異なる場合、 Now LLM translated_textコールは表示されません。ただし、システムプロパティが有効になっている場合は、 Now LLM コールが表示され、変換が行われます。

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

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