해결 자연어 이해 (NLU) 주제 디스커버리 문제

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 11분
  • 의도가 예상대로 선택되지 않는 경우 NLU 예측 오류를 해결할 수 있습니다.

    빠른 문제 해결 팁

    a 가상 에이전트 가 검색되지 않으면 다음을 확인하십시오.
    세션 언어에 대해 NLU를 사용할 수 있습니까?
    에 대한 가상 에이전트(NLU) 설정에서 언어를 자연어 이해 활성화합니다. 자세한 내용은 설정에서 NLU 언어 가상 에이전트 사용 문서를 참조하십시오.
    NLU 모델이 세션 언어에 대해 교육되고 게시되었습니까?
    주제에서 모델의 최신 변경 내용을 사용하지 않을 수 있습니다. NLU의 경우 ServiceNow®NLU 모델 교육 및 시도가상 에이전트 주제 게시를 참조하십시오.
    주제가 가상 에이전트 게시 및 검색 가능하며 세션 언어에 대해 게시된 NLU 모델 및 의도에 바인딩되어 있습니까?
    주제는 지정된 언어의 단일 모델과 의도에 바인딩되어야 합니다. 다른 주제에 바인딩된 중복 의도가 없는지 확인합니다. 주제, 모델 및 의도가 동일한 도메인에 있는지 확인합니다. 자세한 내용은 가상 에이전트 주제 게시 문서를 참조하십시오.
    디자이너의 속성 탭에서 가상 에이전트 주제에 대해 가상 에이전트 지정된 역할이나 조건이 있습니까?
    주제가 특정 역할이나 특정 조건에 대해서만 표시되는 경우 주제 디스커버리가 방해가 될 수 있습니다. 자세한 내용은 항목 속성 탭 문서를 참조하십시오.
    내 주제를 스페인어로 발견했지만 프랑스어로는 발견하지 못한 가상 에이전트 이유는 무엇입니까?
    다음과 같은 몇 가지 가능성이 있습니다.
    • 모든 NLU 제공자가 모든 언어를 지원하는 것은 아닙니다. 자세한 내용은 서비스에 대한 NLU 언어 지원 문서를 참조하십시오.
    • 모든 주제가 언어별 NLU 모델 및 의도에 바인딩되는 것은 아닙니다.
      예를 들어 주제 A를 다음과 같이 매핑할 수 있습니다.
      • 영어의 경우 모델 A 및 의도 A에 바인딩됨
      • 스페인어의 경우 모델 A 및 의도 A에 바인딩됨
      • 프랑스어의 모델이나 의도에 얽매이지 않음
      이 시나리오에서는 주제에 대한 프랑스어 모델과 의도를 생성합니다. 자세한 내용은 다국어 모델 관리를 참조하세요.
    주제 변수가 슬롯이 채워지지 않은 이유는 무엇입니까?
    다음을 확인하십시오.
    • 토픽의 사용자 입력 노드가 연결된 엔터티로 구성되지 않았습니다. 의 가상 에이전트 디자이너노드에 대한 NLU 엔터티 속성을 사용합니다.

      NLU 엔터티 목록에 기존 엔터티를 지정합니다.

    • 예측 결과에는 신뢰 점수가 구성된 신뢰 임계치보다 낮은 NLU 엔터티가 포함되어 있습니다.
    • 노드에 대한 NLU 엔터티 값이 잘못되었습니다. 예를 들어 날짜/시간 엔터티 형식에는 "빨간색"이라는 단어를 적용할 수 없습니다.
    주제에서 디스커버리를 테스트합니다.
    다음 중 하나를 수행합니다.
    • 홈페이지에서 검색 유형 토글 스위치를 NLU/키워드로 밀고 NLU/키워드 주제 테스트를 선택합니다. 발화를 입력하고 테스트 구문 분석 탭을 시청합니다.
    • 에서 가상 에이전트 디자이너주제를 연 다음, 테스트를 선택합니다. 테스트 창에서 주제 검색 포함 확인란을 선택합니다. 발화를 입력하고 테스트 구문 분석 탭을 시청합니다.

    자세한 내용은 /키워드 주제 테스트 NLU 문서를 참조하십시오. 주제 디스커버리의 작동 방식에 대한 이해는 다음 문서를 참조하십시오 자연어 이해 의 주제 디스커버리 논리 가상 에이전트.

    "주제 설정"이 문제의 주제입니까?
    그렇다면 검색하려면 채팅 설정에서 구성해야 대화형 인터페이스 합니다. 자세한 내용은 가상 에이전트 채팅 경험 구성 문서를 참조하십시오.
    주제 중간 전환에 대한 질문이나 문제입니다.
    주제 B로 전환했다가 가상 에이전트 대화가 주제 A로 돌아온 이유는 무엇입니까?
    주제 전환 후 주제 플로우 재개 속성이 주제에서 활성화됩니다. 이 토글 스위치는 속성 탭의 고급 속성 > 추가.
    주제 B로 전환한 후 가상 에이전트 대화가 주제 A로 돌아오지 않은 이유는 무엇입니까?
    주제 전환 후 주제 플로우 재개 속성이 주제에서 비활성화되어 있습니다. 이 토글 스위치는 속성 탭의 고급 속성 > 추가.
    가상 에이전트 의도를 찾지 못하면 주제 중간에 키워드 검색을 사용합니까?
    번호
    전환 후 주제 B에서 주제 A의 변수를 사용할 수 있습니까?
    번호
    주제 A가 재개되면 주제 B의 변수를 주제 A에서 사용할 수 있습니까?
    번호

    추가 문제 해결을 위해 다음 테이블의 정보를 확인합니다.

    오픈 NLU 테이블에서 NLU 예측 정보 확인

    ()NLU를 사용하는 자연어 이해 항목을 검토하거나 디버깅할 때 다양한 NLU 테이블을 사용하여 항목에 대한 NLU 예측 결과를 볼 수 있습니다. 예를 들어, NLU 예측 의도 피드백 열기 및 NLU 예측 엔터티 피드백 열기 테이블은 주제 의도 및 엔터티(슬롯 채우기)를 결정하기 위해 애플리케이션에서 수행하는 NLU 가상 에이전트처리에 대한 자세한 정보를 제공합니다.

    NLU 의도 예측 피드백 테이블 열기

    NLU 의도 예측 피드백 열기[open_nlu_predict_intent_feedback] 테이블은 NLU 의도 예측 결과에 대한 응답으로 애플리케이션(이 경우 가상 에이전트)이 수행하는 의도 처리를 보여줍니다. 의 가상 에이전트 목표는 예측된 NLU 의도를 주제에 매핑하는 것입니다 가상 에이전트 . 에서 주제를 제안할 때마다 가상 에이전트 예측 결과의 기록이 이 테이블에 추가됩니다. 가상 에이전트 에서 주제를 찾지 못하면 예측이 발생하지 않으며 표시된 Skipped 기록이 이 테이블에 추가됩니다.

    테이블을 보려면 모두로 이동한 다음 탐색 필터에 open_nlu_predict_intent_feedback.list 를 입력합니다.

    표 1. NLU 예측 의도 피드백 테이블 열기의 주요 필드
    필드 설명

    NLU를 사용하는 애플리케이션입니다. 예: VA (가상 에이전트).

    앱 문서 애플리케이션 기록의 sys_id입니다. 예: sys_cs_topic.sys_id
    앱 문서 테이블 애플리케이션 기록의 테이블입니다. 예: sys_cs_topic (주제 테이블)
    자동 선택 시스템이 예측 임계치를 초과하는 의도를 하나만 탐지했기 때문에 애플리케이션이 동일한 의도와 일치하는 주제를 실행하기로 선택했는지 여부를 나타내는 부울입니다 true . 또는 false.
    현재 의도

    NLU 예측이 제출될 때 애플리케이션에서 사용한 NLU 의도입니다. 이 필드는 비워둘 수 있습니다(비어 있음). 예를 들어, 애플리케이션에서 사용되는 가상 에이전트 의도는 Change password다음과 같습니다.

    도메인 의도의 도메인입니다. 예를 들어 전역 또는 ITSM입니다.
    외부 모델 표시 이름

    외부 NLU 모델의 이름입니다. 예를 들어 NLU 애플리케이션의 이름입니다 IBM Watson Assistant .

    의도 스위치 원인 사용자에게 확인 메시지를 표시하는 원래 주제의 이름입니다. 이 열의 값에는 두 가지 시나리오가 있을 수 있습니다.
    • 사용자에게 발화에 대한 초기 의도 일치를 확인하라는 메시지가 표시됩니다(주제 VA 선택이 올바른지 사용자에게 질문 , NLU 설정에서 토글 스위치가 활성화되어 있는지 묻기).

      사용자에게 초기 발언을 묻는 메시지가 표시되면 이 값은 인사말 주제일 수 있습니다. 값이 다음과 같 empty으면 사용자에게 초기 일치에 대한 메시지가 표시되지 않았거나 사용자가 처음에 일치한 주제 의도를 거부한 것입니다.

    • 주제 중간에 의도 전환에 대한 확인을 요청하는 메시지가 사용자에게 표시됩니다(전환된 주제가 올바른지 사용자에게 질문 , NLU 설정에서 토글 전환이 활성화되어 있음).

      주제 중간에 전환하라는 메시지가 표시되면 이 값은 전환 시 보고 있던 주제의 이름입니다.

    주:
    시스템 작업도 여기에 표시될 수 있지만 무시할 수 있습니다. 예: __silent_TerminateGoal_a3817a5f7ca7439b8
    의도 스위치 원인 현재 작업 사용자가 전환하는 작업(노드)의 이름입니다.
    주:
    시스템 작업도 여기에 표시될 수 있지만 무시할 수 있습니다. 예: __silent_TerminateGoal_a3817a5f7ca7439b8
    매핑됨

    애플리케이션(가상 에이전트)이 의도를 사용 가능한 주제와 일치시켜 예측을 사용할 수 있는 것으로 간주했는지 여부를 나타내는 부울: true 또는 false.

    모델 표시 이름

    ServiceNow NLU 모델의 이름입니다.

    모델 ID 예측이 제출된 NLU 모델의 ID입니다.
    모델 이름 예측이 제출된 NLU 모델의 이름입니다.
    NLU 주제 디스커버리 결과 주제 디스커버리의 일부로 대화의 초기 발언에 대한 예측 결과:
    • AI 검색 폴백: 예측이 수행되지 않았습니다. AI 검색 이(가) 대체 수단으로 사용되었습니다.
    • 정답: 단일 예측이 이루어졌습니다. 사용자가 주제가 올바른지 확인했습니다.
    • 여러 가지 중 정답: 여러 예측이 이루어졌습니다. 이 결과는 사용자가 이 예측을 선택했음을 나타냅니다. 다른 예측 기록은 분류되지 않음으로 표시됩니다.
    • 확인 없이 종료됨: 사용자가 확인 없이 종료합니다.
    • 오답: 단일 예측이 수행되었습니다. 사용자가 주제가 잘못되었음을 확인했습니다.
    • 여러 항목 중 잘못됨: 여러 예측이 수행되었지만 사용자가 제안된 주제를 선택하지 않았습니다. 이 결과는 이 예측의 예측 신뢰도 값이 가장 높았음을 나타냅니다. 다른 예측 기록은 분류되지 않음으로 표시됩니다.
    • 주제 예측 설정: 를 사용하지 AI 검색않고 주제 관련 예측을 설정했습니다.
    • 건너뜀: 예측이 수행되지 않았습니다.
    • 새 발언으로 건너뜀: 주제 메뉴가 표시되면 사용자가 새 발언을 입력했습니다.
    • 분류되지 않음: 위 조건 중 어느 것도 충족되지 않았거나 사용자가 대화를 중단했습니다.
    NLU 모델 언어 예측에 사용되는 NLU 모델의 언어입니다.
    예측 예측 의도의 이름입니다.
    예측 감사 로그 열린 NLU 예측 로그 [open_nlu_predict_log] 테이블에 대한 참조입니다.
    예측 신뢰도 예측의 신뢰도 값입니다.
    요청자 세션 언어 요청자 세션 언어의 언어 코드(활성화된 경우) 동적 변환 입니다.

    예를 들어 사용자가 프랑스어로 입력하면 코드가 fr 저장됩니다. 언어 탐지를 사용하도록 설정하고 사용자가 기본값 가상 에이전트 이 아닌 언어로 텍스트를 입력하는 경우 사용자에게 언어를 확인하도록 요청합니다. 확인되면 탐지된 언어가 세션의 기본값이 됩니다.

    선택됨 최종 사용자에게 일치하는 주제로 표시된 여러 예측 의도를 최종 사용자가 실제로 선택했는지 여부를 나타내는 부울: true 또는 false.
    표시됨

    애플리케이션(가상 에이전트)이 최종 사용자가 선택할 수 있는 선택 항목으로 예측 의도를 표시했는지 여부를 나타내는 부울입니다 true . 또는 false.

    주제 전환됨 사용자에게 확인 메시지가 표시되는 경우의 주제 이름입니다(예, 아니요 선택에 관계없이).
    발언 최종 사용자가 채팅 클라이언트 창에 입력한 구문입니다.
    NLU 예측 엔터티 피드백 테이블 열기

    NLU 예측 엔터티 피드백 열기[open_nlu_predict_entity_feedback] 테이블에는 NLU 엔터티 예측 결과에 대한 응답으로 애플리케이션(이 경우 가상 에이전트)이 수행하는 엔터티(슬롯 채우기) 처리가 표시됩니다. 예를 들어, 의 가상 에이전트 목표는 예측된 NLU 엔터티를 주제 입력 변수에 매핑하는 가상 에이전트 것입니다.

    테이블을 보려면 탐색 필터에 open_nlu_predict_entity_feedback.list 를 입력합니다.

    표 2. NLU 예측 엔터티 피드백 테이블 열기의 주요 필드
    필드 설명

    NLU를 사용하는 애플리케이션입니다. 예: VA(가상 에이전트).

    앱 문서 애플리케이션 기록의 sys_id입니다. 예: sys_cs_topic.sys_id
    앱 문서 테이블 애플리케이션 기록의 테이블입니다. 예: sys_cs_topic
    자동 선택됨 애플리케이션이 사용자에게 알리지 않고 엔터티 사용을 자동으로 선택했는지 여부를 나타내는 부울: true 또는 false.
    외부 모델 표시 이름

    외부 NLU 모델의 이름입니다. 예를 들어 NLU 애플리케이션의 이름입니다 IBM Watson Assistant .

    매핑됨

    애플리케이션()가상 에이전트이 예측을 사용할 수 있는 것으로 간주하는지 여부를 나타내는 부울: true 또는 false.

    매핑 대상 엔터티가 매핑된 애플리케이션의 항목입니다.
    모델 표시 이름

    ServiceNow NLU 모델의 이름입니다.

    모델 ID 예측이 제출된 NLU 모델의 ID입니다.
    모델 이름 예측이 제출된 NLU 모델의 이름입니다.
    예측 예측된 엔터티의 이름입니다.
    예측 감사 로그 열린 NLU 예측 로그 [open_nlu_predict_log] 테이블에 대한 참조입니다.
    예측 신뢰도 예측에 대한 신뢰도 값입니다.
    선택됨 애플리케이션이 엔터티를 사용하도록 선택했는지 여부를 나타내는 부울: true 또는 false.
    표시됨 애플리케이션이 최종 사용자에게 예측된 엔터티를 선택할 선택 항목으로 표시했는지 여부를 나타내는 부울입니다 true . 또는 false.
    발언 채팅 클라이언트 창에 입력한 사용자 구문입니다.
    예측된 엔터티의 값입니다.
    NLU 예측 로그 오픈

    NLU 예측 로그 열기[open_nlu_predict_log] 테이블은 주제에 대한 NLU 예측 기록의 통합 개요를 제공합니다. 로그의 각 기록은 NLU 서비스에 의해 결정된 발화 및 해당 의도(주제) 및 엔터티를 식별합니다. 각 기록에는 주제 디스커버리(의도 일치) 및 엔터티 추출 중에 계산된 NLU 예측 점수도 포함됩니다.

    주:
    NLU 예측 노드 로그가 자동으로 생성됩니다. 디버깅에 노드 로그를 사용하지만 NLU 예측 노드 로그의 자동 생성을 억제하려면 시스템 속성을 추가하고 com.glide.opennlu.predict.node_logging_enabled 값을 false로 설정합니다.

    열린 NLU 예측 로그를 보려면 탐색 필터에 open_nlu_predict_log.list 를 입력합니다.

    표 3. NLU 예측 로그 열기 테이블의 주요 필드
    필드 설명
    비동기

    비동기 예측 처리에 대한 표시기: true 또는 false. True는 예측이 비동기적으로 가상 에이전트 수행되어 작업자 스레드가 계속될 수 있음을 나타냅니다.

    작성됨 NLU 예측 기록이 생성된 날짜 및 시간입니다.
    지속 시간 의도 및 엔터티 값을 반환하는 예측의 처리 시간입니다.
    언어 NLU 예측 요청의 언어입니다.
    수준 메시지 유형: 정보 수준.
    메시지 반환된 예측 결과: 의도 및 엔터티 수입니다.
    요청 인식된 의도에 대한 발화 및 NLU 모델을 포함하는 NLU 예측 매개변수입니다.
    응답 0개 이상의 점수가 매겨진 의도와 점수가 매겨진 엔터티를 포함하는 NLU 예측 결과입니다.
    소스 프로세스 또는 영역: OpenNLU - Predict.
    발언 봇이 인식한 사용자 설명으로, NLU 모델에 정의된 의도에 매핑됩니다.
    주:
    NLU 예측 의도 피드백 열기 및 NLU 예측 엔터티 피드백 열기 테이블에서 자세한 의도 및 엔터티 결과를 볼 수 있습니다.

    Open NLU 통합을 위한 HTTP 연결 정보 검토

    NLU 드라이버 HTTP 연결 열기[open_nlu_driver_http_connection] 테이블을 사용하여 NLU 서비스 제공자의 의도, 엔터티, NLU 모델 및 예측에 대한 HTTP 자격 증명, 연결 상세 정보 및 메서드를 신속하게 확인합니다.

    테이블을 보려면 탐색 필터에 open_nlu_driver_http_connection.list 를 입력합니다.