주제 디버그 가상 에이전트

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 읽기2분
  • 사용자 지정 가상 에이전트 주제, 주제 블록 및 통제에서 예기치 않은 동작을 조사하고 해결합니다.

    주제 검색 문제에 대한 자세한 내용은 다음 문서를 참조하십시오 (NLU) 주제 검색 문제 해결 자연어 이해.

    디버깅 및 변경 전에 라이브 주제 복제

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

    대화를 테스트하는 동안 주제 디버깅

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

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

    주제 미리 보기 창에 표시되는 대화 미리 보기 로그입니다.

    주제 내의 컨트롤에 대한 경고 감시

    그림 1. 플로우 탭의 주제 노드에 대한 경고
    캔버스와 개별 컨트롤에 빨간색으로 표시된 경고 수입니다. 텍스트 사용자 입력 컨트롤의 경우 노드 이름과 프롬프트가 필수입니다.

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

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

    주제 미리 보기가 실행되지 않을 때 오류 확인

    그림 2. 캔버스의 주제 미리 보기 오류
    캔버스에서 오류의 미리 보기를 제공하는 주제 유효성 검사기 창입니다.

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

    일반적인 가상 에이전트 문제

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

    대화 플로우에서 실행되는 주제 검토

    인스턴스의 각 가상 에이전트 (VA) 대화는 요청자와 가상 및 라이브 에이전트 간의 대화를 기록하는 상호작용 [interactions] 테이블에 상호작용 기록을 자동으로 생성합니다. 라이브 에이전트 전송(에이전트 채팅을 사용하는 경우)을 포함하여 요청자와 가상 에이전트 간의 대화 기록을 검토할 수 있습니다. 자세한 내용은 가상 에이전트 상호작용 기록을 참조하십시오.