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

Устаревшие когнитивные навыки в поиске ИИ 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

Окончание поддержки

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

Окончание поддержки

31 августа 2024 г.

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

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

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

Примечание.

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

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

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

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

Примечание.

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

Microsoft.Skills.Text.NamedEntityRecognitionSkill

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

2017-11-11-Preview

Окончание поддержки

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

См. также

  • Last updated on