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

Статья
11/21/2024

Совет

Просто приступая к работе с языком ИИ 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.

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

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

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

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

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

См. также

Что такое язык ИИ Azure?
Руководство для разработчиков, использующих языковую службу
Сведения о предыдущих версиях API см. в следующей справочной документации.
Просмотреть примеры для текущей версии этих функций можно в следующих кратких руководствах.

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