NLU 시스템 엔터티

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 10분

    • 전역으로 정의된 NLU 엔터티를 사용하여 대화에서 추출할 수 있는 가상 에이전트 시스템 정보를 식별합니다. 엔터티를 주제에 대한 "노드리스" 입력 변수로 정의할 수 있습니다. 이러한 변수는 서비스 제공자 예측에서 NLU 슬롯으로 채워지거나 항목의 범위 밖에서 제공될 수 있습니다.

    시스템 엔터티는 기본적으로 모델에서 활성화됩니다 NLU . 의 모델 엔터티 탭에서 NLU 워크벤치볼 수 있습니다.

    글로벌. DATE 시스템 엔터티

    DAY SubType은 특정 날짜까지 정확한 날짜 문자열을 반환합니다.

    표 1. 글로벌. DATE 하위 유형 = DAY 사용량
    사용량 예제
    형식 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"
}

    WEEK SubType은 연도의 특정 주의 날짜 문자열을 반환합니다.

    표 2. 글로벌. DATE SubType = WEEK 사용량
    사용량 예제
    형식 YYYY'W'WW
    정규 표현식 \\d\\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"}
}

    MONTH SubType은 연도의 특정 월의 날짜 문자열을 반환합니다.

    표 3. 글로벌. DATE SubType = MONTH 사용량
    사용량 예제
    형식 YYYY'M'MM
    정규 표현식 \\d\\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"}
}

    YEAR SubType은 특정 연도의 날짜 문자열을 반환합니다.

    표 4. 글로벌. DATE SubType = YEAR 사용량
    사용량 예제
    형식 YYYY
    정규 표현식 \\d\\d\\d\\d\\d
    입력 예시 스미스 씨는 1999년에 떠났다.
    정규화된 값 1999
    코드 예시 
    {
"name": "entity:GLOBAL.DATE",
"value": "...",
"score": 1.0,
"normalization": {"type": "GLOBAL.DATE", "subType": "YEAR", "value": "1999"}
}

    SEASON SubType은 연중 특정 계절의 날짜 문자열을 반환합니다.

    표 5. 글로벌. DATE SubType = SEASON 사용량
    사용량 예제
    형식 다음 중 하나입니다.
    • 겨울: YYYYWI
    • 봄: YYYYSP
    • 여름: YYYYSU
    • 가을: YYYYFA
    정규 표현식 다음 중 하나입니다.
    • 겨울: \\d\\d\\d\\d\\dWI
    • 스프링: \\d\\d\\d\\d\\dSP
    • 여름: \\d\\d\\d\\d\\dSU
    • 가을: \\d\\d\\d\\d\\dFA
    입력 예시 스미스 씨는 1999년 가을에 떠났다.
    정규화된 값 1999FA
    코드 예시 
    {
"name": "entity:GLOBAL.DATE",
"value": "...",
"score": 1.0,
"normalization": {"type": "GLOBAL.DATE", "subType": "SEASON", "value": "1999FA"}
}

    글로벌. TIME 시스템 엔터티

    TIME SubType은 시간과 분까지 정확한 시간 문자열을 반환합니다.

    표 6. 글로벌. TIME 하위 유형 = TIME 사용량
    사용량 예제
    형식 '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"}
}

    PARTSOFDAY SubType은 하루의 일부를 지정하는 시간 문자열을 반환합니다.

    표 7. 글로벌. TIME SubType = PARTSOFDAY 사용량
    사용량 예제
    형식 다음 중 하나입니다.
    • 오전: TMO
    • 오후: TAF
    • 저녁: TEV
    • 야간: TNI
    정규 표현식 다음 중 하나입니다.
    • 오전: TMO
    • 오후: TAF
    • 저녁: TEV
    • 야간: TNI
    입력 예시 스미스 씨는 아침에 떠났다.
    정규화된 값 TMO (영어)
    코드 예시 
    {
"name": "entity:GLOBAL.TIME", 
"value": "...",
"score": 1.0, 
"normalization": {"type": "GLOBAL.TIME", "subType": "PARTSOFDAY", "value": "TMO"}
}

    글로벌. DATE_TIME 시스템 엔터티

    DATE_TIME SubType은 특정 날짜에 대해 정확한 날짜 문자열과 시간 및 분까지 정확한 시간 문자열을 반환합니다.

    표 8. 글로벌. DATE_TIME SubType = DATETIME 사용량
    사용량 예제
    형식 YYYY-MM-DD'T'HH:mm
    정규 표현식 \\d\\d\\d\\d\\d-\\d\\d-\\d\\d\\dT\\d\\d\\d:\\d\\d
    입력 예시 스미스 씨는 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"
}

    글로벌. DURATION 시스템 엔터티

    이 엔터티는 활동 기간을 지정하는 기간 문자열을 반환합니다.

    표 9. 글로벌. DURATION 사용량
    사용량 예제
    형식 다음 중 하나입니다.
    • 두 번째: 's'ss
    • 분: 'm'mm
    • 시간: 'h'hh
    • 주: 'D'DD
    • 주: 'W'WW
    • 월: 'M'MM
    • 연도: 'Y'YY
    정규 표현식 다음 중 하나입니다.
    • 둘째: s\\d\\d
    • 분: m\\d\\d
    • 시간: h\\d\\d
    • 일: D\\d\\d
    • 주: W\\d\\d
    • 월: M\\d\\d
    • 연도: Y\\d\\d
    입력 예시 스미스 씨는 보스턴에 48시간 동안 머물렀다.
    정규화된 값 h48
    코드 예시 
    {
"name": "entity:GLOBAL.DURATION",
"value": "...", 
"score": 1.0,
"normalization": {"type": "GLOBAL.DURATION", "value": "h48"}
}

    글로벌. 위치 시스템 엔터티

    이 엔터티는 위치 문자열을 반환합니다.

    표 10. 글로벌. 위치 사용량
    사용량 예제
    형식 문자열 값입니다. 예: 산타클라라
    정규 표현식 해당 사항 없음.
    입력 예시 스미스 씨는 산타클라라에서 일합니다.
    정규화된 값 산타클라라
    코드 예시 
    {
"name": "entity:GLOBAL.LOCATION",
"value": "...", 
"score": 1.0,
"normalization": {"type": "GLOBAL.LOCATION", "value":"Santa Clara"}
}

    글로벌. PERSON 시스템 엔터티

    이 엔터티는 이름 문자열을 반환합니다.

    사용량 예제
    형식 문자열 값입니다. 예: Joe Smith
    정규 표현식 해당 사항 없음.
    입력 예시 Joe Smith는 산타클라라에서 일합니다.
    정규화된 값 조 스미스
    코드 예시 
    {
"name": "entity:GLOBAL.PERSON", 
"value": "...",
"score": 1.0, 
"normalization": {"type": "GLOBAL.PERSON", "value":"Joe Smith"}
}

    글로벌. MONEY 시스템 엔터티

    이 엔터티는 통화 문자열을 반환합니다.

    표 11. 글로벌. MONEY 사용량
    사용량 예제
    형식 문자열 값입니다. 예: USD 2000
    정규 표현식 해당 사항 없음.
    입력 예시 $2000 미만의 노트북을 보여주세요.
    정규화된 값 미화 2,000달러
    주:
    정규화된 값은 소스 통화의 세 글자 ISO 3166 국가 코드를 사용합니다.
    코드 예시 
    {
"name": "entity:GLOBAL.MONEY", 
"value": "...",
"score": 1.0, 
"normalization": {"type": "GLOBAL.MONEY", "value":"2000", “currency”:”USD”}
}

    글로벌. NUMBER 시스템 엔터티

    이 엔터티는 숫자를 반환합니다.

    사용량 예제
    형식 문자열 값입니다. 예: 5.0
    정규 표현식 해당 사항 없음.
    입력 예시 내 계정의 이전 5개 거래를 보고 싶습니다.
    정규화된 값 5.0
    코드 예시 
    {
"name": "entity:GLOBAL.NUMBER",
  "value": "...",
  "score": 1.0,
  "normalization": {"numericValue":"5", “normalizedValue”: “5”}
}

    글로벌. 소프트웨어

    소프트웨어 문자열을 반환합니다.

    사용량 예제
    형식 문자열 값입니다. 예: Java
    정규 표현식 해당 사항 없음.
    입력 예시 Java는 어떻게 설치합니까?
    정규화된 값 Java
    코드 예시 
    {
  "name": "entity:GLOBAL.SOFTWARE",
  "value": "Java",
  "score": 0.99930537,
  "normalization": {"type":"entity:GLOBAL.SOFTWARE",
                     "subType":"SOFTWARE",
                     "value":"Java"}
}

    글로벌. 하드웨어

    하드웨어 문자열을 반환합니다.

    사용량 예제
    형식 문자열 값입니다. 예: 프린터
    정규 표현식 해당 사항 없음.
    입력 예시 프린터는 어떻게 주문합니까?
    정규화된 값 printer
    코드 예시 
    {
  "name": "entity:GLOBAL.HARDWARE",
  "value": "printer",
  "score": 1.0,
  "normalization": {"type":"entity:GLOBAL.HARDWARE",
                     "subType":"HARDWARE",
                     "value":"printer"}
}

    소프트웨어 시스템 엔터티를 사용한 예측 결과 예 NLU

    {"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

    {
    "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
                }
            ]
        }
    ]
}