--- sourceDocument: Xanadu 대화형 인터페이스 sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/xanadu/conversational-interfaces Release : - xanadu ft:locale : - ko-KR ft:publication_title : - Xanadu 대화형 인터페이스 ft:clusterId : - convint bundleId : - convint workflow : - Platform --- # (NLU) 주제 검색 문제 해결 자연어 이해 # (NLU) 주제 검색 문제 해결 자연어 이해 {#ariaid-title1} * 릴리스 버전: Xanadu * * 업데이트 날짜 2024년 08월 01일 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 11분 의도가 예상한 시간에 선택되지 않는 경우 NLU 예측 오류를 해결할 수 있습니다. ## 빠른 문제 해결 팁 {#va-topic-discovery-issues__section_nyy_4d3_y5b} 검색 가상 에이전트 되지 않는 경우 다음을 확인합니다. 세션 언어에 NLU가 사용하도록 설정되어 있습니까? : 에 대한 (NLU) 설정에서 자연어 이해 언어를 활성화합니다 가상 에이전트. 자세한 내용은 [설정에서 가상 에이전트 NLU 언어 사용](https://servicenow-prod.fluidtopics.net/0M7bu6ojjH1Qc8qpKtyyZw "언어별 NLU 모델을 사용하려면 지원되는 NLU 언어 목록에서 설치된 언어를 활성화해야 합니다. 사용 열이 true로 표시되면 언어를 사용할 수 있습니다. 영어는 기본적으로 활성화되어 있습니다.") 문서를 참조하십시오. NLU 모델이 세션 언어에 대해 교육되고 게시되었습니까? : 주제에서 모델의 최신 변경 내용을 사용하지 않을 수 있습니다. NLU의 경우 ServiceNow®[NLU 모델 교육 및 시도](https://www.servicenow.com/docs/access?context=test-train-nlu-model&version=xanadu&pubname=xanadu-intelligent-experiences&ft:locale=en-US) 및 [주제 게시 가상 에이전트](https://servicenow-prod.fluidtopics.net/IHpy7ZdEdDtnO27D6j8lXQ "비활성 주제 또는 업데이트된 주제를 배포하여 저장하고 클라이언트의 가상 에이전트 사용자가 사용할 수 있도록 합니다.")를 참조하십시오. 주제가 가상 에이전트 게시되고 검색 가능하며 세션 언어에 대해 게시된 NLU 모델 및 의도에 바인딩됩니까? : 주제는 지정된 언어에 대한 단일 모델과 의도에 바인딩되어야 합니다. 다른 주제에 바인딩된 의도가 중복되지 않도록 합니다. 주제, 모델 및 의도가 동일한 도메인에 있는지 확인합니다. 자세한 내용은 [주제 게시 가상 에이전트](https://servicenow-prod.fluidtopics.net/IHpy7ZdEdDtnO27D6j8lXQ "비활성 주제 또는 업데이트된 주제를 배포하여 저장하고 클라이언트의 가상 에이전트 사용자가 사용할 수 있도록 합니다.") 문서를 참조하십시오. 디자이너의 속성 탭 가상 에이전트 에 가상 에이전트 있는 항목에 대해 지정된 역할 또는 조건이 있습니까? : 주제가 특정 역할 또는 특정 조건에 대해서만 표시되는 경우 주제 검색에 방해가 될 수 있습니다. 자세한 내용은 [주제 속성 탭](https://servicenow-prod.fluidtopics.net/LzWCWKP040ffjHaqYAPxAQ "주제 속성 탭을 사용하여 주제와 사용 방법을 식별할 수 있습니다. 주제를 사용하는 사용자와 해당 주제를 실행할 수 있는 채널을 제어할 수 있습니다.") 문서를 참조하십시오. 내 주제가 프랑스어가 아닌 스페인어로 검색된 가상 에이전트 이유는 무엇입니까? : 다음과 같은 몇 가지 가능성이 있습니다. * 모든 NLU 제공자가 모든 언어를 지원하는 것은 아닙니다. 자세한 내용은 [서비스에 대한 NLU 언어 지원](https://servicenow-prod.fluidtopics.net/lgjOODRnvEGoegMxSPsCHg "엔터티 추출은 특정 언어에 대해서만 NLU 모델에서 ServiceNow 지원됩니다. 나머지 언어는 인텐트 일치만 지원합니다. 또는 Microsoft LUIS를 사용하는 IBM Watson Assistant 경우 지원되는 언어는 다양합니다.") 문서를 참조하십시오. * 모든 주제가 언어별 NLU 모델 및 의도에 바인딩되는 것은 아닙니다. 예를 들어, 토픽 A는 다음과 같이 매핑될 수 있습니다. * 영어의 경우 모델 A 및 의도 A에 바인딩 * 스페인어의 경우 모델 A 및 의도 A에 바인딩 * 프랑스어의 모델이나 의도에 구속되지 않음 {#va-topic-discovery-issues__ul_eyy_hm1_1vb}이 시나리오에서는 주제에 대한 프랑스어 모델과 의도를 만듭니다. 자세한 내용은 [다국어 모델 관리를](https://www.servicenow.com/docs/access?context=multilingual-model-managent&version=xanadu&pubname=xanadu-intelligent-experiences&ft:locale=en-US) 참조하세요. {#va-topic-discovery-issues__ul_jck_rl1_1vb} 주제 변수의 슬롯이 채워지지 않은 이유는 무엇입니까? : 다음을 확인하십시오. * 토픽의 사용자 입력 노드가 연결된 엔터티로 구성되지 않았습니다. 의 가상 에이전트 디자이너노드에 대한 NLU 엔터티 속성을 사용합니다. ![NLU 엔터티 목록에서 기존 엔터티를 지정합니다.]() * 예측 결과에 신뢰 점수가 구성된 신뢰 임계치보다 작은 NLU 엔터티가 포함되었습니다. * 노드에 대한 NLU 엔터티 값이 잘못되었습니다. 예를 들어 날짜/시간 엔터티 형식에는 "빨간색"이라는 단어를 적용할 수 없습니다. {#va-topic-discovery-issues__ul_vys_y14_1vb} 주제에서 검색을 테스트합니다. : 다음 중 하나를 수행합니다. * 주제 페이지에서 활성 주제 테스트를 선택합니다. 발화를 입력하고 테스트 구 분석 탭을 시청합니다. * 에서 가상 에이전트 디자이너주제를 연 다음, 테스트를 선택합니다. 테스트 창에서 토픽 검색 포함 선택란을 선택하십시오. 발화를 입력하고 테스트 구 분석 탭을 시청합니다. {#va-topic-discovery-issues__ul_ffl_pd1_1vb} 자세한 내용은 [테스트 NLU/키워드 주제](https://servicenow-prod.fluidtopics.net/7yM3d~E8jMPe3wukm5RnXQ "채팅 테스트 창을 사용하여 자연어 이해(NLU)/키워드 주제를 미리 보고, 테스트하고, 디버그합니다.") 문서를 참조하십시오. 주제 검색의 작동 방식을 이해하려면 다음 문서를 참조하십시오 [자연어 이해 의 주제 검색 논리 가상 에이전트](https://servicenow-prod.fluidtopics.net/Jtfac78QPSp4FmtDbV6lpg "의도를 반환하는 방법과 가상 에이전트 사용자에게 표시할 의도를 선택하는 방법을 이해합니다."). "주제 설정"이 문제의 주제입니까? : 그렇다면 채팅 설정에서 대화형 인터페이스 구성해야 검색할 수 있습니다. 자세한 내용은 [가상 에이전트 채팅 경험 구성](https://servicenow-prod.fluidtopics.net/yTCu6~2Hiot_qa50R1pi7A "미리 구성된 가상 에이전트 기본 채팅 환경을 변경하거나 사용자에 대한 사용자 지정 채팅 환경을 만듭니다. 설정 주제를 구성하고, 승격된 주제를 지정하고, 필요한 경우 검색 프로파일을 변경할 수 있습니다.") 문서를 참조하십시오. 중간 주제 전환에 대한 질문 또는 문제입니다. : 주제 B로 전환되었다가 가상 에이전트 대화가 주제 A로 돌아가는 이유는 무엇입니까? : 주제 전환 후 주제 플로우 재개 속성이 주제에서 활성화됩니다. 이 토글 스위치는 아래의 속성 탭에서 찾을 수 있습니다. 고급 속성추가. 주제 B로 전환한 후 가상 에이전트 대화가 주제 A로 돌아가지 않는 이유는 무엇입니까? : 주제 전환 후 주제 플로우 재개 속성이 주제에서 비활성화되어 있습니다. 이 토글 스위치는 아래의 속성 탭에서 찾을 수 있습니다. 고급 속성추가. 가상 에이전트 의도를 찾지 못하면 주제 중간에 키워드 검색을 사용합니까? : 번호 전환 후 주제 A의 변수를 주제 B에서 사용할 수 있습니까? : 번호 주제 A가 재개될 때 주제 B의 변수를 주제 A에서 사용할 수 있습니까? : 번호 추가 문제 해결에 대해서는 다음 표의 정보를 확인하십시오. ## 열린 NLU 테이블에서 NLU 예측 정보 확인 {#va-topic-discovery-issues__section_xbt_zrn_vjb} (NLU)를 사용하는 자연어 이해 주제를 검토하거나 디버깅할 때 다양한 NLU 열기 테이블을 사용하여 주제에 대한 NLU 예측 결과를 볼 수 있습니다. 예를 들어, NLU 예측 의도 피드백 열기 및 NLU 예측 엔터티 피드백 열기 테이블은 주제 의도 및 엔터티(슬롯 채우기)를 결정하기 위해 애플리케이션(예 가상 에이전트: )에서 수행하는 NLU 처리에 대한 자세한 정보를 제공합니다. NLU 예측 의도 피드백 테이블 열기 : NLU 의도 피드백 예측 \[open_nlu_predict_intent_feedback\] 열기 테이블은 NLU 의도 예측 결과에 대한 응답으로 애플리케이션(이 경우 가상 에이전트)이 수행하는 의도 처리를 보여줍니다. 의 목표는 가상 에이전트 예측된 NLU 의도를 가상 에이전트 주제에 매핑하는 것입니다. 주제가 제안될 때마다 가상 에이전트 예측 결과의 기록이 이 테이블에 추가됩니다. 가상 에이전트 에서 주제를 찾지 못하면 예측이 발생하지 않으며 표시된 Skipped 기록이 이 테이블에 추가됩니다. 테이블을 보려면 모두로 이동한 다음 탐색 필터에 open_nlu_predict_intent_feedback.list 를 입력합니다. {#va-topic-discovery-issues__table_ojs_j3y_vjb__entry__2} | 필드 | 설명 | |-|-| | 앱 | NLU를 사용하는 애플리케이션입니다. 예: VA (가상 에이전트). | | 앱 문서 | 애플리케이션 기록의 sys_id입니다. 예: sys_cs_topic.sys_id | | 앱 문서 테이블 | 애플리케이션 기록의 테이블입니다. 예: sys_cs_topic (주제 테이블) | | 자동 선택 | 시스템이 예측 임계치를 초과하는 의도를 하나만 탐지하여 애플리케이션이 동일한 의도와 일치하는 주제를 실행하도록 선택했는지 여부를 나타내는 부울입니다. truefalse | | 현재 의도 | NLU 예측이 제출될 때 애플리케이션에서 사용한 NLU 의도입니다. 이 필드는 비워 둘 수 있습니다(공백). 예를 들어 애플리케이션에 Change password사용되는 의도는 가상 에이전트 . | | 도메인 | 의도의 도메인입니다. 예를 들어 전역 또는 ITSM과 같은 이름을 지정할 수 있습니다. | | 외부 모델 표시 이름 | 외부 NLU 모델의 이름입니다. 예를 들어, NLU 애플리케이션의 IBM Watson Assistant 이름입니다. | | 의도 스위치 원인 | 사용자에게 확인 메시지를 표시하는 원래 주제의 이름입니다. 이 열의 값에 대해 가능한 두 가지 시나리오는 다음과 같습니다. * 사용자에게 발언에 대한 초기 의도 일치를 확인하는 메시지가 표시됩니다(주제 VA 선택이 올바른지 사용자에게 질문[하고 NLU 설정](https://servicenow-prod.fluidtopics.net/X5o8gduXzY3D5z_O9yl6QQ "인스턴스의 서비스 제공자를 식별 NLU 하기 위해 (NLU)를 가상 에이전트 구성합니다 자연어 이해 . 또한 제공자 및 에서 지원하는 NLU 언어를 기반으로 대화 디자인 중에 사용되는 모델 언어를 NLU 지정할 수 있습니다Now Platform.")에서 토글 스위치를 활성화한 경우). 사용자에게 초기 발언을 입력하라는 메시지가 표시되는 경우 이 값은 인사말 주제일 수 있습니다. 값이 empty인 경우 사용자에게 초기 일치에 대한 메시지가 표시되지 않았거나 사용자가 처음에 일치하는 주제 의도를 거부했습니다. * 주제 중간에서 의도 전환을 확인하라는 메시지가 사용자에게 표시됩니다(전환된 주제가 올바른지 사용자에게 묻 기 토글 스위치가 [NLU 설정](https://servicenow-prod.fluidtopics.net/X5o8gduXzY3D5z_O9yl6QQ "인스턴스의 서비스 제공자를 식별 NLU 하기 위해 (NLU)를 가상 에이전트 구성합니다 자연어 이해 . 또한 제공자 및 에서 지원하는 NLU 언어를 기반으로 대화 디자인 중에 사용되는 모델 언어를 NLU 지정할 수 있습니다Now Platform.")에서 활성화되어 있음). 주제 중간에서 전환하라는 메시지가 사용자에게 표시되면 이 값은 전환 당시 보고 있던 주제의 이름입니다. {#va-topic-discovery-issues__ul_y1q_rnl_lpb} 주: 시스템 작업도 여기에 표시될 수 있으며 무시할 수 있습니다. 예: __silent_TerminateGoal_a3817a5f7ca7439b8 | | 의도 스위치 원인 현재 작업 | 사용자가 전환한 작업(노드)의 이름입니다. 주: 시스템 작업도 여기에 표시될 수 있으며 무시할 수 있습니다. 예: __silent_TerminateGoal_a3817a5f7ca7439b8 | | 매핑됨 | 애플리케이션(가상 에이전트)이 의도를 사용 가능한 주제와 일치시켜 예측을 사용할 수 있는 것으로 간주했는지 여부를 나타내는 부울: true 또는 false. | | 모델 표시 이름 | ServiceNow NLU 모델의 이름입니다. | | 모델 ID | 예측이 제출된 NLU 모델의 ID입니다. | | 모델 이름 | 예측이 제출된 NLU 모델의 이름입니다. | | NLU 주제 검색 결과 | 주제 검색의 일부로 대화의 초기 발언에 대한 예측 결과: * AI 검색 폴백: 예측이 수행되지 않았습니다. AI 검색 이(가) 폴백으로 사용되었습니다. * 정답: 단일 예측이 수행되었습니다. 사용자가 주제가 올바른지 확인했습니다. * 여러 항목 중 정답: 여러 예측이 수행되었습니다. 이 결과는 사용자가 이 예측을 선택했음을 나타냅니다. 다른 예측 기록은 분류되지 않음으로 표시됩니다. * 확인 없이 종료됨: 사용자가 확인 없이 종료합니다. * 잘못된 예: 단일 예측이 작성되었습니다. 사용자가 주제가 올바르지 않음을 확인했습니다. * 여러 항목 중 올바르지 않음: 여러 예측이 수행되었지만 사용자가 제안된 주제를 선택하지 않았습니다. 이 결과는 이 예측의 예측 신뢰도 값이 가장 높았음을 나타냅니다. 다른 예측 기록은 분류되지 않음으로 표시됩니다. * 주제 예측 설정: 를 사용하지 AI 검색않고 주제 관련 예측을 설정했습니다. * 건너뜀: 예측이 수행되지 않았습니다. * 새 발화로 건너뜀: 주제 메뉴가 표시되면 사용자가 새 발화를 입력했습니다. * 분류되지 않음: 위의 조건 중 어느 것도 충족되지 않았거나 사용자가 대화를 중단했습니다. {#va-topic-discovery-issues__ul_kkl_npx_rqb} | | NLU 모델 언어 | 예측에 사용되는 NLU 모델 언어입니다. | | 예측 | 예측된 의도의 이름입니다. | | 예측 감사 로그 | 열린 NLU 예측 로그\[open_nlu_predict_log\] 테이블에 대한 참조입니다. | | 예측 신뢰도 | 예측의 신뢰도 값입니다. | | 요청자 세션 언어 | 활성화된 경우 동적 변환 요청자 세션 언어의 언어 코드입니다. 예를 들어 사용자가 프랑스어로 입력하면 코드가 fr 저장됩니다. 언어 탐지가 활성화되어 있고 사용자가 기본값이 아닌 언어로 텍스트를 입력하는 경우 는 가상 에이전트 사용자에게 언어를 확인하도록 요청합니다. 확인되면 탐지된 언어가 세션의 기본값이 됩니다. | | 선택됨 | 최종 사용자에게 일치하는 주제로 표시된 여러 예측 의도가 실제로 최종 사용자에 의해 선택되었는지 여부를 나타내는 부울: true 또는 false. | | 표시됨 | 애플리케이션(가상 에이전트)이 최종 사용자가 선택할 수 있는 선택 항목으로 예측된 의도를 표시했는지 여부를 나타내는 부울: true 또는 false. | | 주제 전환됨 | 사용자에게 확인 메시지가 표시된 경우(선택 여부, 예 또는 아니요에 관계없이) 주제의 이름입니다. | | 발언 | 채팅 클라이언트 창에서 최종 사용자가 입력한 구문입니다. | [표 1. 오픈 NLU 예측 의도 피드백 테이블의 주요 필드] {#va-topic-discovery-issues__table_ojs_j3y_vjb} NLU 예측 엔터티 피드백 테이블 열기 : NLU 예측 엔터티 피드백 열기 \[open_nlu_predict_entity_feedback\] 테이블은 NLU 엔터티 예측 결과에 대한 응답으로 애플리케이션(이 경우 가상 에이전트)이 수행하는 엔터티(슬롯 채우기) 처리를 보여줍니다. 예를 들어, 의 가상 에이전트 목표는 예측된 NLU 엔터티를 주제 입력 변수에 가상 에이전트 매핑하는 것입니다. 테이블을 보려면 탐색 필터에 open_nlu_predict_entity_feedback.list 를 입력합니다. {#va-topic-discovery-issues__table_u1p_kyx_vjb__entry__2} | 필드 | 설명 | |-|-| | 앱 | 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. | | 발언 | 채팅 클라이언트 창에 입력된 사용자 구문입니다. | | 값 | 예측된 엔터티의 값입니다. | [표 2. NLU 예측 엔터티 피드백 테이블의 주요 필드] {#va-topic-discovery-issues__table_u1p_kyx_vjb} 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 를 입력합니다. {#va-topic-discovery-issues__table_ns3_fmg_yhb__entry__2} | 필드 | 설명 | |-|-| | 비동기 | 비동기 예측 처리에 대한 표시기: true 또는 false. True는 예측이 비동기적으로 수행되어 작업자 스레드를 계속할 수 있음을 가상 에이전트 나타냅니다. | | 작성됨 | NLU 예측 기록이 생성된 날짜 및 시간입니다. | | 지속 시간 | 의도 및 엔터티 값을 반환하는 예측의 처리 시간 길이입니다. | | 언어 | NLU 예측 요청의 언어입니다. | | 수준 | 메시지 유형: 정보 수준입니다. | | 메시지 | 반환된 예측 결과: 의도 및 엔터티 수. | | 요청 | 인식된 의도에 대한 발언 및 NLU 모델을 포함하는 NLU 예측 매개변수입니다. | | 응답 | 0개 이상의 점수가 매겨진 의도와 점수가 매겨진 엔터티가 포함된 NLU 예측 결과. | | 소스 | 프로세스 또는 영역: OpenNLU - Predict. | | 발언 | 봇이 인식한 사용자 문으로, NLU 모델에 정의된 의도에 매핑됩니다. | [표 3. NLU 예측 로그 오픈 테이블의 주요 필드] {#va-topic-discovery-issues__table_ns3_fmg_yhb} 주: 자세한 의도 및 엔터티 결과는 NLU 예측 의도 피드백 열기 및 NLU 예측 엔터티 피드백 열기 테이블에서 볼 수 있습니다. ## Open NLU 통합에 대한 HTTP 연결 정보 검토 {#va-topic-discovery-issues__section_wcv_djw_wjb} NLU 드라이버 HTTP 연결 \[open_nlu_driver_http_connection\] 열기 테이블을 사용하여 NLU 서비스 제공자의 의도, 엔터티, NLU 모델 및 예측에 대한 HTTP 자격 증명, 연결 상세 정보 및 메서드를 빠르게 확인합니다. 테이블을 보려면 탐색 필터에 open_nlu_driver_http_connection.list 를 입력합니다.