--- 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 앱을 사용하여 채팅 인터페이스 또는 봇 ServiceNow® 가상 에이전트 을 ServiceNow® 가상 에이전트 또는 에이전트 채팅와 통합합니다. 앱은 에서 사용할 수 있습니다 ServiceNow® Store. ## 개요 {#virtual-agent-api__section_cxx_ldc_qmb} API는 가상 에이전트 REST API입니다. 이 API는 릴리스부터 제공되는 가상 에이전트 대화형 사용자 지정 채팅 통합 프레임워크를 Paris 기반으로 합니다. API를 사용하면 ServiceNow 개발자, 고급 사용자 및 관리자가 다음 방법 중 하나를 사용할 가상 에이전트 수 있습니다. 독립 실행형 봇 : 엔터프라이즈 또는 대화형 인터페이스를 지원하는 다른 외부 공급업체 채팅 인터페이스와 통합하는 독립 실행형 봇으로 사용합니다 가상 에이전트 . 최종 사용자는 이 통합을 사용하여 여러 채널과 가상 에이전트 상호 에이전트 채팅 작용할 수 있습니다. 보조 봇 : 기본 봇에서 관리하는 여러 특수 봇이 있는 환경에서 보조 봇으로 사용합니다 가상 에이전트 . 이 시나리오에서 기본 봇은 최종 사용자를 대신하여 보조 봇과의 통신을 관리합니다. 기본 봇은 , Microsoft LUIS또는 자체 개발한 기본 봇일 IBM Watson Assistant수 있습니다. 봇과 같은 ServiceNow 보조 봇은 서비스 티켓 또는 예약과 같은 특정 유형의 최종 사용자 요청을 처리할 수 있습니다. Bot Interconnect : 다양한 채팅 환경에서 기본 봇으로 사용합니다 가상 에이전트 Bot Interconnect . Bot Interconnect 는 통합 채팅 환경을 만들고 최종 사용자가 에서 사용할 수 있는 여러 채널과 다양한 엔터프라이즈 작업에 액세스할 수 ServiceNow있도록 합니다. API는 가상 에이전트 서버 간 통합을 만드는 데 유용합니다. 그러나 기존 채팅 인터페이스에서 렌더링해야 하는 지원되지 않는 컨트롤을 변환해야 하는 통합의 경우 [사용자 지정 채팅 통합 프레임워크](https://servicenow-prod.fluidtopics.net/QNzJ60HVKSy2xgL5j8oJEw "대화형 사용자 지정 채팅 통합 프레임워크는 모든 대화형 인터페이스를 구현 ServiceNow 가상 에이전트 하기 위한 스크립팅 가능한 API와 구성으로 구성된 강력한 프레임워크입니다.")를 사용하는 것이 좋습니다. URL과 같은 기능과 API에서 가상 에이전트 지원되는 요청 및 응답 매개변수에 대한 자세한 내용은 [가상 에이전트 봇 통합 API](https://www.servicenow.com/docs/access?context=bot-api&version=xanadu&pubname=xanadu-api-reference&ft:locale=en-US)를 참조하십시오. ![가상 에이전트 아카데미 비디오 링크입니다.]() [가상 에이전트 API로 경험 보강](https://www.youtube.com/watch?v=cyhmMyG4jKk) (가상 에이전트 아카데미 비디오) ## 가상 에이전트 API 작동 방식 {#virtual-agent-api__section_ivs_d2r_fnb} 다음 다이어그램은 REST API가 타사 채팅 인터페이스 또는 기본 봇에서 사용자 입력을 처리한 다음, 봇 응답을 생성하는 방법을 보여줍니다. 1. 사용자가 기본 봇 또는 외부 공급업체 채팅 인터페이스에 입력을 제공합니다. 2. 봇은 POST 요청 JSON을 인바운드 REST 엔드포인트로 보냅니다(스크립팅된 REST API를 통해). 3. Now Platform 또는 라이브 에이전트로 전송 가상 에이전트 되는 요청을 인증하고 처리합니다. 4. Now Platform 아웃바운드 REST 엔드포인트(REST API를 통해)에서 봇으로 POST 응답 JSON을 다시 보냅니다. 5. 기본 봇 또는 외부 공급업체 채팅 인터페이스가 사용자에 대한 응답을 표시합니다. {#virtual-agent-api__ol_pwf_jqc_kyb} 그림 1. API의 가상 에이전트 인바운드 및 아웃바운드 REST 엔드포인트 API 데모 가상 에이전트 및 FAQ를 보려면 커뮤니티 사이트에서 [가상 에이전트 API 시작하기를](https://community.servicenow.com/community?id=community_article&sys_id=080e3903dbc4e4107d3e02d5ca96198c) 참조하십시오. ## 제한 {#virtual-agent-api__section_xqy_r1l_2qb} API는 가상 에이전트 다음 기능을 지원하지 않습니다. * 이 가상 에이전트 API 통합을 통한 채팅 브랜딩 {#virtual-agent-api__ul_yqy_r1l_2qb} ## 버전 및 릴리스 호환성 {#virtual-agent-api__section_t11_5zb_dqb} {#virtual-agent-api__table_syv_gzb_dqb__entry__2} | 버전 | 호환 가능한 릴리스 | |-|-| | 3.10.0 | Washington DC | | 3.9.x | Vancouver | | 3.8.x | Vancouver | | 3.7.x | Utah | | 3.5.x | Tokyo | | 3.0.x | San Diego | | 2.0.x | Rome 기능의 하위 집합은 과 호환됩니다 Quebec. | | 1.3.0 | Quebec | | 1.0.12 | Quebec | | 1.0.9 | Paris | [표 1. 가상 에이전트 API 버전 및 릴리스 호환성] {#virtual-agent-api__table_syv_gzb_dqb} 주: API에는 가상 에이전트 와 유사한 Pro 라이선스가 가상 에이전트필요합니다. * **[가상 에이전트 API 기능](https://servicenow-prod.fluidtopics.net/etnMZm2by8mVJMrmoiaD~A)** API를 가상 에이전트 사용하여 채팅 환경에서 사용할 수 가상 에이전트에이전트 채팅 있는 많은 동일한 기능을 통합할 수 있습니다. 기능 지원은 릴리스 및 API의 스토어 앱 버전 번호에 따라 ServiceNow 다릅니다. * **[가상 에이전트 스토어 릴리스 2.0.x에서 사용할 수 있는 API 기능](https://servicenow-prod.fluidtopics.net/7Q2ldKAtf~3~3Ec20REhnA#va-api-features-v2)** 가상 에이전트 API 버전 2.0.x는 리치 컨트롤 지원 및 알림을 포함하여 에서 사용할 수 가상 에이전트에이전트 채팅있는 더 많은 동일한 기능에 대한 액세스를 제공합니다. * **[가상 에이전트 API 스토어 릴리스 3.0.x에서 제공되는 기능](https://servicenow-prod.fluidtopics.net/D5XSPh5uQop1x0PON7ZhRQ#va-api-features-v3)** 가상 에이전트 API버전 3.0.x는 개인 URL에서 파일을 업로드하는 기능 및 동기 핸드셰이크 개선 사항을 포함하여 및 에이전트 채팅에서 사용할 수 가상 에이전트 있는 더 많은 동일한 기능에 대한 액세스를 제공합니다. * **[가상 에이전트 API 설치](https://servicenow-prod.fluidtopics.net/WP4MJDoSv5lKyVMFHzSyag)** API 앱을 설치하여 채팅 인터페이스 또는 봇 ServiceNow® 가상 에이전트 을 가상 에이전트 또는 에이전트 채팅와 통합합니다. * **[인바운드 REST 엔드포인트 검토 및 인바운드 인증 구성](https://servicenow-prod.fluidtopics.net/FgD_JxMAsuXMRYT3Mf0~DQ)** API를 가상 에이전트 설치한 후 스크립팅된 REST API 자원으로 이동하여 엔드포인트를 검토하고 인증을 설정합니다. * **[인바운드 통신을 위한 메시지 인증 구성](https://servicenow-prod.fluidtopics.net/~o5cQNWIHjnkHeQL~N9Iwg)** 기본 또는 OAuth 대신 API에 가상 에이전트 대한 메시지 인증을 구성할 수 있습니다. 메시지 인증에는 정적 또는 해시 토큰 구성, 제공자 인증 설정 및 채널 ID 설정이 포함됩니다. * **[API에 대한 가상 에이전트 출력 응답 REST 엔드포인트 및 아웃바운드 인증 구성](https://servicenow-prod.fluidtopics.net/szs2Ht3mFFUmNmc8ORdAQg)** 응답이 게시될 가상 에이전트 아웃바운드 엔드포인트 URL을 지정합니다. 아웃바운드 인증을 구성합니다. * **[가상 에이전트 봇 대 봇 통합](https://servicenow-prod.fluidtopics.net/0Fy9TbSqX4NrHGQodPVXTw)** API는 가상 에이전트 여러 봇을 사용하는 환경을 지원합니다. 이 경우 기본 봇은 봇과 같은 타사 보조 봇과 통신합니다 ServiceNow . * **[유휴 봇 간 대화 닫기](https://servicenow-prod.fluidtopics.net/ec3p3nXOIZ9JJoZt_t5k9Q)** 봇 대 봇 통합(가상 에이전트 API)에서 한 시간 이상 "유휴" 상태인 중단된 대화는 예약된 작업 에 Time Out Abandoned B2B Conversations의해 자동으로 닫힙니다. 이 작업은 매일 매시간 실행됩니다. * **[여러 제공자 애플리케이션 구성](https://servicenow-prod.fluidtopics.net/sUtewQFivDr7q7pFQGyPeQ)** 여러 제공자 애플리케이션을 구성하여 사용하는 가상 에이전트 API 기본 봇이 여러 개 있고 이를 구분해야 하는 사용 사례를 지원할 수 있습니다. * **[가상 에이전트 API 요청 및 응답 변환](https://servicenow-prod.fluidtopics.net/3Hx8f_WGnBxnZyxeITmtsQ)** 가상 에이전트 API에 제공된 스크립팅된 확장점을 통해 가상 에이전트 API 요청 및 응답을 지원되는 형식으로 변환할 수 있습니다. * **[에서 환경 사용 Now Assist가상 에이전트 API](https://servicenow-prod.fluidtopics.net/ApIpb51LvOyWv0dgEre7LQ)** 여러 제공자 채널에서 가상 에이전트 API 생성 AI 기술을 지원할 수 있는 경험을 활성화 Now Assist 합니다.