주제 디 가상 에이전트 버그

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

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

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

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

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

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

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

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

    주제 내 통제에 대한 경고를 확인합니다.

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

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

    캔버스의 왼쪽 위 모서리에 전체 주제 내의 문제 수를 나타내는 또 다른 경고 배지가 나타납니다.

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

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

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

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

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

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

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