Note
Azure AI 搜尋服務 可透過 Azure 入口網站、REST API 及 Azure SDK 取得。 它同時也是 Foundry IQ 的基礎，這是一個管理式知識層，能將企業內容轉化為可重複使用、權限感知的知識庫，供 Microsoft Foundry 入口網站中的代理使用。
關鍵 詞萃取 技能會評估非結構化文字，並對每個記錄回傳一個關鍵詞彙清單。 此技能使用Azure Language in Foundry Tools提供的關鍵短語機器學習模型。
如果你需要快速辨識紀錄中的主要論點，這項功能非常有用。 例如，輸入文字「食物很好吃，員工也很棒」，服務系統會回傳「食物」和「優秀的員工」。
Note
此技能綁定於 Foundry Tools，且每日每位索引器處理超過 20 份文件的交易，需 提供可計費資源 。 內建技能的執行依現有 的 Foundry Tools 標準價格收費。
@odata.type
Microsoft.Skills.Text.KeyPhraseExtractionSkill
資料限制
記錄的最大大小應為 50,000 字元，以 為單位。String.Length 如果你需要在將資料拆分後再送給關鍵字萃取器，可以考慮使用 文字分割技能。 如果你用文字分割技能，建議將頁面長度設為 5000，這樣效能會更好。
技能參數
參數依大小寫區分。
| 輸入 | Description |
|---|---|
defaultLanguageCode |
（可選）語言代碼適用於未明確指定語言的文件。 如果沒有指定預設語言代碼，則會使用英語（en）作為預設語言代碼。 請參閱 完整支援語言清單。 |
maxKeyPhraseCount |
（可選）產生最多關鍵詞數量。 |
modelVersion |
（可選）指定呼叫關鍵詞 API 時所使用的 模型版本 。 未指定時會預設使用最新的可用資料。 我們建議除非必要，否則不要指定這個數值。 |
技能輸入
| 輸入 | Description |
|---|---|
text |
待分析的文本。 |
languageCode |
一串字串表示記錄的語言。 若未指定此參數，則使用預設語言代碼來分析紀錄。 請參閱 完整支援語言清單。 |
技能產出
| Output | Description |
|---|---|
keyPhrases |
從輸入文本中提取的關鍵詞彙清單。 關鍵詞彙依重要性排序回傳。 |
範例定義
考慮一個包含以下欄位的 SQL 記錄：
{
"content": "Glaciers are huge rivers of ice that ooze their way over land, powered by gravity and their own sheer weight. They accumulate ice from snowfall and lose it through melting. As global temperatures have risen, many of the world’s glaciers have already started to shrink and retreat. Continued warming could see many iconic landscapes – from the Canadian Rockies to the Mount Everest region of the Himalayas – lose almost all their glaciers by the end of the century.",
"language": "en"
}
那麼你的技能定義可能會是這樣：
{
"@odata.type": "#Microsoft.Skills.Text.KeyPhraseExtractionSkill",
"inputs": [
{
"name": "text",
"source": "/document/content"
},
{
"name": "languageCode",
"source": "/document/language"
}
],
"outputs": [
{
"name": "keyPhrases",
"targetName": "myKeyPhrases"
}
]
}
範例輸出
在前面的例子中，你的技能輸出會寫入豐富樹中一個新節點，稱為「document/myKeyPhrases」，因為我們指定了這個 targetName 節點。 如果你沒指定 ， targetName那就是「document/keyPhrases」。
document/myKeyPhrases
[
"world’s glaciers",
"huge rivers of ice",
"Canadian Rockies",
"iconic landscapes",
"Mount Everest region",
"Continued warming"
]
你可以用「document/myKeyPhrases」作為其他技能的輸入，或作為 輸出欄位映射的來源。
Warnings
如果你提供不支援的語言代碼，會產生警告，關鍵字不會被擷取。 若文字為空，則會產生警告。 若文字超過 50,000 字元，僅分析前 50,000 字元並發出警告。