具名實體辨識認知技能 (v2)

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 複雜型別的陣列。 每個複雜型別包含下列欄位:
  • category ("person"、"organization" 或 "location")
  • value (實際的實體名稱)
  • offset (在文字中找到的位置)
  • confidence (介於 0 到 1 之間的值,表示該值為實際實體的信心程度)

範例定義

  {
    "@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
          }
        ]
      }
    }
  ]
}

警告案例

如果文件的語言代碼不受支援,系統會傳回警告,且不會擷取任何實體。

另請參閱