--- 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) 소요 시간: 10분 전역적으로 정의된 NLU 엔터티를 사용하여 대화에서 추출할 수 있는 가상 에이전트 시스템 정보를 식별합니다. 엔터티를 주제에 대한 "노드 없는" 입력 변수로 정의할 수 있습니다. 이러한 변수는 서비스 제공자 예측에서 NLU 슬롯으로 채워지거나 주제 범위 밖에서 제공될 수 있습니다. 시스템 엔터티는 기본적으로 모델에서 NLU 활성화됩니다. 의 NLU 워크벤치모델 엔터티 탭에서 볼 수 있습니다. ## 글로벌. DATE 시스템 엔터티 {#nlu-system-entities__section_cqn_53d_lpb} DAY SubType은 특정 날짜까지 정확한 날짜 문자열을 반환합니다. {#nlu-system-entities__table_lcl_cjd_lpb__entry__2} | 사용량 | 예제 | |-|-| | 형식 | YYYY-MM-DD | | 정규 표현식 | \\\\d\\\\d\\\\d\\\\d-\\\\d\\\\d-\\\\d\\\\d | | 입력 예 | 스미스 씨는 2019년 2월 4일 금요일에 떠났습니다. | | 정규화된 값 | 2019-02-04 | | 코드 예제 | { "name": "DATE", "value": "...", "score": 1.0, "normalization": "2019-02-04" } | [표 1. 글로벌. DATE 하위 유형 = DAY 사용량] {#nlu-system-entities__table_lcl_cjd_lpb} WEEK SubType은 연도의 특정 주에 대한 날짜 문자열을 반환합니다. {#nlu-system-entities__table_crg_tjd_lpb__entry__2} | 사용량 | 예제 | |-|-| | 형식 | YYYY'W'WW | | 정규 표현식 | \\\\d\\\\d\\\\d\\\\d\\\\dW\\\\d\\\\d | | 입력 예 | 스미스 씨는 1999년 셋째 주에 떠났다. | | 정규화된 값 | 1999W3 | | 코드 예제 | { "name": "entity:GLOBAL.DATE", "value": "...", "score": 1.0, "normalization": {"type": "GLOBAL.DATE", "subType": "WEEK", "value":"1999W3"} } | [표 2. 글로벌. DATE 하위 유형 = WEEK 사용량] {#nlu-system-entities__table_crg_tjd_lpb} MONTH SubType은 연도의 특정 월에 대한 날짜 문자열을 반환합니다. {#nlu-system-entities__table_edh_sld_lpb__entry__2} | 사용량 | 예제 | |-|-| | 형식 | YYYY'M'MM | | 정규 표현식 | \\\\d\\\\d\\\\d\\\\dM\\\\d\\\\d | | 입력 예 | 스미스 씨는 1999년 2월에 회사를 떠났습니다. | | 정규화된 값 | 1999M02 | | 코드 예제 | { "name": "entity:GLOBAL.DATE", "value": "...", "score": 1.0, "normalization": {"type": "GLOBAL.DATE", "subType": "MONTH", "value": "1999M02"} } | [표 3. 글로벌. DATE SubType = MONTH 사용량] {#nlu-system-entities__table_edh_sld_lpb} YEAR SubType은 특정 연도의 날짜 문자열을 반환합니다. {#nlu-system-entities__table_pxj_1md_lpb__entry__2} | 사용량 | 예제 | |-|-| | 형식 | 연도 | | 정규 표현식 | \\\\d\\\\d\\\\d\\\\d | | 입력 예 | 스미스 씨는 1999년에 회사를 떠났습니다. | | 정규화된 값 | 1999 | | 코드 예제 | { "name": "entity:GLOBAL.DATE", "value": "...", "score": 1.0, "normalization": {"type": "GLOBAL.DATE", "subType": "YEAR", "value": "1999"} } | [표 4. 글로벌. DATE 하위 유형 = YEAR 사용량] {#nlu-system-entities__table_pxj_1md_lpb} SEASON SubType은 해당 연도의 특정 시즌의 날짜 문자열을 반환합니다. {#nlu-system-entities__table_s1q_fpd_lpb__entry__2} | 사용량 | 예제 | |-|-| | 형식 | 다음 중 하나입니다. * 겨울: YYYYWI * 봄: YYYYSP * 여름: YYYYSU * 가을: YYYYFA {#nlu-system-entities__ul_m4j_jpd_lpb} | | 정규 표현식 | 다음 중 하나입니다. * 겨울: \\\\d\\\\d\\\\d\\\\dWI * 스프링: \\\\d\\\\d\\\\d\\\\dSP * 여름: \\\\d\\\\d\\\\d\\\\dSU * 가을: \\\\d\\\\d\\\\d\\\\dFA {#nlu-system-entities__ul_cnh_npd_lpb} | | 입력 예 | 스미스 씨는 1999년 가을에 회사를 떠났습니다. | | 정규화된 값 | 1999FA | | 코드 예제 | { "name": "entity:GLOBAL.DATE", "value": "...", "score": 1.0, "normalization": {"type": "GLOBAL.DATE", "subType": "SEASON", "value": "1999FA"} } | [표 5. 글로벌. DATE 하위 유형 = SEASON 사용량] {#nlu-system-entities__table_s1q_fpd_lpb} ## 글로벌. TIME 시스템 엔터티 {#nlu-system-entities__section_rrk_kqd_lpb} TIME SubType은 시간 및 분까지 정확한 시간 문자열을 반환합니다. {#nlu-system-entities__table_zrm_mqd_lpb__entry__2} | 사용량 | 예제 | |-|-| | 형식 | 'T'HH:mm | | 정규 표현식 | T\\\\d\\\\d:\\\\d\\\\d | | 입력 예 | 스미스 씨는 10분에서 3분 사이에 떠났다. | | 정규화된 값 | T02:50 | | 코드 예제 | { "name": "entity:GLOBAL.TIME", "value": "...", "score": 1.0, "normalization": {"type": "GLOBAL.TIME","subType": "TIME", "value": "T02:50"} } | [표 6. 글로벌. TIME 하위 유형 = TIME 사용량] {#nlu-system-entities__table_zrm_mqd_lpb} PARTSOFDAY SubType은 하루의 일부를 지정하는 시간 문자열을 반환합니다. {#nlu-system-entities__table_thr_wqd_lpb__entry__2} | 사용량 | 예제 | |-|-| | 형식 | 다음 중 하나입니다. * 오전: TMO * 오후: TAF * 저녁: TEV * 야간: TNI {#nlu-system-entities__ul_xl5_crd_lpb} | | 정규 표현식 | 다음 중 하나입니다. * 오전: TMO * 오후: TAF * 저녁: TEV * 야간: TNI {#nlu-system-entities__ul_omc_grd_lpb} | | 입력 예 | 스미스 씨는 아침에 떠났다. | | 정규화된 값 | 티엠모 | | 코드 예제 | { "name": "entity:GLOBAL.TIME", "value": "...", "score": 1.0, "normalization": {"type": "GLOBAL.TIME", "subType": "PARTSOFDAY", "value": "TMO"} } | [표 7. 글로벌. TIME 하위 유형 = PARTSOFDAY 사용량] {#nlu-system-entities__table_thr_wqd_lpb} ## 글로벌. DATE_TIME 시스템 엔터티 {#nlu-system-entities__section_rkt_pbc_3vb} DATE_TIME SubType은 특정 날짜 및 시간 문자열에 대해 정확한 날짜 문자열(시간 및 분까지 정확한 날짜 문자열)을 반환합니다. {#nlu-system-entities__table_wsh_ybc_3vb__entry__2} | 사용량 | 예제 | |-|-| | 형식 | YYYY-MM-DD'T'HH:mm | | 정규 표현식 | \\\\d\\\\d\\\\d\\\\d-\\\\d\\\\d-\\\\d\\\\d\\\\dT\\\\d\\\\d\\\\d\\\\d | | 입력 예 | Mr. Smith는 10월 31일 오후 5:00에 떠납니다. | | 정규화된 값 | 2022-10-31T17:00 | | 코드 예제 | { "name": "DATE_TIME", "value": "October 31st at 5:00 p.m", "normalization": "2022-10-31T17:00","confidence": "1" } | [표 8. 글로벌. DATE_TIME SubType = 날짜/시간 사용량] {#nlu-system-entities__table_wsh_ybc_3vb} ## 글로벌. DURATION 시스템 엔터티 {#nlu-system-entities__section_qhq_jrd_lpb} 이 엔터티는 활동 기간을 지정하는 기간 문자열을 반환합니다. {#nlu-system-entities__table_gf3_mrd_lpb__entry__2} | 사용량 | 예제 | |-|-| | 형식 | 다음 중 하나입니다. * 두 번째: 's'ss * 분: 'm'mm * 시간: 'h'hhh * 낮: 'D'DD * 주간: 'W'WW * 월: 'M'MM * 연도: 'Y'YY {#nlu-system-entities__ul_dkp_qrd_lpb} | | 정규 표현식 | 다음 중 하나입니다. * 두 번째: s\\\\d\\\\d * 분: m\\\\d\\\\d * 시간: h\\\\d\\\\d * 일: D\\\\d\\\\d * 주: W\\\\d\\\\d * 월: M\\\\d\\\\d * 연도: Y\\\\d\\\\d {#nlu-system-entities__ul_bcb_yrd_lpb} | | 입력 예 | 스미스 씨는 보스턴에 48시간 동안 머물렀다. | | 정규화된 값 | h48 | | 코드 예제 | { "name": "entity:GLOBAL.DURATION", "value": "...", "score": 1.0, "normalization": {"type": "GLOBAL.DURATION", "value": "h48"} } | [표 9. 글로벌. DURATION 사용량] {#nlu-system-entities__table_gf3_mrd_lpb} ## 글로벌. LOCATION 시스템 엔터티 {#nlu-system-entities__section_wpj_2sd_lpb} 이 엔터티는 위치 문자열을 반환합니다. {#nlu-system-entities__table_wd5_cvd_lpb__entry__2} | 사용량 | 예제 | |-|-| | 형식 | 문자열 값입니다. 예: 산타클라라 | | 정규 표현식 | 해당 사항 없음. | | 입력 예 | 스미스 씨는 산타클라라에서 일합니다. | | 정규화된 값 | 산타클라라 | | 코드 예제 | { "name": "entity:GLOBAL.LOCATION", "value": "...", "score": 1.0, "normalization": {"type": "GLOBAL.LOCATION", "value":"Santa Clara"} } | [표 10. 글로벌. 위치 사용량] {#nlu-system-entities__table_wd5_cvd_lpb} ## 글로벌. PERSON 시스템 엔터티 {#nlu-system-entities__section_b1x_jvd_lpb} 이 엔터티는 이름 문자열을 반환합니다. {#nlu-system-entities__table_og1_nvd_lpb__entry__2} | 사용량 | 예제 | |-|-| | 형식 | 문자열 값입니다. 예: Joe Smith | | 정규 표현식 | 해당 사항 없음. | | 입력 예 | Joe Smith는 산타클라라에서 일합니다. | | 정규화된 값 | 조 스미스 | | 코드 예제 | { "name": "entity:GLOBAL.PERSON", "value": "...", "score": 1.0, "normalization": {"type": "GLOBAL.PERSON", "value":"Joe Smith"} } | [ ] {#nlu-system-entities__table_og1_nvd_lpb} ## 글로벌. MONEY 시스템 엔터티 {#nlu-system-entities__section_xkc_5vd_lpb} 이 엔터티는 통화 문자열을 반환합니다. {#nlu-system-entities__table_c1b_wvd_lpb__entry__2} | 사용량 | 예제 | |-|-| | 형식 | 문자열 값입니다. 예: USD 2000 | | 정규 표현식 | 해당 사항 없음. | | 입력 예 | $2000 미만의 노트북을 보여주세요. | | 정규화된 값 | 미화 2,000달러 주: 정규화된 값은 소스 통화의 세 글자 ISO 3166 국가 코드를 사용합니다. | | 코드 예제 | { "name": "entity:GLOBAL.MONEY", "value": "...", "score": 1.0, "normalization": {"type": "GLOBAL.MONEY", "value":"2000", "currency":"USD"} } | [표 11. 글로벌. MONEY 사용량] {#nlu-system-entities__table_c1b_wvd_lpb} ## 글로벌. NUMBER 시스템 엔터티 {#nlu-system-entities__section_fn2_ywd_lpb} 이 엔터티는 숫자를 반환합니다. {#nlu-system-entities__table_jxp_byd_lpb__entry__2} | 사용량 | 예제 | |-|-| | 형식 | 문자열 값입니다. 예: 5.0 | | 정규 표현식 | 해당 사항 없음. | | 입력 예 | 내 계정에서 이전 5건의 거래를 보고 싶습니다. | | 정규화된 값 | 5.0 | | 코드 예제 | { "name": "entity:GLOBAL.NUMBER", "value": "...", "score": 1.0, "normalization": {"numericValue":"5", "normalizedValue": "5"} } | [ ] {#nlu-system-entities__table_jxp_byd_lpb} ## 글로벌. 소프트웨어 {#nlu-system-entities__section_cr2_scy_brb} 소프트웨어 문자열을 반환합니다. {#nlu-system-entities__table_oq4_vcy_brb__entry__2} | 사용량 | 예제 | |-|-| | 형식 | 문자열 값입니다. 예: Java | | 정규 표현식 | 해당 사항 없음. | | 입력 예 | Java는 어떻게 설치합니까? | | 정규화된 값 | Java | | 코드 예제 | { "name": "entity:GLOBAL.SOFTWARE", "value": "Java", "score": 0.99930537, "normalization": {"type":"entity:GLOBAL.SOFTWARE", "subType":"SOFTWARE", "value":"Java"} } | [ ] {#nlu-system-entities__table_oq4_vcy_brb} ## 글로벌. 하드웨어 {#nlu-system-entities__section_bdt_xcy_brb} 하드웨어 문자열을 반환합니다. {#nlu-system-entities__table_dfl_ycy_brb__entry__2} | 사용량 | 예제 | |-|-| | 형식 | 문자열 값입니다. 예: printer | | 정규 표현식 | 해당 사항 없음. | | 입력 예 | 프린터는 어떻게 주문합니까? | | 정규화된 값 | printer | | 코드 예제 | { "name": "entity:GLOBAL.HARDWARE", "value": "printer", "score": 1.0, "normalization": {"type":"entity:GLOBAL.HARDWARE", "subType":"HARDWARE", "value":"printer"} } | [ ] {#nlu-system-entities__table_dfl_ycy_brb} ## 소프트웨어 시스템 엔터티를 사용한 예측 결과 예시 NLU {#nlu-system-entities__section_hlp_xdy_brb} {"status":"success", "response":{ "utterance":"How do I install Java?", "intents":[ { "intentName":"test intent", "nluModelName":"ml_x_snc_global_global_268a97a9dbd23c107906265d1396191a", "score":0.90401393, "intents":[ ], "entities":[ { "name":"entity:GLOBAL.SOFTWARE", "value":"Java", "score":0.99930537, "normalization":{ "type":"entity:GLOBAL.SOFTWARE", "subType":"SOFTWARE", "value":"Java" }, "startingPosition":-1 } ] } ], "properties":{ "all:ml_x_snc_global_global_268a97a9dbd23c107906265d1396191a":"0.55", "entity:all":"0.01", "inference.sspace.time":"4", "inference.time":"33", "intent:all":"0.01", "nluPlatformLanguage":"en", "nluPlatformVersion":"rome.0" } } } ## DATE 시스템 엔터티를 사용한 예측 결과 예시 NLU {#nlu-system-entities__section_f4c_gxd_lpb} { "utterance": "We should meet next Sunday at Starbucks.", "intents": [ { "intentName": "intent:Desire.Desire", "score": 0.83452, "entities": [] }, { "intentName": "intent:Meeting.MeetRequest", "score": 0.8919042, "entities": [ { "entityName": "entity:Meeting.MeetRequest.Where", "value": "Starbucks", "score": 1 }, { "entityName": "entity:GLOBAL.DATE", "value": "Sunday", "normalization": { "type": "DATE", "subType": "DAY", "value": "1999-10-01" }, "score": 0.87 } ] } ] } **관련 개념** * [도메인 분리 및 가상 에이전트](https://servicenow-prod.fluidtopics.net/qyNZ6Qcsflpq1_CiKOV7LA "도메인 분리는 가상 에이전트 애플리케이션에서 지원됩니다. 도메인 분리를 사용하여 데이터, 프로세스 및 관리 작업을 도메인이라는 논리적 그룹으로 분할할 수 있습니다. 어떤 사용자가 데이터를 보고 액세스할 수 있는지를 포함하여 이러한 분리의 여러 측면을 제어할 수 있습니다.") * [가상 에이전트 상호작용 기록](https://servicenow-prod.fluidtopics.net/14GC0hGxS3vuVi5no2lnbw "대화가 가상 에이전트 발생할 때마다 상호작용 기록은 상호작용 [interaction] 테이블에서 전체 대화를 캡처합니다. 이 기록에는 대화에 사용된 모든 주제 요소뿐만 아니라 라이브 에이전트 전송도 포함됩니다.") * [가상 에이전트 스크립트](https://servicenow-prod.fluidtopics.net/zSUuZffmmyls3weyHv~~4A "스크립트 메서드 및 변수를 사용하여 ServiceNow 가상 에이전트 응답, 트리거 및 플로우 스크립트와 같은 채팅 스크립트를 작성합니다. 변수는 실시간 지원 주제 및 대화에 대한 컨텍스트를 제공할 수도 있습니다.") **관련 참조** * [주제의 가상 에이전트 입력 데이터 유형](https://servicenow-prod.fluidtopics.net/FpTV91nNTN5uLmd5BZhmpQ "스크립트를 작성하지 않고 일반적으로 사용되는 Glide 가상 에이전트 (com.glide.cs.chatbot) 데이터 유형의 입력을 정의할 수 있습니다 가상 에이전트 디자이너 . 사용자 지정 컨트롤 또는 주제 블록의 시작 노드에서 입력 데이터 유형을 정의합니다.") * [가상 에이전트 URL 매개변수](https://servicenow-prod.fluidtopics.net/RSbZaxn5EIr407WgvD1VIw "가상 에이전트 는 관리자가 인스턴스 URL에 추가하여 페이지 컨텐츠가 렌더링되는 방식을 제어할 수 있는 다양한 시스템 매개변수를 제공합니다.") * [의 대기 시간 피드백 가상 에이전트](https://servicenow-prod.fluidtopics.net/gZXQRNujmaSqegNXTBfiKg "com.glide.cs.message.processing.enabled 이 시스템 속성은 생성형 AI LLM(대규모 언어 모델)이 웹 클라이언트 및 Now Assist 패널에서 가상 에이전트 요청을 처리할 때마다 요청자에게 알립니다.")