---
sourceDocument: オーストラリアの対話型インターフェース
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/conversational-interfaces

 Release :

    - australia

ft:locale :

    - ja-JP

ft:publication_title :

    - オーストラリアの対話型インターフェース

ft:clusterId :

    - convint

bundleId :

    - convint

workflow :

    - Platform


---

# 仮想エージェント URL パラメーター

# 仮想エージェント URL パラメーター {#ariaid-title1}

* リリースバージョン: Australia
* 
* 更新日 2026年03月12日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：4分

仮想エージェント には、アドミニストレーターがインスタンス URL に追加してページコンテンツのレンダリング方法を制御できるさまざまなシステムパラメーターが用意されています。

## 仮想エージェント URL 構造 {#va-sysparm__section_lf4_vfn_yqb}

インスタンスに対してレンダリングされるページを制御するには、URL パラメーターをインスタンス URL ( `https://<instancename>.service-now.com`) に追加します。

## チャットウィジェット 仮想エージェント システムパラメーター {#va-sysparm__section_r3z_r3q_yqb}

仮想エージェントチャットウィジェットは、ポータルでの使用またはサードパーティのページへの埋め込みがサポートされています。次のシステムパラメーターは、 仮想エージェント チャットウィジェットに表示される会話コンテンツを制御します。{#va-sysparm__table_qf4_djq_yqb__entry__3}

| パラメーター | 説明 | 例 |
|-|-|-|
| sysparm_branding_key | チャットのブランディング構成を Web チャットクライアントに適用します。 値：構成の自社用カスタム設定キー | * ブランディング構成を宛先ページに適用します:`https://<instance_name>.service-now.com/$sn-va-web-client-app.do?sysparm_branding_key=<branding_key>` * 埋め込みチャットウィジェットにブランディング構成を適用します ( ` https://<instance_name>.service-now.com/$sn-va-web-client-app._embed.do?sysparm_branding_key=<branding_key>` {#va-sysparm__ul_g1h_bdk_wrb} |
| sysparm_default_topic | トピック `sys_ID` を使用して起動時にデフォルトのトピックを設定します。 | `https://<instance_name>.service-now.com/$sn-va-web-client-app.do?sysparm_default_topic=<topic_sys_id>` |
| sysparm_domain_id | チャットをドメインの指定された Sys ID に制限します。 | `https://<instance_name>.service-now.com/$sn-va-web-client-app.do?sysparm_domain_id=<domain_sys_id>` |
| sysparm_live_agent_only | 可能であれば、ユーザーをライブエージェントに直接誘導します。 | `https://<instance_name>.service-now.com/$sn-va-web-client-app._embed.do?sysparm_live_agent_only=true` |
| sysparm_load_active_only | 現在のアクティブな会話をロードします。 値： * true:アクティブな会話のみをロードします * false:アクティブな会話をロードしません {#va-sysparm__ul_dfl_434_hrb} 注: sysparm_skip_load_history および sysparm_load_active_only パラメーターが両方とも true に設定されている場合、既存の sysparm_skip_load_history パラメーターが優先されます。 | `https://<instance_name>.service-now.com/$sn-va-web-client-app.do?sysparm_load_active_only=true` |
| sysparm_search_text | 会話の検索テキストを設定します。 | `https://<instance_name>.service-now.com/$sn-va-web-client-app.do?sysparm_search_text=<search_text>` たとえば、\<search_text\>は request\&laptop です。 |
| sysparm_skip_load_history | 前のメッセージ履歴をスキップし、新しい会話を開始します。 値： * true:メッセージ履歴をロードしません * false:メッセージ履歴をロードします {#va-sysparm__ul_xxb_lh4_hrb} 注: sysparm_skip_load_history パラメーターが false に設定され、sysparm_load_active_only が true に設定されている場合、sysparm_load_active_only は現在のアクティブな会話をロードします。 | `https://<instance_name>.service-now.com/$sn-va-web-client-app.do?sysparm_skip_load_history=true` |
| sysparm_ preview_mode | 会話をテストモードで表示します。 | `https://<instance_name>.service-now.com/$sn-va-web-client-app.do?sysparm_preview_mode=true` |
| sysparm_requester_session_language | 仮想エージェントの動的翻訳がインストールおよび構成されている場合の会話セッションの要求者の言語を指定します。 | `https://<instance_name>.service-now.com/$sn-va-web-client-app.do?sysparm_requester_session_language=<2 文字の言語コード>` |
[ ]

{#va-sysparm__table_qf4_djq_yqb}
**関連概念**   

* [ドメインセパレーションと 仮想エージェント](https://servicenow-prod.fluidtopics.net/vcAFrFoucQlM0LMV~Eb7hQ "ドメインセパレーションは、仮想エージェント アプリケーションでサポートされています。 ドメインセパレーションでは、データ、プロセス、および管理タスクをドメインと呼ばれる論理的なグループに分けることができます。どのユーザーがデータを表示できるか、データにアクセスできるかなど、このアプリケーションのいくつかの側面を制御できます。")
* [仮想エージェント インタラクションレコード](https://servicenow-prod.fluidtopics.net/W6DuGnH2rv2lbMx2uUhR_A "仮想エージェント会話が発生するたびに、インタラクションレコードはインタラクション [interaction] テーブル内の会話全体をキャプチャします。レコードには、会話で使用されるすべてのトピック要素と、ライブエージェントの転送が含まれます。")
* [仮想エージェント スクリプト](https://servicenow-prod.fluidtopics.net/k5GFUVGtBZUNvDXqtuDAtw "ServiceNow 仮想エージェントスクリプトメソッドと変数を使用して、応答、トリガー、フロースクリプトなどのチャットスクリプトを記述します。変数は、ライブサポートトピックと会話のコンテキストを提供することもできます。")  
**関連資料**   

* [仮想エージェントトピックの入力データタイプ](https://servicenow-prod.fluidtopics.net/wXn2eTBFio9S6RIfPkJHSg "一般的に使用される Glide 仮想エージェント (com.glide.cs.chatbot) データタイプの入力は、スクリプトを記述せずに アシスタントデザイナー で定義できます。カスタムコントロールまたはトピックブロックの開始ノードで入力データタイプを定義します。")
* [NLU システムエンティティ](https://servicenow-prod.fluidtopics.net/KFj6z~xdgF82mnIOAGxJJA "グローバルに定義された NLU エンティティを使用して、 仮想エージェント 会話から抽出できるシステム情報を識別します。エンティティは、トピックの「ノードレス」入力変数として定義できます。これらの変数は、 NLU サービスプロバイダーの予測からスロット入力するか、トピックのスコープ外で指定できます。")
* [仮想エージェントのレイテンシフィードバック](https://servicenow-prod.fluidtopics.net/QW2Ex~b01eGVc_XKn_GiGw "com.glide.cs.message.processing.enabledシステムプロパティは、生成 AI 大規模言語モデル (LLM) が 仮想エージェント チャットウィジェットとNow Assistパネルで要求を処理しているときは常に要求者に通知します。")