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


---

# 주제 디버그 가상 에이전트

# 주제 디버그 가상 에이전트 {#ariaid-title1}

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

사용자 지정 가상 에이전트 주제, 주제 블록 및 통제에서 예기치 않은 동작을 조사하고 해결합니다.
주제 검색 문제에 대한 자세한 내용은 다음 문서를 참조하십시오 [(NLU) 주제 검색 문제 해결 자연어 이해](https://servicenow-prod.fluidtopics.net/V7RFYQZ3K2h5OGyYnYy4TQ "의도가 예상한 시간에 선택되지 않는 경우 NLU 예측 오류를 해결할 수 있습니다.").

## 디버깅 및 변경 전에 라이브 주제 복제 {#virtual-agent-troubleshooting-guide__section_bbn_d12_d2b}

라이브 주제를 업데이트하는 대신 주제를 복제합니다. 수정하지 않은 원본 주제는 참조 및 백업 역할을 할 수 있으며 원본을 유지하면 주제를 빠르게 복원할 수 있습니다. 복제본을 게시하기 전에 원래 주제를 비활성화해야 합니다.

## 대화를 테스트하는 동안 주제 디버깅 {#virtual-agent-troubleshooting-guide__section_ehd_j5d_12b}

에서 주제를 가상 에이전트 디자이너만들거나 업데이트할 때 주제 헤더 막대의 테스트 버튼을 사용하여 대화를 미리 볼 수 있습니다. 채팅 테스트 창에는 대화가 에 서비스 포털표시되는 대로 표시됩니다. 대화의 요소가 타사 메시징 애플리케이션에서 다르게 나타날 수 있습니다. 배포 가상 에이전트하려는 외부 공급업체 애플리케이션에서 대화를 테스트합니다.

테스트 채팅 창에는 항목을 디버깅하고 구체화하기 위한 자세한 정보를 제공하는 네 개의 탭(테스트 구 분석, 변수, 컨텍스트 및 로그)이 표시됩니다. 이러한 탭에 대한 자세한 내용은 을 참조하십시오 [테스트 NLU/키워드 주제](https://servicenow-prod.fluidtopics.net/7yM3d~E8jMPe3wukm5RnXQ "채팅 테스트 창을 사용하여 자연어 이해(NLU)/키워드 주제를 미리 보고, 테스트하고, 디버그합니다."). 다음 예제에서는 테스트 중에 기록된 처리 메시지 및 오류를 보여 줍니다.

## 주제 내의 컨트롤에 대한 경고 감시 {#virtual-agent-troubleshooting-guide__section_plt_gbx_c2b}

그림 1. 플로우 탭의 주제 노드에 대한 경고

필요한 정보가 누락된 컨트롤은 컨트롤의 왼쪽 위 모퉁이에 빨간색 불완전 배지를 표시합니다. 배지에는 해당 컨트롤의 문제 수를 나타내는 숫자가 표시됩니다. 컨트롤의 문제 목록을 보려면 이 배지를 선택합니다.

또 다른 경고 배지는 디자이너의 왼쪽 위 모서리에 나타나 전체 주제 내의 문제 수를 나타냅니다.

## 주제 미리 보기가 실행되지 않을 때 오류 확인 {#virtual-agent-troubleshooting-guide__section_pzf_vkd_12b}

그림 2. 캔버스의 주제 미리 보기 오류

오류로 가상 에이전트 디자이너 인해 주제를 실행할 수 없는 경우 캔버스 아래에 추가 정보가 나타납니다. 총 문제 수가 각 문제에 대한 상세 정보 및 하이퍼링크와 함께 나열됩니다. 하이퍼링크를 선택하여 노드로 이동하고 제공된 정보를 사용하여 대화의 오류를 수정합니다.

## 일반적인 가상 에이전트 문제 {#virtual-agent-troubleshooting-guide__section_trx_w3z_12b}

{#virtual-agent-troubleshooting-guide__table_j3r_2jz_12b__entry__2}

| 문제 | 가능한 해결 방법 |
|-|-|
| 대화형 인터페이스에서 모듈 디자이너를 볼 수 없습니다. | * 사용자에게 virtual_agent_admin 역할이 없을 수 있습니다. * 가상 에이전트 플러그인이 활성화되지 않았을 수 있습니다. {#virtual-agent-troubleshooting-guide__ul_tfv_mwf_d2b} |
| 주제를 편집할 수 없음 | 로그인한 사용자는 주제와 동일한 애플리케이션 범위에 있어야 합니다. |
| 주제를 미리 볼 수 없음 | * 모든 필수 필드가 노드 속성에 채워져 있는지 확인합니다. * 인스턴스에서 팝업을 허용하도록 브라우저가 구성되어 있는지 확인합니다. {#virtual-agent-troubleshooting-guide__ul_d1l_wvf_d2b} |
| 웹 클라이언트가 연결 중 멈춤... | 하나 이상의 주제가 누락되었을 수 있습니다. 주제 페이지를 확인하여 주제가 인스턴스에 있고 활성 상태인지 확인합니다. |
[ ]

{#virtual-agent-troubleshooting-guide__table_j3r_2jz_12b}

## 대화 플로우에서 실행되는 주제 검토 {#virtual-agent-troubleshooting-guide__section_dc2_vgl_xhb}

인스턴스의 각 가상 에이전트 (VA) 대화는 요청자와 가상 및 라이브 에이전트 간의 대화를 기록하는 상호작용 \[interactions\] 테이블에 상호작용 기록을 자동으로 생성합니다. 라이브 에이전트 전송(에이전트 채팅을 사용하는 경우)을 포함하여 요청자와 가상 에이전트 간의 대화 기록을 검토할 수 있습니다. 자세한 내용은 [가상 에이전트 상호작용 기록을](https://servicenow-prod.fluidtopics.net/14GC0hGxS3vuVi5no2lnbw "대화가 가상 에이전트 발생할 때마다 상호작용 기록은 상호작용 [interaction] 테이블에서 전체 대화를 캡처합니다. 이 기록에는 대화에 사용된 모든 주제 요소뿐만 아니라 라이브 에이전트 전송도 포함됩니다.") 참조하십시오.
* **[(NLU) 주제 검색 문제 해결 자연어 이해](https://servicenow-prod.fluidtopics.net/V7RFYQZ3K2h5OGyYnYy4TQ)**   
  의도가 예상한 시간에 선택되지 않는 경우 NLU 예측 오류를 해결할 수 있습니다.
* **[자연어 이해 의 주제 검색 논리 가상 에이전트](https://servicenow-prod.fluidtopics.net/Jtfac78QPSp4FmtDbV6lpg)**   
  의도를 반환하는 방법과 가상 에이전트 사용자에게 표시할 의도를 선택하는 방법을 이해합니다.