주제 디버그 가상 에이전트

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 2분
  • 사용자 지정 가상 에이전트 주제, 주제 블록 및 통제에서 예기치 않은 동작을 조사하고 해결합니다.

    주제 디스커버리 문제에 대한 자세한 내용은 해당 해결 자연어 이해 (NLU) 주제 디스커버리 문제문서를 참조하십시오에서 LLM 주제 디스커버리 가상 에이전트.

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

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

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

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

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

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

    주제 내 통제에 대한 경고를 확인하십시오.

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

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

    캔버스 왼쪽 상단에 다른 경고 배지가 나타나 전체 주제 내의 문제 수를 나타냅니다.

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

    그림 2. 캔버스의 주제 미리 보기 오류
    캔버스에서 오류를 미리 볼 수 있는 주제 확인 도구 창입니다.

    오류로 인해 주제가 실행되지 않는 경우 추가 정보가 캔버스 사이드바 가상 에이전트 디자이너 의 확인 문제 탭에 나타납니다. 각 노드에 대한 상세 정보 및 하이퍼링크와 함께 총 문제 수가 나열됩니다. 하이퍼링크를 선택하여 노드로 이동하고 제공된 정보를 사용하여 대화의 오류를 수정합니다. 문제를 해결하지 않고 탭을 닫을 수 있지만 문제가 해결될 때까지 게시를 선택하면 확인 문제 탭이 나타납니다. 모든 문제를 해결한 후 게시 를 선택하면 Validation Issues(확인 문제) 탭이 닫힙니다.

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

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

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

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