Что такое перевод документов Azure Translator?

Перевод документов — это облачная функция машинного перевода Azure Translator в Foundry Tools. Перевод нескольких и сложных документов на всех поддерживаемых языках и диалектах при сохранении исходной структуры документов и формата данных. API перевода документов поддерживает два процесса перевода:

• Асинхронный пакетный перевод поддерживает обработку нескольких документов и больших файлов. Для процесса пакетного перевода требуется учетная запись Azure Blob Storage с контейнерами хранения для ваших исходных и переведенных документов.

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

Предпосылки

Предварительные требования для асинхронного пакетного перевода

Перед началом работы вам потребуется:

• Активная подписка Azure.
• Ресурс Переводчика. Инструкции по созданию ресурсов и получению конечных точек и ключей см. в разделе "Использование API перевода документов" программным способом.
• Учетная запись Хранилище BLOB-объектов Azure с исходными и целевыми контейнерами. Инструкции по настройке см. в разделе "Создание контейнеров хранилища BLOB-объектов Azure".
• Способ авторизации доступа к URL-адресам хранилища:
  • Токены с сигнатурой общего доступа (SAS) или
  • Управляемые удостоверения для перевода документов.

Предварительные требования для синхронного перевода

Перед началом работы вам потребуется:

• Активная подписка Azure.
• Ресурс Переводчика с конечной точкой личного домена. Сведения о настройке и извлечении ключей см. в разделе "Использование API перевода документов программным способом".

Ключевые особенности

Как работает перевод документов

Перевод документов поддерживает два рабочих процесса. Выберите подход, соответствующий вашему сценарию.

Асинхронный (пакетный)

1. Отправьте исходные документы в исходный контейнер.
2. Отправьте запрос на пакетный перевод.
3. Отслеживайте состояние задания и документа.
4. Скачайте переведенные документы из целевого контейнера.

Подробные потоки запросов и ответов см. в справочном руководстве по REST API перевода документов.

Синхронный

1. Отправьте запрос, включающий один документ (и необязательный глоссарий).
2. Получите переведенный документ в ответе.

Сведения о запросе и примеры см. в разделе "Синхронный перевод документов".

Варианты разработки

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

Поддерживаемые форматы документов и глоссарий

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

Ограничения запросов на перевод документов

Подробные сведения об ограничениях запросов переводчика см. в разделе "Ограничения для перевода документов".

Резиденция данных для перевода документов

Регион, в котором создается ресурс Переводчика, определяет, где обрабатывается и временно хранится содержимое документа. Сведения о расположениях обработки, требованиях к пользовательским конечным точкам и рекомендации по управляемому удостоверению см. в разделе "Поддержка региона" для Azure Translator.

Устранение неполадок

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

Пакетная трансляция

• Если переведенные файлы не отображаются в целевом контейнере, проверьте состояние задания, используя состояние Get для определенного задания перевода и состояния документа, используя состояние Get для определенного документа.
• Если служба не может считывать или записывать данные в контейнеры хранилища, подтвердите авторизацию хранилища:
  • Если вы используете маркеры SAS, ознакомьтесь с разделом "Создание маркеров общего доступа (SAS) для контейнеров хранилища и BLOB-объектов.
  • Если вы используете управляемые удостоверения, см. статью "Создание и использование управляемых удостоверений".
• Если задание завершается ошибкой из-за неподдерживаемых входных данных, подтвердите формат, используя Get supported document formats.

Синхронный перевод

• Если запрос завершается ошибкой из-за недопустимых параметров или неподдерживаемых типов файлов, просмотрите необходимые параметры и поддерживаемые форматы в синхронном переводе документов.
• Если вы достигли лимитов скорости, см. Ограничения на запросы перевода документов.

Связанный контент

• Краткое руководство по переводу документов
• Использование API перевода документов программным способом
• Использование глоссариев с переводом документов
• Справочник по REST API перевода документов
• Поддержка языка переводчика