實體類型和標籤

使用本文可概覽從版本 2024-11-01 起的新 API 變更。 此 API 變更主要引入了兩個新概念 (entity types 和 entity tags)，以取代目前正式發行 API 中的 category 和 subcategory 欄位。 每個 API 參數及對應支援版本的詳細概述可見於 [Skill Parameters][../how-to/skill-parameters.md] 頁面。

由於像「西雅圖」這樣的實體可以分為城市、GPE（地緣政治實體）和地點，因此 type 該屬性用來定義最細緻的分類，在此案例中為城市。 服務輸出中的 tags 屬性為所有可能分類 (City、GPE、Location) 及其各自信賴度分數的清單。 會列出每個的可能標籤的完整對應。 metadata服務輸出中的屬性包含關於實體的額外資訊，例如與該實體相關的整數值。

實體類型

實體類型代表該實體被偵測到的最低（或最細）細緻度。 類型被視為被偵測到的基底類別。

實體標記

實體標籤用於進一步識別偵測到的實體，該實體被標記為實體類型。 實體標籤清單可包含類別、子類別及子子類別。

從版本 2022-05-01 與 2023-04-01 到版本 2024-11-01 API 的變更

這些變更為具名實體識別服務帶來了更好的彈性，包括：

輸入格式結構更新：

• 收錄列表
• 排除清單
• 重疊原則

輸出格式處理的更新：

• 透過引入標籤清單 (其中一個實體被標註了多個實體標籤)，提供更細緻的實體辨識輸出。
• 重疊實體，其中實體可以識別為多個實體類型，如果是這樣，則將傳回此實體兩次。 如果實體被識別為屬於同一實體類型下的兩個實體標記，則在標記清單中傳回兩個實體標記。
• 使用實體標籤篩選實體：欲了解更多， 請參閱「選擇返回實體」。
• 包含實體額外資訊的元資料物件，目前僅作為現有實體解析功能的包裝。 您可以在此處深入了解此新功能。

版本 2022-05-01 與 2023-04-01 到目前版本 API 的實體對應

您可以在支援的具名實體辨識 (NER) 實體類別和實體類型文章中看到實體類別/類型的結構之間的比較。 下表展示了從版本2022-05-01和2023-04-01預期看到的結果與目前版本API之間的對應關係。