Azure AI 搜索中已弃用的认知技能
本文档介绍被视为已弃用(停用)的认知技能。 对内容使用以下指南:
- 技能名称:将要弃用的技能的名称,映射到 @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" } ] }