エンティティ型とタグ

この記事を使用して、2024-11-01 バージョンから始まる新しい API の変更の概要を確認します。 この API の変更では、主に、現在の一般公開 API の entity types フィールドと entity tags フィールドを置き換える 2 つの新しい概念 (category と subcategory) が導入されています。 各 API パラメータと対応するサポートされている API バージョンの詳細な概要については、[スキル パラメータ][../how-to/skill-parameters.md] ページを参照してください。

“Seattle” のようなエンティティは City、GPE (地政学的エンティティ)、Location として分類できるため、type 属性を使用して、最も細かい分類 (この場合は City) を定義します。 サービス出力の tags 属性は、候補となるすべての分類 (City、GPE、Location) とそれぞれの信頼度スコアの一覧です。 型ごとに可能なタグの完全なマッピングを以下に示します。 サービス出力の metadata 属性には、エンティティに関連付けられている整数値など、エンティティに関する追加情報が含まれています。

エンティティ型

エンティティ型は、エンティティが検出された最も低い (または最も細かい) 細分性を表し、検出された基底クラスと見なすことができます。

エンティティ タグ

エンティティ タグは、エンティティをさらに識別するために使用されます。検出されたエンティティがエンティティの種類によってタグ付けされ、識別されたエンティティを区別するために追加のタグ付けが行われます。 エンティティ タグ リストには、カテゴリ、サブカテゴリ、サブサブカテゴリなどが含まれていると見なされます。

バージョン 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 のマッピングで見られる結果について示しています。