附註
Foundry IQ(Azure AI 搜尋服務)提供直接的索引與查詢 API,並搭配高階知識來源與知識庫 API 用於受控檢索。 使用 Azure 入口網站、REST API 或 Azure SDK 來設定這些功能,或將代理程式連接到 Microsoft Foundry 入口網站中的知識庫。
本文件說明已淘汰的認知技能。 請將以下指南用於這些內容:
- 技能名稱:將被棄用的技能名稱,它會對應到@odata.type屬性。
- 最後可用 API 版本:Azure AI 搜尋服務 公開 API 的最後版本,透過此可建立或更新包含相應棄用技能的技能集。 索引子如果有附加這些技能的技能集,仍可在未來的 API 版本繼續執行,直到「終止支援」日期為止,屆時就會開始執行失敗。
- 終止支援:當天起,對應的技能將不再提供支援且會停止運作。 之前建立的技能集仍應可繼續運作,但建議使用者棄用淘汰的技能。
- 建議:遷移至使用受支援的技能之路徑。 請使用者遵循建議以繼續接收支援。
如果您使用 Microsoft.Skills.Text.EntityRecognitionSkill (實體辨識認知技能 (v2)),本文可協助您升級技能集,以便使用已正式推出且引進新功能的 Microsoft.Skills.Text.V3.EntityRecognitionSkill。
如果您使用 Microsoft.Skills.Text.SentimentSkill (情感認知技能 (v2)),本文可協助您升級技能集,以便使用已正式推出且引進新功能的 Microsoft.Skills.Text.V3.SentimentSkill。
如果您使用 Microsoft.Skills.Text.NamedEntityRecognitionSkill (具名實體辨識認知技能 (v2)),本文可協助您升級技能集,以便使用已正式推出且引進新功能的 Microsoft.Skills.Text.V3.EntityRecognitionSkill。
Microsoft.Skills.Text.EntityRecognitionSkill
最後可用的 API 版本
2021-04-30-Preview
結束支援
2024 年 8 月 31 日
建議
請改用 Microsoft.Skills.Text.V3.EntityRecognitionSkill。 它以更好的品質提供 EntityRecognitionSkill 的多數功能。 它複雜的輸出欄位也提供更豐富的資訊。
若要移轉至 Microsoft.Skills.Text.V3.EntityRecognitionSkill,請對技能定義進行下列一或多項變更。 您可以使用更新技能集 API 來更新技能定義。
(必填)將 從
"#Microsoft.Skills.Text.EntityRecognitionSkill"改@odata.type為"#Microsoft.Skills.Text.V3.EntityRecognitionSkill"。(選用)
includeTypelessEntities由於新技能只回傳已知型別的實體,因此該參數已不再支援,因此如果您先前的技能定義曾引用過它,現在應該會將其移除。(選用) 如果你使用輸出,
namedEntities屬性名稱會有一些小幅變更。-
value被重新命名為text -
confidence被重新命名為confidenceScore
如果您需要產生完全相同的屬性名稱,請新增 ShaperSkill 將輸出重新調整為所需名稱。 舉例來說,ShaperSkill 會將屬性重新命名為舊值。
{ "@odata.type": "#Microsoft.Skills.Util.ShaperSkill", "name": "NamedEntitiesShaper", "description": "NamedEntitiesShaper", "context": "/document/namedEntitiesV3", "inputs": [ { "name": "old_format", "sourceContext": "/document/namedEntitiesV3/*", "inputs": [ { "name": "value", "source": "/document/namedEntitiesV3/*/text" }, { "name": "offset", "source": "/document/namedEntitiesV3/*/offset" }, { "name": "category", "source": "/document/namedEntitiesV3/*/category" }, { "name": "confidence", "source": "/document/namedEntitiesV3/*/confidenceScore" } ] } ], "outputs": [ { "name": "output", "targetName": "namedEntities" } ] }-
(選用)如果你利用
entities輸出來將實體與知名實體連結,這項功能現在已成為一項新技能,也就是 Microsoft。Skills.Text.V3.EntityLinkingSkill。 將實體連結技能新增至技能集,可產生連結的實體。entities輸出的屬性名稱也在EntityRecognitionSkill和新的EntityLinkingSkill之間有幾項微幅變更。-
wikipediaId被重新命名為id -
wikipediaLanguage被重新命名為language -
wikipediaUrl被重新命名為url - 系統不再傳回
type和subtype屬性。
如果您需要產生完全相同的屬性名稱,請新增 ShaperSkill 將輸出重新調整為所需名稱。 舉例來說,ShaperSkill 會將屬性重新命名為舊值。
{ "@odata.type": "#Microsoft.Skills.Util.ShaperSkill", "name": "LinkedEntitiesShaper", "description": "LinkedEntitiesShaper", "context": "/document/linkedEntitiesV3", "inputs": [ { "name": "old_format", "sourceContext": "/document/linkedEntitiesV3/*", "inputs": [ { "name": "name", "source": "/document/linkedEntitiesV3/*/name" }, { "name": "wikipediaId", "source": "/document/linkedEntitiesV3/*/id" }, { "name": "wikipediaLanguage", "source": "/document/linkedEntitiesV3/*/language" }, { "name": "wikipediaUrl", "source": "/document/linkedEntitiesV3/*/url" }, { "name": "bingId", "source": "/document/linkedEntitiesV3/*/bingId" }, { "name": "matches", "source": "/document/linkedEntitiesV3/*/matches" } ] } ], "outputs": [ { "name": "output", "targetName": "entities" } ] }-
(選用) 如果您未明確指定
categories,則EntityRecognitionSkill V3可回傳除先前支援EntityRecognitionSkill的類別外的不同類型。 如果您不需要此行為,請務必將categories參數明確設為["Person", "Location", "Organization", "Quantity", "Datetime", "URL", "Email"]。範例遷移定義
簡易移轉
(之前)EntityRecognition 技能定義
{ "@odata.type": "#Microsoft.Skills.Text.EntityRecognitionSkill", "categories": [ "Person" ], "defaultLanguageCode": "en", "inputs": [ { "name": "text", "source": "/document/content" } ], "outputs": [ { "name": "persons", "targetName": "people" } ] }(之後)EntityRecognition 技能 V3 定義
{ "@odata.type": "#Microsoft.Skills.Text.V3.EntityRecognitionSkill", "categories": [ "Person" ], "defaultLanguageCode": "en", "inputs": [ { "name": "text", "source": "/document/content" } ], "outputs": [ { "name": "persons", "targetName": "people" } ] }複雜移轉
(之前)EntityRecognition 技能定義
{ "@odata.type": "#Microsoft.Skills.Text.EntityRecognitionSkill", "categories": [ "Person", "Location", "Organization" ], "defaultLanguageCode": "en", "minimumPrecision": 0.1, "includeTypelessEntities": true, "inputs": [ { "name": "text", "source": "/document/content" } ], "outputs": [ { "name": "persons", "targetName": "people" }, { "name": "namedEntities", "targetName": "namedEntities" }, { "name": "entities", "targetName": "entities" } ] }(之後)EntityRecognition 技能 V3 定義
{ "@odata.type": "#Microsoft.Skills.Text.V3.EntityRecognitionSkill", "categories": [ "Person", "Location", "Organization" ], "defaultLanguageCode": "en", "minimumPrecision": 0.1, "inputs": [ { "name": "text", "source": "/document/content" } ], "outputs": [ { "name": "persons", "targetName": "people" }, { "name": "namedEntities", "targetName": "namedEntitiesV3" } ] }, { "@odata.type": "#Microsoft.Skills.Util.ShaperSkill", "name": "NamedEntitiesShaper", "description": "NamedEntitiesShaper", "context": "/document/namedEntitiesV3", "inputs": [ { "name": "old_format", "sourceContext": "/document/namedEntitiesV3/*", "inputs": [ { "name": "value", "source": "/document/namedEntitiesV3/*/text" }, { "name": "offset", "source": "/document/namedEntitiesV3/*/offset" }, { "name": "category", "source": "/document/namedEntitiesV3/*/category" }, { "name": "confidence", "source": "/document/namedEntitiesV3/*/confidenceScore" } ] } ], "outputs": [ { "name": "output", "targetName": "namedEntities" } ] }, { "@odata.type": "#Microsoft.Skills.Text.V3.EntityLinkingSkill", "defaultLanguageCode": "en", "minimumPrecision": 0.1, "inputs": [ { "name": "text", "source": "/document/content" } ], "outputs": [ { "name": "entities", "targetName": "linkedEntities" } ] }, { "@odata.type": "#Microsoft.Skills.Util.ShaperSkill", "name": "LinkedEntitiesShaper", "description": "LinkedEntitiesShaper", "context": "/document/linkedEntitiesV3", "inputs": [ { "name": "old_format", "sourceContext": "/document/linkedEntitiesV3/*", "inputs": [ { "name": "name", "source": "/document/linkedEntitiesV3/*/name" }, { "name": "wikipediaId", "source": "/document/linkedEntitiesV3/*/id" }, { "name": "wikipediaLanguage", "source": "/document/linkedEntitiesV3/*/language" }, { "name": "wikipediaUrl", "source": "/document/linkedEntitiesV3/*/url" }, { "name": "bingId", "source": "/document/linkedEntitiesV3/*/bingId" }, { "name": "matches", "source": "/document/linkedEntitiesV3/*/matches" } ] } ], "outputs": [ { "name": "output", "targetName": "entities" } ] }
Microsoft.Skills.Text.SentimentSkill
最後可用的 API 版本
2021-04-30-Preview
結束支援
2024 年 8 月 31 日
建議
請改用 Microsoft.Skills.Text.V3.SentimentSkill。 它提供改良的模型,且包含的選項可供您新增意見挖掘或以層面為基礎的情感。 由於技能更為複雜,輸出也大不相同。
若要移轉至 Microsoft.Skills.Text.V3.SentimentSkill,請對技能定義進行下列一或多項變更。 您可以使用更新技能集 API 來更新技能定義。
附註
Sentiment Skill V3 的技能輸出與基於 SentimentSkill 的索引定義不相容。 您需要修改索引定義、技能組(包括後續的技能輸入和/或知識庫預測)以及索引器的輸出欄位映射,以用新版本替代情感技能。
(必填)將 從
"#Microsoft.Skills.Text.SentimentSkill"改@odata.type為"#Microsoft.Skills.Text.V3.SentimentSkill"。(必填) Sentiment Skill V3 為整體文本提供
positive、 、neutral和negative的分數,且對整體文本中的每一句話給予相同的分數;而先前的 SentimentSkill 僅提供一個雙重分數,範圍從 0.0(負)到 1.0(正)不等。 你必須更新索引定義,接受三個雙重值取代單一分數,並確保所有下游技能輸入、知識庫投影和輸出欄位映射都與命名變更一致。
建議您以 SentimentSkill V3 完全取代舊的 SentimentSkill、更新下游技能輸入、知識存放區預測、索引子輸出欄位對應和索引定義,以符合新的輸出格式,並重設索引子,讓之後所有文件都有一致的情感結果。
附註
如果您需要更多協助來更新擴充管線,以便使用最新版本的情感分析功能,或者無法重設索引子,請開啟新的支援請求,讓我們直接與您合作。
Microsoft.Skills.Text.NamedEntityRecognitionSkill
最後可用的 API 版本
2017-11-11-Preview
結束支援
2024 年 8 月 31 日
建議
請改用 Microsoft.Skills.Text.V3.EntityRecognitionSkill。 它以更好的品質提供 NamedEntityRecognitionSkill 的多數功能。 它複雜的輸出欄位也提供更豐富的資訊。
若要移轉至 Microsoft.Skills.Text.V3.EntityRecognitionSkill,請對技能定義進行下列一或多項變更。 您可以使用更新技能集 API 來更新技能定義。
(必填)將 從
"#Microsoft.Skills.Text.NamedEntityRecognitionSkill"改@odata.type為"#Microsoft.Skills.Text.V3.EntityRecognitionSkill"。(選用) 如果你使用輸出,
entities請改用namedEntities來自EntityRecognitionSkill V3Complex 集合的輸出。 新的namedEntities複雜輸出的屬性名稱有幾項微幅變更:-
value被重新命名為text -
confidence被重新命名為confidenceScore
如果您需要產生完全相同的屬性名稱,請新增 ShaperSkill 將輸出重新調整為所需名稱。 舉例來說,ShaperSkill 會將屬性重新命名為舊值。
{ "@odata.type": "#Microsoft.Skills.Util.ShaperSkill", "name": "NamedEntitiesShaper", "description": "NamedEntitiesShaper", "context": "/document/namedEntities", "inputs": [ { "name": "old_format", "sourceContext": "/document/namedEntities/*", "inputs": [ { "name": "value", "source": "/document/namedEntities/*/text" }, { "name": "offset", "source": "/document/namedEntities/*/offset" }, { "name": "category", "source": "/document/namedEntities/*/category" }, { "name": "confidence", "source": "/document/namedEntities/*/confidenceScore" } ] } ], "outputs": [ { "name": "output", "targetName": "entities" } ] }-
(選用) 如果您未明確指定
categories,則EntityRecognitionSkill V3可回傳NamedEntityRecognitionSkill除 。 如果您不需要此行為,請務必將categories參數明確設為["Person", "Location", "Organization"]。範例遷移定義
簡易移轉
(之前)NamedEntityRecognition 技能定義
{ "@odata.type": "#Microsoft.Skills.Text.NamedEntityRecognitionSkill", "categories": [ "Person" ], "defaultLanguageCode": "en", "inputs": [ { "name": "text", "source": "/document/content" } ], "outputs": [ { "name": "persons", "targetName": "people" } ] }(之後)EntityRecognition 技能 V3 定義
{ "@odata.type": "#Microsoft.Skills.Text.V3.EntityRecognitionSkill", "categories": [ "Person" ], "defaultLanguageCode": "en", "inputs": [ { "name": "text", "source": "/document/content" } ], "outputs": [ { "name": "persons", "targetName": "people" } ] }稍微複雜的移轉
(之前)NamedEntityRecognition 技能定義
{ "@odata.type": "#Microsoft.Skills.Text.NamedEntityRecognitionSkill", "defaultLanguageCode": "en", "minimumPrecision": 0.1, "inputs": [ { "name": "text", "source": "/document/content" } ], "outputs": [ { "name": "persons", "targetName": "people" }, { "name": "entities" } ] }(之後)EntityRecognition 技能 V3 定義
{ "@odata.type": "#Microsoft.Skills.Text.V3.EntityRecognitionSkill", "categories": [ "Person", "Location", "Organization" ], "defaultLanguageCode": "en", "minimumPrecision": 0.1, "inputs": [ { "name": "text", "source": "/document/content" } ], "outputs": [ { "name": "persons", "targetName": "people" }, { "name": "namedEntities" } ] }, { "@odata.type": "#Microsoft.Skills.Util.ShaperSkill", "name": "NamedEntitiesShaper", "description": "NamedEntitiesShaper", "context": "/document/namedEntities", "inputs": [ { "name": "old_format", "sourceContext": "/document/namedEntities/*", "inputs": [ { "name": "value", "source": "/document/namedEntities/*/text" }, { "name": "offset", "source": "/document/namedEntities/*/offset" }, { "name": "category", "source": "/document/namedEntities/*/category" }, { "name": "confidence", "source": "/document/namedEntities/*/confidenceScore" } ] } ], "outputs": [ { "name": "output", "targetName": "entities" } ] }