Поделиться через

Устаревшие когнитивные навыки в поиске ИИ Azure

  • Статья

В этом документе описываются когнитивные навыки, которые считаются устаревшими (устаревшими). Ознакомьтесь со следующими понятиями:

  • Имя навыка. Имя навыка, который станет устаревшим. Оно сопоставляется с атрибутом @odata.type.
  • Последняя доступна версия API: последняя версия общедоступного API поиска ИИ Azure, с помощью которой наборы навыков, содержащие соответствующий устаревший навык, можно создать или обновить. Индексаторы с присоединенными наборами навыков с этими навыками будут продолжать работать даже в будущих версиях API до даты окончания поддержки, в какой момент они начинают завершать сбой.
  • Окончание поддержки: на следующий день, после которого соответствующий навык считается неподдерживаемый и перестает работать. Ранее созданные наборы навыков по-прежнему будут работать, но пользователям рекомендуется прекратить их использование.
  • Рекомендации. Способ перехода для использования поддерживаемого навыка. Пользователям следует придерживаться этих рекомендаций, чтобы продолжать получать поддержку.

Если вы используете Microsoft.Skills.Text.EntityRecognitionSkill (когнитивный навык распознавания сущностей (v2)), эта статья поможет обновить набор навыков, чтобы использовать Microsoft.Skills.Text.V3.EntityRecognitionSkill , который является общедоступным и вводит новые функции.

Если вы используете Microsoft.Skills.Text.SentimentSkill (когнитивный навык тональности (версия 2)), эта статья поможет обновить набор навыков, чтобы использовать Microsoft.Skills.Text.V3.SentimentSkill , который общедоступен и предоставляет новые возможности.

Если вы используете Microsoft.Skills.Text.NamedEntityRecognitionSkill (когнитивный навык распознавания именованных сущностей (v2)), эта статья поможет обновить набор навыков, чтобы использовать Microsoft.Skills.Text.V3.EntityRecognitionSkill , который является общедоступным и вводит новые функции.

Microsoft.Skills.Text.EntityRecognitionSkill

Последняя доступная версия API

2021-04-30-Preview

End of support

31 августа 2024 г.

Рекомендации

Теперь следует использовать тип Microsoft.Skills.Text.V3.EntityRecognitionSkill. Он предоставляет большинство функций EntityRecognitionSkill более высокого качества. Он также содержит более полные сведения в составных полях выходных данных.

Чтобы перейти на Microsoft.Skills.Text.V3.EntityRecognitionSkill, внесите одно или несколько следующих изменений в определение навыка. Вы можете обновить определение навыков с помощью API обновления набора навыков.

  1. (Обязательно.) Измените @odata.type с "#Microsoft.Skills.Text.EntityRecognitionSkill" на "#Microsoft.Skills.Text.V3.EntityRecognitionSkill".

  2. (Необязательно) Параметр includeTypelessEntities больше не поддерживается, так как новый навык возвращает только сущности с известными типами, поэтому если на него ссылается предыдущее определение навыка, оно должно быть удалено.

  3. (Необязательно) Если вы используете выходные данные, есть несколько незначительных namedEntities изменений в именах свойств.

    1. value переименовывается в text
    2. 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"
        }
    ]
}

  4. (Необязательно) Если вы используете entities выходные данные для связывания сущностей с известными сущностями, эта функция теперь является новым навыком, Microsoft.Skills.Text.V3.EntityLinkingSkill. Добавьте навык связывания сущностей в свой набор навыков для создания связанных сущностей. Также присутствует несколько незначительных изменений в именах свойств выходных данных entities между EntityRecognitionSkill и новым EntityLinkingSkill.

    1. wikipediaId переименовывается в id
    2. wikipediaLanguage переименовывается в language
    3. wikipediaUrl переименовывается в url
    4. Свойства 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"
        }
    ]
}

  5. (Необязательно) Если явно не указать 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 версии 3

      {
    "@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 версии 3

      {
    "@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

End of support

31 августа 2024 г.

Рекомендации

Вместо этого используйте Microsoft.Skills.Text.V3.SentimentSkill. Он предлагает улучшенную модель и включает возможность добавления интеллектуального анализа мнений или тональности на основе аспектов. Так как этот навык характеризуется большей сложностью, выходные данные также сильно отличаются.

Чтобы перейти на Microsoft.Skills.Text.V3.SentimentSkill, внесите одно или несколько следующих изменений в определение навыка. Вы можете обновить определение навыков с помощью API обновления набора навыков.

Примечание.

Выходные данные для навыка тональности версии 3 несовместимы с определением индекса на основе SentimentSkill. Необходимо внести изменения в определение индекса, набор навыков (более поздние входные данные навыков и/или проекции хранилища знаний) и сопоставления полей выходных данных индексатора, чтобы заменить навык тональности новой версией.

  1. (Обязательно.) Измените @odata.type с "#Microsoft.Skills.Text.SentimentSkill" на "#Microsoft.Skills.Text.V3.SentimentSkill".

  2. (Обязательно) Навык тональности V3 предоставляет оценку positive, neutral и negative для всего текста и такие же оценки для каждого предложения во всем тексте, тогда как предыдущая версия SentimentSkill предусматривала только одно значение double в диапазоне от 0,0 (отрицательная) до 1,0 (положительная) для всего текста. Необходимо обновить определение индекса, чтобы принять три значения типа double вместо одной оценки, и убедиться, что все входные данные, проекции хранилища знаний и сопоставления полей выходных данных нижестоящего навыка согласуются с изменениями имени.

Рекомендуется полностью заменить старый Тональскилл на Тональскилл версии 3, обновить входные данные нижестоящего навыка, проекции хранилища знаний, сопоставления выходных полей индексатора и определение индекса, чтобы соответствовать новому формату выходных данных, и сбросить индексатор, чтобы все документы имели согласованные результаты тональности.

Примечание.

Если вам требуется дополнительная помощь в обновлении конвейера обогащения для использования последней версии навыка тональности или если сброс индексатора не является вариантом для вас, отправьте новый запрос в службу поддержки, которая сможет работать с вами напрямую.

Microsoft.Skills.Text.NamedEntityRecognitionSkill

Последняя доступная версия API

2017-11-11-Preview

End of support

31 августа 2024 г.

Рекомендации

Теперь следует использовать тип Microsoft.Skills.Text.V3.EntityRecognitionSkill. Он предоставляет большинство функций NamedEntityRecognitionSkill более высокого качества. Он также содержит более полные сведения в составных полях выходных данных.

Чтобы перейти на Microsoft.Skills.Text.V3.EntityRecognitionSkill, внесите одно или несколько следующих изменений в определение навыка. Вы можете обновить определение навыков с помощью API обновления набора навыков.

  1. (Обязательно.) Измените @odata.type с "#Microsoft.Skills.Text.NamedEntityRecognitionSkill" на "#Microsoft.Skills.Text.V3.EntityRecognitionSkill".

  2. (Необязательно) Если вы используете entities выходные данные, используйте namedEntities сложные выходные данные коллекции.EntityRecognitionSkill V3 Также присутствует несколько незначительных изменений в именах свойств комплексных выходных данных нового namedEntities.

    1. value переименовывается в text
    2. 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"
        }
    ]
}

  3. (Необязательно) Если явно не указать 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 версии 3

      {
    "@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 версии 3

      {
    "@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"
        }
    ]
}

См. также