Azure 认知搜索中已弃用的认知技能Deprecated cognitive skills in Azure Cognitive Search

本文档介绍别视为已弃用的认知技能。This document describes cognitive skills that are considered deprecated. 对内容使用以下指南:Use the following guide for the contents:

  • 技能名称:将要弃用的技能的名称,映射到 @odata.type 属性。Skill Name: The name of the skill that will be deprecated, it maps to the @odata.type attribute.
  • 最后一个可用的 API 版本:Azure 认知搜索公共 API 的最后一个版本,通过它可以创建/更新技能组,其中包含相应的已弃用技能。Last available api version: The last version of the Azure Cognitive Search public API through which skillsets containing the corresponding deprecated skill can be created/updated.
  • 结束支持:支持的最后一天,这一天过后相应的技能会被视为不受支持的技能。End of support: The last day after which the corresponding skill is considered unsupported. 以前创建的技能集应该仍然可以继续使用,但建议用户不要使用已弃用的技能。Previously created skillsets should still continue to function, but users are recommended to migrate away from a deprecated skill.
  • 建议:通过向前迁移路径来使用支持的技能。Recommendations: Migration path forward to use a supported skill. 建议用户按照建议来继续接受支持。Users are advised to follow the recommendations to continue to receive support.

Microsoft.Skills.Text.NamedEntityRecognitionSkillMicrosoft.Skills.Text.NamedEntityRecognitionSkill

最后一个可用的 API 版本Last available api version

2017-11-11-预览版2017-11-11-Preview

结束支持End of support

2019 年 2 月 15 日February 15, 2019

建议Recommendations

改用 Microsoft.Skills.Text.EntityRecognitionSkillUse Microsoft.Skills.Text.EntityRecognitionSkill instead. 它提供 NamedEntityRecognitionSkill 的大多数功能,且质量更高。It provides most of the functionality of the NamedEntityRecognitionSkill at a higher quality. 它还在复杂的输出字段中提供更丰富的信息。It also has richer information in its complex output fields.

若要迁移到实体识别技能,需对技能定义进行下述一个或多个更改。To migrate to the Entity Recognition Skill, you will have to perform one or more of the following changes to your skill definition. 可以使用更新技能集 API 更新技能定义。You can update the skill definition using the Update Skillset API.

备注

目前不支持作为概念的置信度分数。Currently, confidence score as a concept is not supported. minimumPrecision 参数存在于 EntityRecognitionSkill 上,可供将来使用,并可实现后向兼容。The minimumPrecision parameter exists on the EntityRecognitionSkill for future use and for backwards compatibility.

  1. (必需) 将 @odata.type"#Microsoft.Skills.Text.NamedEntityRecognitionSkill" 更改为 "#Microsoft.Skills.Text.EntityRecognitionSkill"(Required) Change the @odata.type from "#Microsoft.Skills.Text.NamedEntityRecognitionSkill" to "#Microsoft.Skills.Text.EntityRecognitionSkill".

  2. (可选) 若要使用 entities 输出,请改用来自 EntityRecognitionSkillnamedEntities 复杂集合输出。(Optional) If you are making use of the entities output, use the namedEntities complex collection output from the EntityRecognitionSkill instead. 可以使用技能定义中的 targetName,将它映射到名为 entities 的注释。You can use the targetName in the skill definition to map it to an annotation called entities.

  3. (可选) 如果不显式指定 categories,则除了那些受 NamedEntityRecognitionSkill 支持的类别,EntityRecognitionSkill 可能还会返回不同类型的类别。(Optional) If you do not explicitly specify the categories, the EntityRecognitionSkill can return different type of categories besides those that were supported by the NamedEntityRecognitionSkill. 如果此行为不合适,请确保将 categories 参数显式设置为 ["Person", "Location", "Organization"]If this behavior is undesirable, make sure to explicitly set the categories parameter to ["Person", "Location", "Organization"].

    示例迁移定义Sample Migration Definitions

    • 简单迁移Simple migration

      (之前)NamedEntityRecognition 技能定义(Before) NamedEntityRecognition skill definition

      {
          "@odata.type": "#Microsoft.Skills.Text.NamedEntityRecognitionSkill",
          "categories": [ "Person"],
          "defaultLanguageCode": "en",
          "inputs": [
          {
              "name": "text",
              "source": "/document/content"
          }
          ],
          "outputs": [
          {
              "name": "persons",
              "targetName": "people"
          }
          ]
      }
      

      (之后)EntityRecognition 技能定义(After) EntityRecognition skill definition

      {
          "@odata.type": "#Microsoft.Skills.Text.EntityRecognitionSkill",
          "categories": [ "Person"],
          "defaultLanguageCode": "en",
          "inputs": [
          {
              "name": "text",
              "source": "/document/content"
          }
          ],
          "outputs": [
          {
              "name": "persons",
              "targetName": "people"
          }
          ]
      }
      
    • 稍微复杂的迁移Slightly complicated migration

      (之前)NamedEntityRecognition 技能定义(Before) NamedEntityRecognition skill definition

      {
          "@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 技能定义(After) EntityRecognition skill definition

      {
          "@odata.type": "#Microsoft.Skills.Text.EntityRecognitionSkill",
          "categories": [ "Person", "Location", "Organization" ],
          "defaultLanguageCode": "en",
          "minimumPrecision": 0.1,
          "inputs": [
          {
              "name": "text",
              "source": "/document/content"
          }
          ],
          "outputs": [
          {
              "name": "persons",
              "targetName": "people"
          },
          {
              "name": "namedEntities",
              "targetName": "entities"
          }
          ]
      }
      

另请参阅See also