プレビュー API の変更
この記事を使用して、2024-11-01 バージョンから始まる新しい API の変更の概要を確認します。 この API の変更では、主に、現在の一般公開 API の category フィールドと subcategory フィールドを置き換える 2 つの新しい概念 (entity types と entity tags) が導入されています。 各 API パラメータと対応するサポートされている API バージョンの詳細な概要については、[スキル パラメータ][../how-to/skill-parameters.md] ページを参照してください
エンティティ型
エンティティ型は、エンティティが検出された最も低い (または最も細かい) 細分性を表し、検出された基底クラスと見なすことができます。
エンティティ タグ
エンティティ タグは、エンティティをさらに識別するために使用されます。検出されたエンティティがエンティティの種類によってタグ付けされ、識別されたエンティティを区別するために追加のタグ付けが行われます。 エンティティ タグ リストには、カテゴリ、サブカテゴリ、サブサブカテゴリなどが含まれていると見なされます。
バージョン 2022-05-01 および 2023-04-01 からバージョン 2024-11-01 API への変更
この変更により、次のように名前付きエンティティ認識サービスの柔軟性が向上します。
入力形式の構造の更新: • InclusionList • ExclusionList • 重複ポリシー
出力形式の処理の更新:
- 複数のエンティティ タグでエンティティをタグ付けできるタグ リストを導入することによる、より詳細なエンティティ認識出力。
- エンティティが複数のエンティティ型として認識され、その場合は、このエンティティが 2 回返される重複エンティティ。 エンティティが同じエンティティ型の 2 つのエンティティ タグに属することが認識された場合、両方のエンティティ タグがタグ リストに返されます。
- エンティティタグを使用したエンティティのフィルタリングについては、この記事 を参照してください。
- エンティティに関する追加情報が含まれているが、現在は既存のエンティティ解決機能のラッパーとしてのみ機能するメタデータ オブジェクト。 この新機能の詳細については、こちらを参照してください。
バージョン 2022-05-01 および 2023-04-01 から現在のバージョン API へのエンティティ マッピング
エンティティカテゴリまたは型の構造の比較については、サポートされている固有表現認識 (NER) のエンティティ カテゴリおよびエンティティ型の記事を参照してください。 次の表は、バージョン 2022-05-01 および 2023-04-01 と現在のバージョン API のマッピングで見られる結果について示しています。
| Type | タグ |
|---|---|
| Date | 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 |
| Continent | GPE、Location、Continent |
| GPE | Location、GPE |
| 場所 | 場所 |
| 空港 | Structural、Location |
| 構造体 | Location、Structural |
| Geological (地質学) | Location、Geological |
| Age | Numeric、Age |
| Currency | Numeric、Currency |
| Number | Numeric、Number |
| 電話番号 | 電話番号 |
| NumberRange | Numeric、NumberRange |
| パーセント | Numeric、Percentage |
| Ordinal | Numeric、Ordinal |
| 気温 | Numeric、Dimension、Temperature |
| 速度 | Numeric、Dimension、Speed |
| Weight | Numeric、Dimension、Weight |
| [高さ] | Numeric、Dimension、Height |
| 長さ | Numeric、Dimension、Length |
| ボリューム | Numeric、Dimension、Volume |
| 領域 | Numeric、Dimension、Area |
| Information | Numeric、Dimension、Information |
| Address | Address |
| Person | Person |
| PersonType | PersonType |
| Organization | Organization |
| 製品 | 製品 |
| ComputingProduct | Product、ComputingProduct |
| IP | IP |
| URL | URL |
| スキル | スキル |
| Event | Event |
| CulturalEvent | Event、CulturalEvent |
| SportsEvent | Event、SportsEvent |
| NaturalEvent | Event、NaturalEvent |