--- 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 --- # 가상 에이전트 스토어 릴리스 2.0.x에서 사용할 수 있는 API 기능 # 가상 에이전트 스토어 릴리스 2.0.x에서 사용할 수 있는 API 기능 {#ariaid-title1} * 릴리스 버전: Xanadu * * 업데이트 날짜 2024년 08월 01일 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 21분 가상 에이전트 API 버전 2.0.x는 리치 컨트롤 지원 및 알림을 포함하여 에서 사용할 수 가상 에이전트에이전트 채팅있는 더 많은 동일한 기능에 대한 액세스를 제공합니다. ## 추가 리치 컨트롤 지원 {#va-api-features-v2__section_bcd_4k1_kqb} 가상 에이전트 API는 이제 다음과 같은 다양한 컨트롤을 지원합니다. 부울 통제 : 부울 컨트롤은 더 쉬운 지역화를 위해 응답을 문자열( Yes 또는 No)로 반환합니다. 주제 현지화에 대한 자세한 내용은 을 참조하십시오 [대화 지역화 가상 에이전트](https://servicenow-prod.fluidtopics.net/vlz9LmB9eO1GmzR9KLX9~A "플랫폼은 ServiceNow 필요에 따라 대화를 현지화하는 가상 에이전트 여러 가지 방법을 제공합니다. 를 현지화 프레임워크 사용하여 기계 번역, 타사 제공자 또는 둘 다를 사용하는지 여부에 관계없이 번역 프로세스의 모든 측면을 관리합니다."). 가상 에이전트 API는 부울 컨트롤에 대해 다음 예제 JSON을 보냅니다. { "requestId": "asd2423-wrr434-weruyt-1234567", "clientSessionId": "", "nowSessionId": "", "message": { "text": "7a36412253a13010ff59ddeeff7b12fb", "typed": false, "clientMessageId": "ABC-123" }, "userId": "beth.anglin", "body": [ { "uiType": "Boolean", "group": "DefaultPicker", "required": true, "nluTextEnabled": false, "label": "Sample Response for boolean control", "options": [ { "label": "Yes" }, { "label": "No" } ] } ], "score": 1 } 사용자 지정 통제 : 이제 사용자 지정 컨트롤을 사용하는 주제가 지원됩니다. 사용자 지정 컨트롤에 대한 자세한 내용은 을 참조하십시오 [사용자 지정 컨트롤을 사용하여 사용자 지정 가상 에이전트](https://servicenow-prod.fluidtopics.net/fzAX2_Seib~4V0e~o6TohA "사용자 지정 컨트롤은 개발자가 주제 또는 주제 블록에서 가상 에이전트 사용하기 위해 만들 수 있는 ServiceNow 구성요소입니다. 이러한 컨트롤에는 슬라이더 또는 비디오 플레이어가 포함됩니다. 사용자 지정 컨트롤은 에서 제공하는 컨트롤을 보완합니다 가상 에이전트 디자이너."). 테이블 봇 응답 통제 : 이제 테이블 봇 응답 컨트롤을 사용하는 주제가 지원됩니다. 자세한 내용은 [테이블 봇 응답 통제](https://servicenow-prod.fluidtopics.net/I5iMhzpxQlWtuS554~d5~Q "주제에서 가상 에이전트 테이블 봇 응답 컨트롤을 사용하여 봇 응답을 테이블로 표시합니다.") 문서를 참조하십시오. 모든 기록은 API에서 가상 에이전트 한 번에 반환됩니다. 가상 에이전트 다음 컨트롤을 보내기 위해 API 클라이언트의 응답을 기다립니다. 이 paginationBreak 속성을 사용하여 기록을 청크로 사용자에게 표시합니다. 예를 들어 paginationBreak 10으로 설정하면 사용자에게 한 번에 10개의 기록이 표시됩니다. 클라이언트가 다음 컨트롤로 이동할 준비가 되면 를 보내 DONE야 합니다. 가상 에이전트 API는 테이블 봇 응답 컨트롤에 대해 다음 예제 JSON을 보냅니다. { "requestId": "asd2423-wrr434-weruyt-1234567", "clientSessionId": "", "nowSessionId": "", "message": { "text": "Yes", "typed": false, "clientMessageId": "ABC-123" }, "userId": "beth.anglin", "body": [ { "uiType": "OutputTable", "group": "DefaultOutputTable", "label": "Sample Table Rich control", "headers": [ "Number", "Short description" ], "data": [ [ "INC0000005", "CPU load high for over 10 minutes" ], [ "INC0000015", "I can't launch my VPN client since the last software update" ], [ "INC0000025", "Need to add more memory to laptop" ], [ "INC0000035", "Reset my password" ], [ "INC0000055", "SAP Sales app is not accessible" ], [ "INC0009005", "Email server is down." ] ], "paginationBreak": 10, "totalSearchResultsCount": 6, "navigationBtnLabel": "Click for more" } ], "score": 1 } HTML 봇 응답 통제 : 이제 HTML 봇 응답 컨트롤을 사용하는 주제가 지원됩니다. 자세한 내용은 [HTML 봇 응답 통제](https://servicenow-prod.fluidtopics.net/KCKQ4QDaPrSixjT04Dd33w "HTML 봇 응답 통제를 사용하여 봇 응답에 가상 에이전트 정적 HTML 텍스트를 표시합니다.") 문서를 참조하십시오. 가상 에이전트 API는 HTML 봇 응답 컨트롤에 대해 다음 예제 JSON을 보냅니다. { "requestId": "asd2423-wrr434-weruyt-1234567", "clientSessionId": "", "nowSessionId": "", "message": { "text": "Yes", "typed": false, "clientMessageId": "ABC-123" }, "userId": "beth.anglin", "body": [ { "uiType": "OutputHtml", "group": "DefaultOutputHtml", "style": "inline", "height": 100, "width": 100, "value": " Sample Response for Html control ", "imageUrl": null, "imageHeight": 0, "imageWidth": 0, "links": null }, { "uiType": "InputText", "group": "DefaultText", "required": true, "nluTextEnabled": false, "label": "some text", "maskType": "NONE" } ], "score": 1 } 다중 응답 봇 응답 통제 : 이제 다중 응답 봇 응답 컨트롤을 사용하는 주제가 지원됩니다. 자세한 내용은 [다중 응답 봇 응답 제어](https://servicenow-prod.fluidtopics.net/vBBxCVfGLRwcUJ~jtgl8fw "주제에서 가상 에이전트 다중 응답 봇 응답 컨트롤을 사용하여 두 개 이상의 출력을 순차적으로 표시합니다. 출력은 텍스트, 이미지, 링크 또는 HTML일 수 있습니다. 사용자는 제공된 탐색 버튼을 통해 한 출력에서 다음 출력으로 이동할 수 있습니다.") 문서를 참조하십시오. 가상 에이전트 API는 다중 응답 봇 응답 제어를 위해 다음 예제 JSON을 보냅니다. { "requestId": "asd2423-wrr434-weruyt-1234567", "clientSessionId": "", "nowSessionId": "", "message": { "text": "Done", "typed": false, "clientMessageId": "ABC-123" }, "userId": "beth.anglin", "body": [ { "uiType": "MultiPartOutput", "group": "DefaultMultiPartOutput", "navigationBtnLabel": "Click for more", "content": { "uiType": "OutputText", "value": "Text response from multiflow control example", "maskType": "NONE" } } ], "score": 1 } 서식 있는 텍스트 지원 : 이제 서식 있는 텍스트를 사용하는 주제가 지원됩니다. 서식 있는 텍스트에는 굵게 또는 기울임꼴로 표시된 텍스트, 하이퍼링크, 글머리 기호 목록 및 이모티콘이 포함됩니다. ## 에이전트 채팅 추가 기능 {#va-api-features-v2__section_tbg_mg1_kqb} API는 가상 에이전트 이제 로 전송할 에이전트 채팅때 다음 기능을 지원합니다. 에이전트 이름 및 아바타 전달 : 기본 봇이 라이브 에이전트 가상 에이전트 로 채팅을 전송할 때 에이전트 이름과 아바타를 기본 봇으로 보낼 수 있습니다. 이 기능을 사용하려면 에이전트 채팅 설정에서 에이전트 이름과 아바타를 활성화하십시오. 메시지 페이로드 예는 다음과 같을 수 있습니다. { "requestId":"f42f3550-5b44-4cde-aa52-9b6756b3131c", "clientSessionId":"U94CSJLEN", "message":{ "text":"Live Agent support.", "typed":true }, "userId":"U94CSJLEN", "body":[ { "uiType":"OutputText", "group":"DefaultText", "agentInfo":{ "sentFromAgent":true, "agentName":"Beth Anglin", "agentAvatar":"ee4eebf30a0004d963b5c5ac0d734dc4.iix?t=small" }, "value":"Thank you for contacting support. I am looking into your question now and will be with you shortly." } ], "agentChat":true, "score":1 } 자세한 내용은 [에이전트 채팅 구성](https://servicenow-prod.fluidtopics.net/kX~0NdJF0pfUnAi_qlFI_A "라이브 에이전트가 고객과 채팅하고 에이전트 및 최종 사용자를 위한 다양한 대화 기능을 관리할 수 있도록 구성합니다 에이전트 채팅 . 에이전트는 을 통해 에이전트 채팅최종 사용자와 상호 작용하거나, 인시던트 또는 케이스 기록을 만들거나, 다른 에이전트 또는 큐로 채팅을 이전합니다.")을 참조하십시오. 라이브 에이전트 대기 시간 : 라이브 에이전트로 전송할 때 기본 봇은 대기 시간을 수신하고 이를 사용자에게 표시할 수 있습니다. 이 기능을 사용하려면 에이전트 채팅 설정의 라이브 채팅 대기 상태 필드에서 대기 시간을 선택합니다. 값은 spinnerType 로 설정됩니다 wait_time. 라이브 채팅 대기 상태가없음spinnerType으로 설정된 경우 값은 none입니다. 가상 에이전트 API는 페이로드의 매개변수에 body 다음 예제 JSON을 보냅니다. { "uiType":"ActionMsg", "actionType":"StartSpinner", "spinnerType":"wait_time", "message":"Routing you to a live agent...", "waitTime":"8 Seconds" } 자세한 내용은 [에이전트 채팅 구성](https://servicenow-prod.fluidtopics.net/kX~0NdJF0pfUnAi_qlFI_A "라이브 에이전트가 고객과 채팅하고 에이전트 및 최종 사용자를 위한 다양한 대화 기능을 관리할 수 있도록 구성합니다 에이전트 채팅 . 에이전트는 을 통해 에이전트 채팅최종 사용자와 상호 작용하거나, 인시던트 또는 케이스 기록을 만들거나, 다른 에이전트 또는 큐로 채팅을 이전합니다.")을 참조하십시오. 기본 봇에서 다음으로 채팅 이력 보내기 가상 에이전트 : 기본 봇은 에이전트가 대화의 컨텍스트를 볼 수 있도록 채팅 기록을 라이브 에이전트에 전달할 수 있습니다. 가상 에이전트 메시지 이력을 HTML로 변환한 다음 이미지로 변환합니다. * 변환된 이미지는 채팅의 첫 번째 메시지로 라이브 에이전트에 전송됩니다. * 기본 봇은 첫 번째 요청에서 메시지 기록을 보내야 합니다. 첫 번째 요청 이후의 다른 요청에서는 메시지 기록 페이로드가 무시됩니다. * 문자 메시지만 지원됩니다. * 기본 봇은 모든 URL을 텍스트 메시지의 값으로 전달할 수 있지만 라이브 에이전트는 이미지의 일부로만 볼 수 있습니다. 라이브 에이전트는 링크를 클릭할 수 없습니다. {#va-api-features-v2__ul_thk_p31_kqb} 메시지 페이로드 예: {​       "value": "Help me with password reset",​       "displayName": "able",​       "type": "text"​       "isBotMessage": false,​     } 주: 이전 예제 type 에서 는 대/소문자를 구분하며 값을 text가져야 합니다. ## 기본 봇의 보강된 요청 {#va-api-features-v2__section_xcn_f41_kqb} API는 가상 에이전트 이제 기본 봇의 다음 요청을 지원합니다. 시스템 매개변수 및 컨텍스트 변수 : 기본 봇은 시스템 매개변수와 컨텍스트 변수를 입력으로 전달할 수 있으며 가상 에이전트 이러한 매개변수를 적용합니다. , liveagent_requester_session_language, liveagent_topic, topic, live_agent_only및 liveagent_devicetimezone 와 같은 liveagent_devicetype시스템 매개변수가 지원됩니다. 사용자 지정 컨텍스트 변수와 에이전트 채팅 컨텍스트 변수도 지원됩니다. 메시지 페이로드 예: {​ "requestId": "f42f3550-5b44-4cde-aa52-xxxxxxxxxx",​ "clientSessionId": "xxxxxxxxxx",​ "token": "abcd",​ "message": {​     "text": "Test",​     "typed": true​ },​ "contextVariables": {​        "requester_session_language": "es"​ },​ "userId": ""abel.tuter",​ "emailId": "abel.tuter@example.com"​ }​ 자세한 내용은 [라이브 에이전트 채팅 컨텍스트 변수](https://servicenow-prod.fluidtopics.net/3diGoZdXgCZdgpn9OIklOQ "채팅 컨텍스트 변수를 사용하여 주제의 특정 정보를 전달하여 라이브 에이전트와 공유하거나 봇 대화가 라이브 에이전트로 라우팅되는 방식을 제어합니다. 가상 에이전트 에는 몇 가지 기본 변수가 포함되어 있으며 새 변수를 정의할 수 있습니다.") 및 [채팅 관련 정보를 저장하기 위한 컨텍스트 변수 구성](https://servicenow-prod.fluidtopics.net/KsaWBdyTrwy42CNZ_XP74w "채팅 전 설문 조사 응답과 같은 채팅 관련 정보를 저장하기 위해 채팅 변수라고도 하는 라이브 에이전트 채팅 컨텍스트 변수를 지정합니다. 이러한 변수에는 주제 의도를 결정하거나 채팅이 라이브 에이전트로 라우팅되는 방식을 제어하는 데 사용할 수 있는 상황별 정보가 포함됩니다. 주제 스크립트에 전달된 가상 에이전트 상황별 정보를 캡처하여 라이브 에이전트와 공유하는 변수를 정의할 수도 있습니다.") 문서를 참조하십시오. 사용자 시간대 : 요청 페이로드에 사용자의 시간대를 전달하여 설정합니다. 설정된 시간대 설정은 재설정될 때까지 유지됩니다. 메시지 페이로드 예: {​     "requestId": "xxxxxx-xxxxxx-xxxx-xxxx-xxxxxxxxxx",​     "clientSessionId": "xxxxxxxx-xxxx",​     "token": "xxxxx",​     "action" : "SET_USER_TIMEZONE",​     "userId": "able.tuter",​     "emailId": "abel.tuter@example.com",​      "timezone":"Asia/Kolkata"​ } 이 기능을 사용할 때는 다음 사항을 고려하십시오. * 날짜 및 시간을 사용자의 시간대로 변환하려면 대화가 열려 있어야 합니다(현재). * 기본 봇은 다음 형식 중 하나로 날짜와 시간을 보내야 합니다. * 시간대 이름입니다. 예를 들면 Asia/Kolkata 또는 America/New_York입니다. * 날짜 시간 24시간 형식입니다. 예: YYYY-MM-DD HH:MM:SS {#va-api-features-v2__ul_wjl_qjb_kqb} * API는 가상 에이전트 설정한 시간대가 \[sys_user\] 테이블에 저장된 값과 다르더라도 기본 봇이 지정한 시간대를 사용합니다. * 사용자 시간대를 설정하려면 작업을 보냅니다 SET_TIMEZONE . 시간대 이름이 유효하지 않은 경우 시간대 값은 기본적으로 UTC 시간으로 설정됩니다. 예를 들어, 2021-02-16 20:13:13을(를) 선택합니다. {#va-api-features-v2__ul_vjl_qjb_kqb} ## 노드 건너뛰기 지원 {#va-api-features-v2__section_b13_zry_3qb} 가상 에이전트 API는 주제에서 노드 건너뛰기를 수행하도록 설계된 경우 노드 건너뛰기를 지원합니다. 예를 들어, 에서 가상 에이전트 디자이너사용자 입력 컨트롤을 건너뛸 수 있도록 지정할 수 있습니다. 고급이 노드 숨기기 또는 건너뛰기 속성 시트의 영역입니다. 그림 1. 사용자가 노드를 건너뛸 수 있도록 허용하는 조건 또는 스크립트 노드를 건너뛸 수 있도록 정의하는 방법에 대한 자세한 내용은 을 참조하십시오 [가상 에이전트 디자이너 사용자 입력 통제](https://servicenow-prod.fluidtopics.net/FUrLTamIvDEgq24Omm0hvA "에서 가상 에이전트 디자이너 제공하는 입력 컨트롤의 컬렉션을 사용하여 대화에서 사용자의 정보를 확인하고 캡처합니다."). 노드가 건너뛸 수 있는 것으로 표시된 경우 봇은 사용자에게 해당 옵션을 제공합니다. 사용자가 건너뛰는 경우 기본 봇은 다음 예제와 같이 skip 명령을 전달해야 합니다. { "requestId": "f42f3550-5b44-4cde-aa52-9b6756b3131c", "clientSessionId": "835607", "token": "snow", "message": { "text": "_skip_", "typed": false }, "emailId": "beth.anglin@example.com", "userId": "beth.anglin" } ## 동기식 핸드셰이크 지원 {#va-api-features-v2__synchronous_support} 주: 이러한 요구 사항은 API 버전 2.0.x에 가상 에이전트 적용됩니다. 동기식 핸드셰이크 기능을 강화하려면 라이브 에이전트 전송 및 기타 향상된 기능을 지원하는 버전 3.0.x로 업그레이드하십시오. 자세한 내용은 [동기 핸드셰이크 개선 사항](https://servicenow-prod.fluidtopics.net/D5XSPh5uQop1x0PON7ZhRQ#va-api-features-v3__synchronous_support_enhancements) 문서를 참조하십시오. 사용하도록 설정하면 가상 에이전트 기본 봇에 동기적으로 응답을 제공합니다. 동기 모드에서 통신 가상 에이전트 을 활성화하려면 핸드셰이크가 작동하려면 다음 기능을 수동으로 꺼야 합니다. * 에이전트 채팅 * 알림 * 입력 표시기 {#va-api-features-v2__ul_p3g_33j_gqb} 주: [파일 업로드](https://servicenow-prod.fluidtopics.net/FUrLTamIvDEgq24Omm0hvA "에서 가상 에이전트 디자이너 제공하는 입력 컨트롤의 컬렉션을 사용하여 대화에서 사용자의 정보를 확인하고 캡처합니다."), [작업 유틸리티](https://servicenow-prod.fluidtopics.net/po5WLDRrj39pXaGzPJNz~g "주제의 가상 에이전트 작업 유틸리티를 사용하여 노드가 생성해야 하는 플로우 작업 속성을 선택합니다. 작업 유틸리티는 제품과 통합 가상 에이전트 됩니다 ServiceNow 워크플로우 스튜디오 .")및 [일시 중지 주제 블록](https://servicenow-prod.fluidtopics.net/8zu6TAuz5Y9IZ8NMykSdzA "가상 에이전트 주제 작성자 또는 관리자가 봇 대화에서 특정 플랫폼 관련 기능이나 작업을 수행하는 데 사용할 수 있는 사전 구축된 주제 블록을 제공합니다. 예를 들어 특정 주제 블록을 사용하여 에이전트 가용성을 확인하거나 결과를 생성할 AI 검색 수 있습니다.")과 같은 기능을 사용하는 주제는 동기 모드에서 지원되지 않습니다. 이러한 기능을 사용하지 않도록 설정하고 동기 지원을 사용하도록 설정하려면 다음 단계를 수행합니다. 1. 에서 봇-봇 채널을 제외합니다 에이전트 채팅. 1. 모두로 이동한 다음 필터에 sys_properties.list를 입력합니다. 2. com.glide.cs.exclude.liveagent.support 시스템 속성을 선택하여 엽니다. 3. 값 필드에 추가합니다Bot To Bot. 그림 2. 에서 봇-봇 채널 제외 에이전트 채팅 4. 업데이트를 클릭합니다. {#va-api-features-v2__ol_fv2_jr4_kqb} 2. 모두로 이동한 다음 탐색 필터에 sys_cs_channel.list를 입력합니다. 3. 봇 대 봇 기록을 선택합니다. 4. Enable Notifications(알림 사용) 확인란의 선택을 취소하여 사용하지 않도록 설정합니다. 5. 입력 지원 표시기 확인란의 선택을 취소하여 비활성화합니다. 6. 동기 확인란을 선택합니다. 그림 3. 동기식 지원이 활성화된 봇 대 봇 채널 주: 동기 필드가 표시되지 않으면 이를 표시하도록 [양식 레이아웃을 구성할](https://www.servicenow.com/docs/access?context=configure-form-layout&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US) 수 있습니다. 7. 업데이트를 클릭합니다. {#va-api-features-v2__ol_icm_x3j_gqb} ## 알림 지원 {#va-api-features-v2__section_u3d_gcs_2qb} API를 사용하여 가상 에이전트 비동기 모드에서 활성화된 경우 봇에서 봇 채널로 다음 유형의 알림을 보냅니다. * 단순: 텍스트 전용 알림. 간단한 알림은 도착하는 즉시 전달됩니다. * 이미지 카드: 서버에 업로드되거나 URL로 지정된 이미지입니다. * 기록 카드: 테이블의 기록에서 지정된 열입니다. * 실행 가능: 사용자에게 특정 작업을 수행할 수 있는 기회를 제공합니다. 실행 가능한 알림이 큐에 대기합니다. 사용자는 명령을 전송 Show Notification 하여 요청 시 검색할 수 있습니다. {#va-api-features-v2__ul_rrg_2ks_2qb} 자세한 내용은 [알림 구성 가상 에이전트](https://servicenow-prod.fluidtopics.net/cQ~DQVrn8Rn2~4SSeh9Vww "지원되는 메시징 채널의 챗봇을 통해 가상 에이전트 사용자에게 바로 알림을 보냅니다ServiceNow. 알림은 검토를 위한 간단한 정보 메시지이거나, 사용자가 특정 작업을 수행하기 위해 선택할 수 있는 버튼이 있는 실행 가능한 메시지일 수 있습니다.") 문서를 참조하십시오. 가상 에이전트 API는 간단한 알림을 위해 다음 예제 JSON을 보냅니다. { "requestId": "asd2423-wrr434-weruyt-1234567", "clientSessionId": "", "nowSessionId": "", "message": { "text": "Done", "typed": false, "clientMessageId": "ABC-123" }, "userId": "beth.anglin", "body": [ { "uiType": "OutputCard", "group": "DefaultOutputCard", "templateName": "Notification", "data": "{\"sys_id\":null,\"recordDisplayValue\":null,\"messageHeading\":\"[Heading]A notification has arrived. You can continue the conversation after viewing the notification.\",\"imageUrl\":null,\"tableLabel\":null,\"enableLink\":false,\"message\":\"[message]A notification has arrived. You can continue the conversation after viewing the notification.\",\"fields\":[],\"table_name\":null,\"url\":\"http://192.168.1.9:8080/null.do?sys_id=null\"}" } ], "completed": true, "score": 1 } 가상 에이전트 API는 이미지 카드 알림에 대해 다음 예제 JSON을 보냅니다. { "requestId": "asd2423-wrr434-weruyt-1234567", "clientSessionId": "", "nowSessionId": "", "message": { "text": "Done", "typed": false, "clientMessageId": "ABC-123" }, "userId": "beth.anglin", "body": [ { "uiType": "OutputCard", "group": "DefaultOutputCard", "templateName": "Notification", "data": "{\"sys_id\":null,\"recordDisplayValue\":null,\"messageHeading\":\"[Heading]A notification has arrived. You can continue the conversation after viewing the notification.\",\"imageUrl\":\"http://xxxxxx.service-now.com/2b2d0d2653a13010ff59ddeeff7b120d.iix\",\"tableLabel\":null,\"enableLink\":false,\"message\":\"[message]A notification has arrived. You can continue the conversation after viewing the notification.\",\"fields\":[],\"table_name\":null,\"url\":\"http://192.168.1.9:8080/null.do?sys_id=null\"}" } ], "completed": true, "score": 1 } 가상 에이전트 API는 기록 카드 알림에 대해 다음 예제 JSON을 보냅니다. { "requestId": "asd2423-wrr434-weruyt-1234567", "clientSessionId": "", "nowSessionId": "", "message": { "text": "Done", "typed": false, "clientMessageId": "ABC-123" }, "userId": "beth.anglin", "body": [ { "uiType": "OutputCard", "group": "DefaultOutputCard", "templateName": "Notification", "data": "{\"sys_id\":\"552c48888c033300964f4932b03eb092\",\"recordDisplayValue\":\"INC0010112\",\"messageHeading\":\"[Heading]A notification has arrived. You can continue the conversation after viewing the notification.\",\"imageUrl\":null,\"tableLabel\":\"Incident\",\"enableLink\":true,\"message\":\"[message]A notification has arrived. You can continue the conversation after viewing the notification.\",\"fields\":[{\"fieldLabel\":\"Number\",\"fieldValue\":\"INC0010112\"},{\"fieldLabel\":\"Short description\",\"fieldValue\":\"Assessment : ATF Assessor\"}],\"table_name\":\"incident\",\"url\":\"http://192.168.1.9:8080/incident.do?sys_id=552c48888c033300964f4932b03eb092\"}" } ], "completed": true, "score": 1 } 봇 대 봇 채널에 대한 알림은 기본적으로 비활성화되어 있습니다. 활성화하려면 다음을 수행합니다. 1. 모두로 이동한 다음 탐색 필터에 sys_cs_channel.list를 입력합니다. 2. 봇에서 봇 기록을 엽니다.메시지가 표시되면 기록에서 편집을 활성화합니다. 3. Enable Notifications(알림 사용) 확인란을 선택합니다. 4. 업데이트를 클릭합니다. {#va-api-features-v2__ol_mx2_5ps_2qb} 관리자는 속성을 수정 com.glide.cs.per_notification_user_limit 하여 알림당 수신자 수를 제한할 수 있습니다. 기본값은 1000입니다. ## 주제 이름을 사용하여 주제 전환 {#va-api-features-v2__section_h3z_v2l_2qb} 주제 ID 또는 주제 의도 ID를 사용하여 주제를 전환하는 것 외에도 주제 또는 주제 의도 이름을 사용할 수 있습니다. 주제 ID 또는 주제 이름만 전송하는 것이 좋습니다. 현재 둘 중 하나가 잘못되었거나 봇이 이미 지정된 주제에 가상 에이전트 있는 경우 응답을 보내지 않습니다. 사용법은 다음과 같이 사용 중인 모드에 따라 다릅니다. * NLU 주제 검색: 주제 의도 이름 또는 ID를 사용합니다. * 키워드 주제 검색: 주제 이름 또는 ID를 사용합니다. {#va-api-features-v2__ul_j1k_pgl_2qb} 기본 봇은 SWITCH 주제 이름과 함께 작업을 전송하여 특정 주제로 직접 전환할 수 있습니다. 메시지 페이로드 예: {​   "requestId": "xxxx-xxxx-xxxx-xxxx",   "clientSessionId": "xxx-xxx-xxx-xxx",   "action":"SWITCH",   "topic":{ ​     "name": "Topic Name"​  },​   "userId": "beth"​ } ## 입력 표시기 지원 {#va-api-features-v2__section_mfv_mrd_gqb} 사용자 및 라이브 에이전트에 대해 입력 표시기를 활성화할 수 있습니다. 현재 입력 표시기는 다음과 같이 표시됩니다. * 사용자가 입력할 때 에이전트에 표시됩니다. * 봇이 응답을 준비할 때 사용자에게 표시됩니다. {#va-api-features-v2__ul_zld_llb_kqb} 입력 표시기를 사용하도록 설정하면 가상 에이전트 API는 응답 페이로드에 StartTypingIndicator 및 EndTypingIndicator 작업을 보냅니다. 예: {​         "uiType":"ActionMsg",​         "actionType":"StartTypingIndicator"​ } ​ 사용자 입력 표시기를 라이브 에이전트로 보내려면 클라이언트가 작업을 보내 TYPING 야 합니다. 사용자가 입력을 마치면 클라이언트가 작업을 보내 VIEWING 야 합니다. 예를 들어: {​     "requestId": "xxxxxx-xxxxxx-xxxx-xxxx-xxxxxxxxxx",​     "clientSessionId": "xxxxxxxx-xxxx",​     "action": "TYPING/VIEWING",​     "userId": "able.tuter",​     "emailId": "abel.tuter@example.com",​     "timezone":"Asia/Kolkata"​ }​ 입력 표시기를 사용하려면 다음과 같이 하십시오. 1. 모두로 이동한 다음 탐색 필터에 sys_cs_channel.list를 입력합니다. 2. 봇 대 봇 기록을 선택합니다. 3. 입력 지원 표시기 확인란을 선택합니다. 4. 업데이트를 클릭합니다. {#va-api-features-v2__ol_nrn_tsd_gqb}