エンティティ型とタグ

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

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

エンティティの種類

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

エンティティのタグ

エンティティ タグは、エンティティの種類を示すために検出されたエンティティがタグ付けされているエンティティをさらに識別するために使用されます。 エンティティ タグの一覧には、カテゴリ、サブカテゴリ、サブサブカテゴリを含めることができます。

バージョン 2022-05-01 および 2023-04-01 からバージョン 2024-11-01 API への変更

この変更により、次のように名前付きエンティティ認識サービスの柔軟性が向上します。

入力形式の構造の更新:

• InclusionList
• ExclusionList
• 重複するポリシー

出力形式の処理の更新:

• エンティティが複数のエンティティ タグでタグ付けされるタグ リストを導入することで、より詳細なエンティティ認識の出力が得られます。
• エンティティが複数のエンティティ型として認識されうる、重複エンティティの場合、このエンティティは 2 回返されることになります。 1 つのエンティティが同じエンティティ型の 2 つのエンティティ タグに属すると認識された場合、両方のエンティティ タグがタグ リストに返されます。
• エンティティ タグを使用したエンティティのフィルター処理: 詳細については、「返されたエンティティの選択」を参照してください。
• エンティティに関する追加情報を含むが、現在は既存のエンティティ解決機能のラッパーとしてのみ機能するメタデータ オブジェクト。 この新機能の詳細については、こちらをご覧ください。

バージョン 2022-05-01 および 2023-04-01 から現在のバージョン API へのエンティティ マッピング

エンティティのカテゴリと型の構造の比較については、サポートされている固有表現認識 (NER) のエンティティ カテゴリおよびエンティティ型の記事を参照してください。 次の表に、バージョン 2022-05-01 と 2023-04-01 から予想される結果と現在のバージョン API の間のマッピングを示します。