使用本文可概覽從版本 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之間的對應關係。
| 類型 | Tags |
|---|---|
| 日期 | Temporal, Date |
| 日期範圍 | Temporal, DateRange |
| Datetime | Temporal, DateTime |
| DateTimeRange | Temporal, DateTimeRange |
| Duration | Temporal, Duration |
| SetTemporal | Temporal, SetTemporal |
| Time | Temporal, Time |
| 時間範圍 | Temporal, TimeRange |
| City | GPE、位置、城市 |
| State | GPE、位置、狀態 |
| 國家/地區 | GPE, Location, CountryRegion |
| 大陸 | GPE, Location, Continent |
| GPE | Location, GPE |
| 地點 | 地點 |
| Airport | 結構、位置 |
| Structural | 位置、結構 |
| Geological | 位置，地質 |
| Age | Numeric, Age |
| 貨幣 | 數字、貨幣 |
| Number | 數值、數位 |
| 電話號碼 | 電話號碼 |
| 數字範圍 | Numeric, NumberRange |
| 百分比 | 數值、百分比 |
| Ordinal | Numeric, Ordinal |
| 溫度 | 數值、維度、溫度 |
| 速度 | 數值、維度、速度 |
| 重量 | 數值、維度、重量 |
| 高度 | 數值、維度、高度 |
| 長度 | 數值、維度、長度 |
| 磁碟區 | 數值、維度、體積 |
| 區域 | 數值、維度、區域 |
| 資訊 | 數值、維度、資訊 |
| 位址 | 位址 |
| 個人 | 個人 |
| 人物類型 | 人物類型 |
| 組織 | 組織 |
| Products | Products |
| ComputingProduct | Product, ComputingProduct |
| IP | IP |
| URL | URL |
| 技能 | 技能 |
| 事件 | 事件 |
| 文化活動 | Event, CulturalEvent |
| 運動賽事 | Event, SportsEvent |
| NaturalEvent | Event, NaturalEvent |