Переход на последнюю версию языка ИИ Azure

  • Статья

Совет

Только приступая к работе с языком ИИ Azure? Дополнительные сведения о службе и доступных функциях, а также ссылки на краткие руководства с информацией о текущей версии API см. в обзорной статье.

Если в ваших приложениях по-прежнему используется API Анализ текста или клиентская библиотека (до стабильной версии 5.1.0), эта статья поможет вам обновить приложения для использования последней версии функций языка ИИ Azure.

Единая конечная точка для языковой службы (REST API)

Этот раздел относится к приложениям, которые используют старый формат конечной точки /text/analytics/... для вызовов REST API. Пример:

https://<your-custom-subdomain>.cognitiveservices.azure.com/text/analytics/<version>/<feature>

Если приложение использует указанный выше формат конечной точки, обратите внимание, что конечная точка REST API для следующих функций языковой службы изменилась:

Языковая служба теперь предоставляет единую конечную точку для отправки запросов REST API к этим функциям. Если приложение использует REST API, обновите его конечную точку запроса, чтобы использовать текущую конечную точку:

https://<your-language-resource-endpoint>/language/:analyze-text?api-version=2022-05-01

Кроме того, изменился формат текста запроса JSON. Вам потребуется обновить структуру запросов, которые ваше приложение отправляет в API, например следующий текст JSON для распознавания сущностей:

{
    "kind": "EntityRecognition",
    "parameters": {
        "modelVersion": "latest"
    },
    "analysisInput":{
        "documents":[
            {
                "id":"1",
                "language": "en",
                "text": "I had a wonderful trip to Seattle last week."
            }
        ]
    }
}

Используйте приведенные выше краткие руководства, чтобы просмотреть текущие примеры вызовов REST API для используемых функций и связанные выходные данные API.

Клиентские библиотеки

Чтобы использовать последнюю версию клиентской библиотеки, необходимо скачать пакет программного обеспечения последней версии в пространстве имен Azure.AI.TextAnalytics. Пример кода и инструкции по использованию клиентской библиотеки на предпочитаемом языке см. в кратких руководствах, доступных по указанным выше ссылкам.

Изменения функциональных возможностей версии 2.1

При переносе приложений из API версии 2.1 необходимо учесть несколько изменений функциональных возможностей.

Анализ тональности версии 2.1

Анализ тональности в версии 2.1 возвращает баллы тональности в диапазоне от 0 до 1 для каждого документа, отправленного в API, с оценками ближе к 1, что означает более положительную тональность. Текущая версия функции возвращает метки тональности (например, "положительная" или "отрицательная") как для предложений, так и для документа в целом и связанных с ним оценок достоверности.

NER, PII и связывание сущностей в версии 2.1

В API Анализа текста версии 2.1 использовалась одна конечная точка для распознавания именованных сущностей (NER) и связывания сущностей. В текущей версии этой функции используется расширенное распознавание именованных сущностей и отдельные конечные точки для запросов NER и связывания сущностей. Кроме того, можно использовать другую функцию, предлагаемую в языковой службе, которая позволяет обнаруживать персональные данные (PII) и медицинскую информацию (PHI).

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

Категории сущностей версии 2.1

В следующей таблице перечислены категории возвращаемых сущностей для распознавания именованных сущностей версии 2.1.

Категория Описание
Человек Имена людей.
Расположение Естественные и человеческие ориентиры, структуры, географические функции и геофункциональные объекты
План Компании, неправительственные группы, музыкальные группы, спортивные клубы, государственные органы и "общественные организации". Национальности и религии в этот тип сущности не входят.
PhoneNumber Номера телефонов (только для телефонных номеров в США и Европе).
Адрес электронной почты Адреса электронной почты.
URL-адрес URL-адреса веб-сайтов.
IP-адрес Сетевые IP-адреса.
Дата и время Дата и время суток.
Дата Календарные даты.
Время Время суток
Диапазон дат Диапазоны дат.
Диапазон времени Диапазоны времени.
Duration Длительности.
Присвойте параметру Набор, повторяющиеся промежутки времени.
Количество Числа и числовые величины.
Число числа.
Процент Проценты.
Порядковый номер Порядковые номера.
возраст; Возрасты.
Валюта Местные валюты.
Измерение Измерения.
температура; Температуры.

Распознавание языка в версии 2.1

В текущей версии изменились выходные данные функции распознавания языка. Ответ JSON будет содержать ConfidenceScore вместо score. В текущей версии также возвращается только один язык для каждого документа.

Извлечение ключевых фраз в версии 2.1

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

См. также