---
sourceDocument: Yokohama 対話型インターフェース
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/yokohama/conversational-interfaces

 Release :

    - yokohama

ft:locale :

    - ja-JP

ft:publication_title :

    - Yokohama 対話型インターフェース

ft:clusterId :

    - convint

bundleId :

    - convint

workflow :

    - Platform


---

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

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

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

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