미리보기 API 변경 사항
이 문서에서 2024-11-01 버전부터 시작하는 새 API 변경 사항에 대한 개요를 확인하세요. 이 API 변경 사항은 주로 현재 일반 공급 API의 category 및 subcategory 필드를 대체하는 두 가지 새로운 개념(entity types 및 entity tags)을 도입합니다. 각 API 매개 변수와 이에 대응하는 지원되는 API 버전에 대한 자세한 개요는 [기술 매개 변수][../how-to/skill-parameters.md] 페이지에서 확인할 수 있습니다.
엔터티 형식
엔터티 형식은 엔터티가 검색된 가장 낮은(또는 가장 세밀한) 세분성을 나타내며 검색된 기본 클래스로 간주될 수 있습니다.
엔터티 태그
엔터티 태그는 검색된 엔터티에 엔터티 형식 및 추가 태그로 태그가 지정된 엔터티를 추가로 식별하여 식별된 엔터티를 구별하는 데 사용됩니다. 엔터티 태그 목록은 범주, 하위 범주, 하위 범주의 하위 범주 등을 포함하는 것으로 간주될 수 있습니다.
버전에서 2023-04-01 버전 2022-05-01 2024-11-01 API로 변경
변경 내용은 다음을 포함하여 명명된 엔터티 인식 서비스에 더 나은 유연성을 제공합니다.
입력 형식의 구조 업데이트: • InclusionList • ExclusionList • 중복 정책
출력 형식 처리 업데이트:
- 둘 이상의 엔터티 태그로 엔터티에 태그를 지정할 수 있는 태그 목록을 도입하여 보다 세부적인 엔터티 인식 출력을 제공합니다.
- 엔터티를 둘 이상의 엔터티 형식으로 인식할 수 있는 중복 엔터티가 있을 수 있으며, 그런 경우 이 엔터티는 두 번 반환됩니다. 엔터티가 동일한 엔터티 형식의 두 엔터티 태그에 속하는 것으로 인식되면 두 엔터티 태그가 모두 태그 목록에 반환됩니다.
- 엔터티 태그를 사용하여 엔터티를 필터링할 수 있습니다. 이 문서로 이동하여 이에 대해 자세히 알아볼 수 있습니다.
- 엔터티에 대한 추가 정보를 포함하지만 현재는 기존 엔터티 확인 기능의 래퍼 역할만 수행하는 메타데이터 개체가 있습니다. 이 새로운 기능에 대한 자세한 내용은 여기에서 확인할 수 있습니다.
버전 2022-05-01 및 2023-04-01 현재 버전 API 엔터티 매핑
지원되는 NER(명명된 엔터티 인식) 엔터티 범주 및 엔터티 형식 문서에서 엔터티 범주/형식의 구조 간 비교 내용을 볼 수 있습니다. 다음은 버전에서 예상되는 결과와 2023-04-01 현재 버전 2022-05-01 API 간의 매핑을 설명하는 표입니다.
| Type | 태그 |
|---|---|
| 날짜 | Temporal, Date |
| DateRange | Temporal, DateRange |
| DateTime | Temporal, DateTime |
| DateTimeRange | Temporal, DateTimeRange |
| 기간 | Temporal, Duration |
| SetTemporal | Temporal, SetTemporal |
| Time | Temporal, Time |
| TimeRange | Temporal, TimeRange |
| City | GPE, Location, City |
| State(상태) | GPE, Location, State |
| CountryRegion | GPE, Location, CountryRegion |
| 대륙 | GPE, Location, Continent |
| GPE | Location, GPE |
| 위치 | 위치 |
| Airport | Structural, Location |
| Structural | Location, Structural |
| Geological | Location, Geological |
| 나이 | Numeric, Age |
| 통화 | Numeric, Currency |
| 숫자 | Numeric, Number |
| PhoneNumber | PhoneNumber |
| NumberRange | Numeric, NumberRange |
| 백분율 | Numeric, Percentage |
| 서수 | Numeric, Ordinal |
| 온도 | Numeric, Dimension, Temperature |
| 속도 | Numeric, Dimension, Speed |
| 가중치 | Numeric, Dimension, Weight |
| Height | Numeric, Dimension, Height |
| Length | Numeric, Dimension, Length |
| 볼륨 | Numeric, Dimension, Volume |
| 영역 | Numeric, Dimension, Area |
| 정보 | Numeric, Dimension, Information |
| 주소 | 주소 |
| Person | Person |
| PersonType | PersonType |
| 조직 | 조직 |
| Product | Product |
| ComputingProduct | Product, ComputingProduct |
| IP | IP |
| 메일 | |
| URL | URL |
| 기술 | 기술 |
| 이벤트 | 이벤트 |
| CulturalEvent | Event, CulturalEvent |
| SportsEvent | Event, SportsEvent |
| NaturalEvent | Event, NaturalEvent |