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

 Release :

    - xanadu

ft:locale :

    - ja-JP

ft:publication_title :

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

ft:clusterId :

    - convint

bundleId :

    - convint

workflow :

    - Platform


---

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

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

* リリースバージョン: Xanadu
* 
* 更新日 2024年08月01日
* 
* ![](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`) に追加します。

## 仮想エージェント Web クライアントのシステムパラメーター {#va-sysparm__section_r3z_r3q_yqb}

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

| パラメーター | 説明 | 例 |
|-|-|-|
| sysparm_branding_key | チャットの自社用カスタム設定構成を Web チャットクライアントに適用します。 値：構成の自社用カスタム設定キー | * 宛先ページに自社用カスタム設定構成を適用します：`https://<instancename.service-now.com/$sn-va-web-client-app.do?sysparm_branding_key=acme` * 埋め込み Web クライアントに自社用カスタム設定構成を適用します：`https://<instancename.service-now.com/$sn-va-web-client-app._embed.do?sysparm_branding_key=acme` {#va-sysparm__ul_g1h_bdk_wrb} |
| sysparm_default_topic | トピック `sys_ID` を使用して起動時にデフォルトのトピックを設定します。 | `https://<instancename>.service-now.com/$sn-va-web-client-app.do?sysparm_default_topic=1f5ac6dfc34020105a61d7de76400001` |
| sysparm_domain_id | チャットをドメインの指定された Sys ID に制限します。 | `https://<instancename>.service-now.com/$sn-va-web-client-app.do?sysparm_domain_id=c90d4b084a362312013398f051272c0d` |
| sysparm_live_agent_only | 可能であれば、ユーザーをライブエージェントに直接誘導します。 | `https://<instancename.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://<instancename.service-now.com>$sn-va-web-client-app.do?sysparm_load_active_only=true` |
| sysparm_nowassist | 仮想エージェントクライアントに Now Assist をロードします。 | `https://<instancename>.service-now.com/$sn-va-web-client-app._embed.do?sysparm_nowassist=true` |
| sysparm_search_text | 会話の検索テキストを設定します。 | `https://<instancename>.service-now.com/$sn-va-web-client-app.do?sysparm_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://<instancename.service-now.com>$sn-va-web-client-app.do?sysparm_skip_load_history=true` |
| sysparm_ preview_mode | 会話をテストモードで表示します。 | `//https://<instancename.service-now.com>$sn-va-web-client-app.do?sysparm_preview_mode=true` |
| sysparm_requester_session_language | 会話セッションの要求者の言語を指定します。 | `https://<instancename.service-now.com>$sn-va-web-client-app.do?sysparm_requester_session_language=<two-letter language code>` |
[ ]

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

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

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