Azure AI 搜尋服務已淘汰的認知技能

附註

Azure AI 搜尋服務可透過 Azure 入口網站、REST API 及 Azure SDK 取得。它同時也是 Foundry IQ 的基礎，這是一個管理式知識層，能將企業內容轉化為可重複使用、權限感知的知識庫，供 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 來更新技能定義。

(必要) 將 @odata.type 從 "#Microsoft.Skills.Text.EntityRecognitionSkill" 變更為 "#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 的索引定義不相容。您需要修改索引定義、技能組（包括後續的技能輸入和/或知識庫預測）以及索引器的輸出欄位映射，以用新版本替代情感技能。

(必要) 將 @odata.type 從 "#Microsoft.Skills.Text.SentimentSkill" 變更為 "#Microsoft.Skills.Text.V3.SentimentSkill"。
(必要) 情感技能 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 來更新技能定義。

(必要) 將 @odata.type 從 "#Microsoft.Skills.Text.NamedEntityRecognitionSkill" 變更為 "#Microsoft.Skills.Text.V3.EntityRecognitionSkill"。

(可選) 如果您要使用 entities 輸出，請改用 namedEntities 的 EntityRecognitionSkill V3 複雜集合輸出。新的 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"
        }
    ]
}

另請參閱

意見反應

此頁面對您有幫助嗎？

Last updated on 2026-07-03

Azure AI 搜尋服務已淘汰的認知技能

Microsoft.Skills.Text.EntityRecognitionSkill

最後可用的 API 版本

結束支援

建議

Microsoft.Skills.Text.SentimentSkill

最後可用的 API 版本

結束支援

建議

Microsoft.Skills.Text.NamedEntityRecognitionSkill

最後可用的 API 版本

結束支援

建議

另請參閱

意見反應

其他資源