해결 자연어 이해 (NLU) 주제 검색 문제

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

    빠른 문제 해결 팁

    검색 가상 에이전트 되지 않으면 다음을 확인하십시오.
    세션 언어에 NLU가 활성화되어 있습니까?
    에 대한 가상 에이전트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가 재개될 때 주제 A에서 주제 B의 변수를 사용할 수 있습니까?
    번호

    추가 문제 해결을 위해 다음 테이블의 정보를 확인하십시오.

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

    (NLU)를 사용하는 자연어 이해 주제를 검토하거나 디버깅할 때 다양한 Open 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 (주제 테이블).
    자동 선택됨 시스템이 예측 임계치보다 높은 의도를 하나만 탐지하여 애플리케이션이 동일한 의도 truefalse와 일치하는 주제를 실행하도록 선택했는지 여부를 나타내는 부울 또는 .
    현재 의도

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

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

    외부 NLU 모델의 이름입니다. NLU 애플리케이션의 IBM Watson Assistant 이름을 예로 들 수 있습니다.

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

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

    • 사용자에게 중간 주제에서 의도 전환을 확인하라는 메시지가 표시됩니다(전환된 주제가 올바른지 사용자에게 물어보세요 . NLU 설정에서 토글 스위치가 활성화되어 있음).

      주제 중간에서 사용자에게 전환하라는 메시지가 표시되는 경우 이 값은 전환 시 보고 있던 주제의 이름입니다.

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

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

    모델 표시 이름

    NLU 모델의 이름입니다 ServiceNow .

    모델 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.

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

    NLU 모델의 이름입니다 ServiceNow .

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