Note
Foundry IQ(Azure AI 搜尋服務)提供直接的索引與查詢 API,並搭配高階知識來源與知識庫 API 用於受控檢索。 使用 Azure 入口網站、REST API 或 Azure SDK 來設定這些功能,或將代理連線到 Microsoft Foundry 入口網站 中的知識庫。
具名實體辨識技能 (v2) 會從文字中擷取具名實體。 可用的實體類型包括 person、location 與 organization。
Important
具名實體辨識技能 (v2) (Microsoft.Skills.Text.NamedEntityRecognitionSkill) 現已淘汰,並由 Microsoft.Skills.Text.V3.EntityRecognitionSkill 取代。 請依照已淘汰 Foundry IQ(Azure AI 搜尋服務)技能中的建議,遷移至支援的技能。
Note
當您透過提高處理頻率、加入更多文件或新增更多 AI 演算法來擴充範圍時,您需要附加可計費的 Microsoft Foundry 資源。 在 Foundry Tools 中呼叫 API 時,以及在 Foundry IQ 文件破解階段進行影像擷取時,會產生費用。 從文件擷取文字不會產生任何費用。 執行內建技能會依既有的 Foundry Tools Standard 定價計費。
影像擷取是 Foundry IQ 所計費的額外費用,詳見 價格頁面。 文字擷取免費。
@odata.type
Microsoft.Skills.Text.NamedEntityRecognitionSkill
資料限制
單一記錄的最大大小應為 50,000 個字元,以 String.Length 計算。 如果您需要在將資料傳送至關鍵片語擷取器之前分割資料,請考慮使用文字分割技能。 如果使用文字分割技能,請將頁面長度設定為 5000 以取得最佳效能。
技能參數
參數會區分大小寫。
| 參數名稱 | Description |
|---|---|
| categories | 應擷取的分類陣列。 可能的分類類型:"Person"、"Location"、"Organization"。 如果未提供分類,系統會傳回所有類型。 |
| defaultLanguageCode | 輸入文字的語言代碼。 支援下列語言:de, en, es, fr, it |
| minimumPrecision | 0 到 1 之間的數字。 如果精確度低於此值,系統不會傳回該實體。 預設值是 0。 |
技能輸入
| 輸入名稱 | Description |
|---|---|
| 語言代碼 | 選擇性。 預設值為 "en"。 |
| 收發簡訊 | 要分析的文字。 |
技能產出
| 輸出名稱 | Description |
|---|---|
| 人員 | 字串陣列,其中每個字串代表一個人員名稱。 |
| locations | 字串陣列,其中每個字串代表一個位置。 |
| organizations | 字串陣列,其中每個字串代表一個組織。 |
| entities | 複雜型別的陣列。 每個複雜型別包含下列欄位:
|
範例定義
{
"@odata.type": "#Microsoft.Skills.Text.NamedEntityRecognitionSkill",
"categories": [ "Person", "Location", "Organization"],
"defaultLanguageCode": "en",
"inputs": [
{
"name": "text",
"source": "/document/content"
}
],
"outputs": [
{
"name": "persons",
"targetName": "people"
}
]
}
範例輸入
{
"values": [
{
"recordId": "1",
"data":
{
"text": "This is the loan application for Joe Romero, a Microsoft employee who was born in Chile and who then moved to Australia… Ana Smith is provided as a reference.",
"languageCode": "en"
}
}
]
}
範例輸出
{
"values": [
{
"recordId": "1",
"data" :
{
"persons": [ "Joe Romero", "Ana Smith"],
"locations": ["Chile", "Australia"],
"organizations":["Microsoft"],
"entities":
[
{
"category":"person",
"value": "Joe Romero",
"offset": 33,
"confidence": 0.87
},
{
"category":"person",
"value": "Ana Smith",
"offset": 124,
"confidence": 0.87
},
{
"category":"location",
"value": "Chile",
"offset": 88,
"confidence": 0.99
},
{
"category":"location",
"value": "Australia",
"offset": 112,
"confidence": 0.99
},
{
"category":"organization",
"value": "Microsoft",
"offset": 54,
"confidence": 0.99
}
]
}
}
]
}
警告案例
如果文件的語言代碼不受支援,系統會傳回警告,且不會擷取任何實體。