Azure Translator в средстве Foundry версии 3.0

Что нового?

Версия 3.0 переводчика предоставляет современный веб-API на основе JSON. Она повышает удобство использования и производительность путем консолидации существующих функций в меньшее количество операций и предоставляет новые возможности.

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

Базовые URL-адреса

Глобальный базовый URL-адрес .https://api.cognitive.microsofttranslator.com Перевод текста также поддерживает географические и ресурсоемкие конечные точки. Все URL-адреса конечных точек и их расположения обработки запросов см. в разделе "Поддержка региона" для Azure Translator.

поддержка виртуальная сеть

Переводчик теперь доступен с возможностями виртуальная сеть (VNET) во всех регионах общедоступного облака Azure. Чтобы включить виртуальная сеть, SeeConfiguring Foundry Tools.

После включения этой возможности необходимо использовать пользовательскую конечную точку для вызова переводчика. Вы не можете использовать глобальную конечную точку переводчика ("api.cognitive.microsofttranslator.com") и не можете пройти проверку подлинности с помощью маркера доступа.

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

  1. Перейдите к ресурсу Переводчика на портале Azure.

  2. Выберите "Сеть" в разделе "Управление ресурсами".

  3. На вкладке "Брандмауэры и виртуальные сети " выберите выбранные сети и частные конечные точки.

    Screenshot параметра виртуальной сети на портале Azure.

  4. Нажмите кнопку Сохранить, чтобы применить изменения.

  5. Выберите ключи и конечную точку из раздела "Управление ресурсами ".

  6. Перейдите на вкладку виртуальная сеть.

  7. Перечислены конечные точки для перевода текста и перевода документов.

    Снимок экрана: конечная точка виртуальной сети.

Headers Description
Ocp-Apim-Subscription-Key Значением является ключ секрета Azure для подписки на Переводчик.
Ocp-Apim-Subscription-Region Значением является регион ресурса переводчика. Это значение является необязательным, если ресурс имеет значение global

Ниже приведен пример запроса на вызов переводчика с помощью пользовательской конечной точки

// Pass secret key and region using headers
curl -X POST "https://<your-custom-domain>.cognitiveservices.azure.com/translator/text/v3.0/translate?api-version=3.0&to=es" \
     -H "Ocp-Apim-Subscription-Key:<your-key>" \
     -H "Ocp-Apim-Subscription-Region:<your-region>" \
     -H "Content-Type: application/json" \
     -d "[{'Text':'Hello, what is your name?'}]"

Metrics

Метрики позволяют просматривать сведения об использовании переводчика и доступности на портале Azure. Дополнительные сведения см. в разделе "Метрики данных и платформы".

Метрики переводчика

В этой таблице перечислены доступные метрики с описанием того, как они используются для мониторинга вызовов API перевода.

Metrics Description
TotalCalls Общее количество вызовов API.
TotalTokenCalls Общее количество вызовов API через службу токенов с помощью маркера проверки подлинности.
Успешное масштабирование Число успешных вызовов.
TotalErrors Количество вызовов с ответом на ошибку.
Заблокированныеcalls Число вызовов, превысивших ограничение скорости или квоты.
ServerErrors Количество вызовов с внутренней ошибкой сервера (5XX).
ClientErrors Количество вызовов с ошибкой на стороне клиента (4XX).
Latency Длительность выполнения запроса в миллисекундах.
СимволыTranslated Общее количество символов во входящем текстовом запросе.
  • Last updated on