Azure AI 搜尋中已被取代的認知技能

發行項
09/01/2024

本文件說明被視為已淘汰的認知技能（已淘汰）。針對內容使用下列指南：

技能名稱：即將淘汰的技能名稱;它會對應至 @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）命名實體辨識認知技能（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。將實體連結技能新增至您的技能集，以產生連結的實體。在與新的 EntityLinkingSkill之間EntityRecognitionSkill，輸出的屬性名稱entities也有一些次要變更。

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類別之外，也可以EntityRecognitionSkill V3傳回不同類型的類別。如果不需要此行為，請務必將參數明確設定 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，除了支援的NamedEntityRecognitionSkill類別之外，也可以EntityRecognitionSkill V3傳回不同類型的類別。如果不需要此行為，請務必將參數明確設定 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"
        }
    ]
}

共用方式為

Azure AI 搜尋中已被取代的認知技能

Microsoft.Skills.Text.EntityRecognitionSkill

上次可用的 API 版本

結束支援

建議

Microsoft.Skills.Text.SentimentSkill

上次可用的 API 版本

結束支援

建議

Microsoft.Skills.Text.NamedEntityRecognitionSkill

上次可用的 API 版本

結束支援

建議

另請參閱

意見反應

其他資源