---
sourceDocument: Xanadu 대화형 인터페이스
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/xanadu/conversational-interfaces

 Release :

    - xanadu

ft:locale :

    - ko-KR

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( `https://<instancename>.service-now.com`)에 URL 매개변수를 추가하여 인스턴스에 대해 렌더링되는 페이지를 제어할 수 있습니다.

## 웹 클라이언트에 대한 가상 에이전트 시스템 매개변수 {#va-sysparm__section_r3z_r3q_yqb}

웹 클라이언트는 가상 에이전트 포털에서 사용하거나 타사 페이지에 포함할 수 있도록 지원됩니다. 다음 시스템 매개변수는 웹 클라이언트에서 렌더링되는 대화 콘텐츠를 제어합니다 가상 에이전트 .{#va-sysparm__table_qf4_djq_yqb__entry__3}

| 매개변수 | 설명 | 예제 |
|-|-|-|
| sysparm_branding_key | 웹 채팅 클라이언트에 채팅 브랜딩 구성을 적용합니다. 값: 구성에 대한 브랜딩 키 | * 대상 페이지에 브랜딩 구성 적용:` https://<instancename.service-now.com/$sn-va-web-client-app.do?sysparm_branding_key=acme` * 포함된 웹 클라이언트에 브랜딩 구성 적용: ` 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 | 채팅을 도메인의 지정된 시스템 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=예` |
| 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=예` |
| sysparm_ preview_mode | 대화를 테스트 모드로 표시합니다. | `https://<instancename.service-now.com>$sn-va-web-client-app.do?sysparm_preview_mode=예` |
| sysparm_requester_session_language | 대화 세션에 대한 요청자의 언어를 지정합니다. | `https://<instancename.service-now.com>$sn-va-web-client-app.do?sysparm_requester_session_language=<두 글자 언어 코드>` |
[ ]

{#va-sysparm__table_qf4_djq_yqb}
**관련 개념**   

* [도메인 분리 및 가상 에이전트](https://servicenow-prod.fluidtopics.net/qyNZ6Qcsflpq1_CiKOV7LA "도메인 분리는 가상 에이전트 애플리케이션에서 지원됩니다. 도메인 분리를 사용하여 데이터, 프로세스 및 관리 작업을 도메인이라는 논리적 그룹으로 분할할 수 있습니다. 어떤 사용자가 데이터를 보고 액세스할 수 있는지를 포함하여 이러한 분리의 여러 측면을 제어할 수 있습니다.")
* [가상 에이전트 상호작용 기록](https://servicenow-prod.fluidtopics.net/14GC0hGxS3vuVi5no2lnbw "대화가 가상 에이전트 발생할 때마다 상호작용 기록은 상호작용 [interaction] 테이블에서 전체 대화를 캡처합니다. 이 기록에는 대화에 사용된 모든 주제 요소뿐만 아니라 라이브 에이전트 전송도 포함됩니다.")
* [가상 에이전트 스크립트](https://servicenow-prod.fluidtopics.net/zSUuZffmmyls3weyHv~~4A "스크립트 메서드 및 변수를 사용하여 ServiceNow 가상 에이전트 응답, 트리거 및 플로우 스크립트와 같은 채팅 스크립트를 작성합니다. 변수는 실시간 지원 주제 및 대화에 대한 컨텍스트를 제공할 수도 있습니다.")  
**관련 참조**   

* [주제의 가상 에이전트 입력 데이터 유형](https://servicenow-prod.fluidtopics.net/FpTV91nNTN5uLmd5BZhmpQ "스크립트를 작성하지 않고 일반적으로 사용되는 Glide 가상 에이전트 (com.glide.cs.chatbot) 데이터 유형의 입력을 정의할 수 있습니다 가상 에이전트 디자이너 . 사용자 지정 컨트롤 또는 주제 블록의 시작 노드에서 입력 데이터 유형을 정의합니다.")
* [NLU 시스템 엔터티](https://servicenow-prod.fluidtopics.net/PNyqgYSxCfeyuEW7UwND2Q "전역적으로 정의된 NLU 엔터티를 사용하여 대화에서 추출할 수 있는 가상 에이전트 시스템 정보를 식별합니다. 엔터티를 주제에 대한 \"노드 없는\" 입력 변수로 정의할 수 있습니다. 이러한 변수는 서비스 제공자 예측에서 NLU 슬롯으로 채워지거나 주제 범위 밖에서 제공될 수 있습니다.")
* [의 대기 시간 피드백 가상 에이전트](https://servicenow-prod.fluidtopics.net/gZXQRNujmaSqegNXTBfiKg "com.glide.cs.message.processing.enabled 이 시스템 속성은 생성형 AI LLM(대규모 언어 모델)이 웹 클라이언트 및 Now Assist 패널에서 가상 에이전트 요청을 처리할 때마다 요청자에게 알립니다.")