목록 엔터티

  • 아티클

중요

LUIS는 2025년 10월 1일에 사용 중지되며 2023년 4월 1일부터 새 LUIS 리소스를 만들 수 없습니다. 지속적인 제품 지원 및 다국어 기능을 활용하려면 LUIS 애플리케이션을 대화 언어 이해로 마이그레이션하는 것이 좋습니다.

목록 엔터티는 동의어와 함께 일련의 고정된 폐쇄형 관련 단어를 나타냅니다. LUIS는 목록 엔터티에 대한 추가 값을 검색하지 않습니다. 권장 기능을 사용하여 현재 목록을 기준으로 권장되는 새 단어를 확인합니다. 동일한 값을 갖는 목록 엔터티가 둘 이상 있는 경우, 각 엔터티가 엔드포인트 쿼리에서 반환됩니다.

목록 엔터티는 기계 학습 엔터티가 아닙니다. 정확히 일치하는 텍스트입니다. LUIS는 모든 목록의 항목과 일치하는 항목을 응답의 엔터티로 표시합니다.

텍스트 데이터의 상태가 다음과 같은 경우 이 엔터티가 적합합니다.

  • 알려진 세트입니다.
  • 자주 변경되지 않습니다. 목록을 자주 변경해야 하거나 목록을 자체 확장하려는 경우에는 구문 목록이 향상된 단순 엔터티를 사용하는 것이 더 좋습니다.
  • 집합이 이 엔터티 형식의 최대 LUIS 경계를 초과하지 않습니다.
  • 발화의 텍스트는 대/소문자를 구분하지 않고 동의어 또는 정식 이름과 일치합니다. LUIS는 일치를 벗어나는 목록을 사용하지 않습니다. 유사 일치, 형태소 분석, 복수형 및 기타 변형은 목록 엔터티로 확인되지 않습니다. 변형을 관리하려면 선택적인 텍스트 구문이 포함된 패턴을 사용하는 것이 좋습니다.

목록 엔터티

.json을 목록 엔터티로 가져오는 예

다음과 같은 .json 형식을 사용하여 기존 목록 엔터티로 값을 가져올 수 있습니다.

[
    {
        "canonicalForm": "Blue",
        "list": [
            "navy",
            "royal",
            "baby"
        ]
    },
    {
        "canonicalForm": "Green",
        "list": [
            "kelly",
            "forest",
            "avacado"
        ]
    }
]

예제 JSON 응답

앱에 공항(Sea-tac), 공항 코드(SEA), 우편 번호(98101) 및 전화 지역 코드(206)를 사용하는 도시를 포함하여 도시 이름의 변형을 허용하는 Cities 목록이 있다고 가정합니다.

목록 항목 항목 동의어
Seattle sea-tac, sea, 98101, 206, +1
Paris cdg, roissy, ory, 75001, 1, +33

book 2 tickets to paris

이전 발화에서 paris 단어는 Cities 목록 엔터티의 일부로 paris 항목에 매핑됩니다. 목록 엔터티는 항목 동의어뿐 아니라 항목의 정규화된 이름과도 일치합니다.

  "entities": [
    {
      "entity": "paris",
      "type": "Cities",
      "startIndex": 18,
      "endIndex": 22,
      "resolution": {
        "values": [
          "Paris"
        ]
      }
    }
  ]
데이터 개체 엔터티 이름 값
목록 엔터티 Cities paris

다음 단계

엔터티에 대해 자세히 알아봅니다.