---
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


---

# 가상 에이전트 API 기능

# 가상 에이전트 API 기능 {#ariaid-title1}

* 릴리스 버전: Xanadu
* 
* 업데이트 날짜 2024년 08월 01일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 2분

API를 가상 에이전트 사용하여 채팅 환경에서 사용할 수 가상 에이전트에이전트 채팅 있는 많은 동일한 기능을 통합할 수 있습니다. 기능 지원은 릴리스 및 API의 스토어 앱 버전 번호에 따라 ServiceNow 다릅니다.

API의 가상 에이전트 요청 및 응답 템플릿에 대한 자세한 내용과 일반적인 사용 사례의 예는 [가상 에이전트 봇 통합 API](https://www.servicenow.com/docs/access?context=bot-api&version=xanadu&pubname=xanadu-api-reference&ft:locale=en-US)를 참조하십시오.

## 주요 기능 {#va-api-features__section_yps_1fc_qmb}

버전 1.0.9부터 API의 가상 에이전트 주요 기능은 다음과 같습니다.

* 정적, 해시 및 토큰 기반 인증을 사용하는 제공자 인증
* 개인화된 경험을 위해 사용자 ID를 ServiceNow 계정에 자동 연결
* 가상 에이전트 에서 라이브 에이전트로 전송 에이전트 채팅
* 다음 전략을 통한 봇 대 봇 통합의 의도 분류:
  * 기본 봇은 사용자 의도를 결정하고 해당 주제가 사용자에게 표시되도록 사용자 요청을 가상 에이전트 보냅니다.
  * 기본 봇은 의도를 발견하고 예측 신뢰 점수를 반환할 수 있도록 사용자 발언을 전송합니다 가상 에이전트 . 신뢰 점수가 높을수록 예측된 토픽이 사용자 발언과 더 정확하게 일치한다는 것을 나타냅니다.
  {#va-api-features__ul_n2c_nfc_qmb}
{#va-api-features__ul_y2x_cfc_qmb}

## 버전 1.0.12 기능 {#va-api-features__section_fxf_22h_kqb}

[유휴 봇 대 봇 대화 자동 종결](https://servicenow-prod.fluidtopics.net/ec3p3nXOIZ9JJoZt_t5k9Q "봇 대 봇 통합(가상 에이전트 API)에서 한 시간 이상 \"유휴\" 상태인 중단된 대화는 예약된 작업 에 Time Out Abandoned B2B Conversations의해 자동으로 닫힙니다. 이 작업은 매일 매시간 실행됩니다.")
:   1시간 이상 유휴 상태였던 대화는 자동으로 닫을 수 있습니다. 이 Time Out Abandoned B2B Conversations 작업은 매일 매시간 실행되며 요청자가 중단한 유휴 대화를 자동으로 닫습니다.

[가상 에이전트 상호작용 기록의 대화 상태 및 이유 코드](https://servicenow-prod.fluidtopics.net/14GC0hGxS3vuVi5no2lnbw "대화가 가상 에이전트 발생할 때마다 상호작용 기록은 상호작용 [interaction] 테이블에서 전체 대화를 캡처합니다. 이 기록에는 대화에 사용된 모든 주제 요소뿐만 아니라 라이브 에이전트 전송도 포함됩니다.")
:   사용자 또는 기본 봇이 대화를 가상 에이전트 종료하면 상호작용 기록에 상태 및 이유 코드를 기록합니다. 예를 들어 최종 사용자는 End 를 입력하여 대화를 중지하거나 X 버튼을 클릭하여 채팅을 닫을 수 있습니다.

대화가 끝날 때 알리기
:   또는 대화가 종료될 때 가상 에이전트에이전트 채팅 기본 봇에 알림이 전송됩니다. 기본 봇은 대화를 제어해야 할 때도 알림을 받습니다. 가상 에이전트 는 다음 플래그를 사용합니다.

    * completed: 라이브 에이전트와의 가상 에이전트 대화가 종료될 때 전송됩니다.
    * takeControl: 기본 봇이 통제해야 할 때 전송됩니다. 이는 일반적으로 두 번 연속 시도 후 대화 의도를 확인할 수 없는 경우 가상 에이전트 (기본값)에 발생합니다. 시스템 속성을 추가하여 va.bot.to.bot.take.control_times 대화 의도를 확인하려는 기본 시도 횟수를 가상 에이전트 변경할 수 있습니다.

    {#va-api-features__ul_dqs_51h_kqb}

    자세한 내용은 [가상 에이전트 봇 통합 API](https://www.servicenow.com/docs/access?context=bot-api&version=xanadu&pubname=xanadu-api-reference&ft:locale=en-US)를 참조하십시오.

의도가 있는 변경
:
    * 에서 NLU가 활성화된 가상 에이전트경우 의도 일치에 대한 NLU 신뢰도 점수를 공유합니다.
    * 최종 사용자가 기본 봇의 의도 일치에 따라 주제로 직접 이동할 수 있도록 합니다.
    {#va-api-features__ul_gbx_mz3_kqb}

## 버전 1.3.0 기능 {#va-api-features__section_aj4_22h_kqb}

버전 1.3.0 가상 에이전트 부터 API는 시스템 속성()va.bot.to.bot.logging_enabled으로 로깅을 지원합니다.