Azure AI 搜索中已弃用的认知技能

项目
10/21/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)），则阅读本文可帮助你了解如何升级技能组以使用 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。将实体链接技能添加到技能组以生成链接实体。 EntityRecognitionSkill 和新的 EntityLinkingSkill 之间的 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 更新技能定义。

注意

情绪技能 V3 的技能输出与基于 SentimentSkill 的索引定义不兼容。必须对索引定义、技能组（后续的技能输入和/或知识存储预测）和索引器输出字段映射进行更改，将情绪技能替换为新版本。

（必需）将 @odata.type 从 "#Microsoft.Skills.Text.SentimentSkill" 更改为 "#Microsoft.Skills.Text.V3.SentimentSkill"。
（必填）情绪技能 V3 对整体文本提供 positive、neutral、negative 评分，并对整体文本中的每个语句都提供相同的评分，而先前的 SentimentSkill 仅对整体文本提供一个双精度值，范围从 0.0（负）到 1.0（正）。需更新索引定义以接受三个双精度值，而不是单个分数，并确保所有下游技能输入、知识存储预测和输出字段映射与命名更改一致。

建议完全将旧的 SentimentSkill 替换为 SentimentSkill V3，更新下游技能输入、知识存储投影、索引器输出字段映射和索引定义以匹配新的输出格式，并重置索引器，以使所有文档在以后都具有一致的情绪结果。

注意

如果需要任何其他帮助来更新扩充管道以使用最新版的情绪技能，或者如果不想要重置索引器，请提交新的支持请求，我们可以通过该请求直接与你沟通。

Microsoft.Skills.Text.NamedEntityRecognitionSkill

最后一个可用的 API 版本

2017-11-11-预览版

结束支持

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 输出，请改用来自 EntityRecognitionSkill V3 的 namedEntities 复杂集合输出。新的 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 版本

结束支持

建议

另请参阅

其他资源