Microsoft Translator версии 3 (предварительная версия)
Microsoft Azure Cognitive Services Translator позволяет переводить текст и документы более чем на 100 языков с помощью общих или пользовательских моделей.
Этот соединитель доступен в следующих продуктах и регионах:
| Услуга | Class | Регионы |
|---|---|---|
| Copilot Studio | Стандарт | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Логические приложения | Стандарт | Все регионы Logic Apps , кроме следующих: — Регионы Azure для государственных организаций — Регионы Azure Для Китая - Министерство обороны США (DoD) |
| Power Apps | Стандарт | Все регионы Power Apps , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Power Automate | Стандарт | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Контакт | |
|---|---|
| Имя | Переводчик Майкрософт |
| URL | https://learn.microsoft.com/azure/cognitive-services/translator/translator-overview |
| Адрес электронной почты | mtfb@microsoft.com |
| Метаданные соединителя | |
|---|---|
| Publisher | Переводчик Майкрософт |
| Website | https://learn.microsoft.com/azure/cognitive-services/translator/translator-overview |
| Политика конфиденциальности | https://privacy.microsoft.com/ |
| Категории | Искусственный интеллект; Бизнес-аналитика |
Соединитель Azure Cognitive Services Translator позволяет интегрировать любой компонент Power Platform, например Power Automate Flow или Power App, с нашей службой Microsoft Translator. С помощью этого соединителя можно выполнить следующие действия:
•Перевести текст.
• Транслитерация текста.
• Перевод различных типов файлов документов.
Предпосылки
Следуйте инструкциям по созданию ресурса Переводчика на портале Azure
Получение учетных данных
• После создания ресурса Переводчика получите имя ресурса и ключ на портале Azure.
• Следуйте этим предварительным требованиям для перевода документов.
• Перейдите в исходные и целевые контейнеры и нажмите кнопку "Переключиться на учетную запись пользователя идентификатора записи Майкрософт", как показано на снимке экрана ниже. Этот шаг необходим только для соединителя.
Начало работы с соединителем
Следуйте этим инструкциям по использованию соединителя Переводчика в потоке и автоматизации задач перевода.
Распространенные ошибки
См. эту документацию по распространенным ошибкам: https://learn.microsoft.com/en-us/azure/cognitive-services/translator/reference/v3-0-reference#errors
Создание подключения
Соединитель поддерживает следующие типы проверки подлинности:
| ключа доступа | Укажите имя ресурса Microsoft Translator и ключ ресурса Azure Cognitive Services для Переводчика. | Все регионы | Доступный для общего пользования |
| Управляемое удостоверение Logic Apps | Создание подключения с помощью управляемого удостоверения LogicApps | Только LOGICAPPS | Доступный для общего пользования |
| По умолчанию [не рекомендуется] | Этот параметр предназначен только для старых подключений без явного типа проверки подлинности и предоставляется только для обратной совместимости. | Все регионы | Недоступен для совместного использования |
Ключ доступа
Идентификатор проверки подлинности: keyBasedAuth
Применимо: все регионы
Укажите имя ресурса Microsoft Translator и ключ ресурса Azure Cognitive Services для Переводчика.
Это совместное подключение. Если приложение power app предоставлено другому пользователю, подключение также предоставляется совместно. Дополнительные сведения см. в обзоре соединителей для приложений на основе холста — Power Apps | Документация Майкрософт
| Имя | Тип | Description | Обязательно |
|---|---|---|---|
| Имя ресурса Переводчика | струна | Введите имя ресурса Microsoft Translator | True |
| Ключ ресурса | securestring | Ключ ресурса Azure Cognitive Services для Переводчика. | True |
Управляемое удостоверение Logic Apps
Идентификатор проверки подлинности: managedIdentityAuth
Применимо: только LOGICAPPS
Создание подключения с помощью управляемого удостоверения LogicApps
Это совместное подключение. Если приложение power app предоставлено другому пользователю, подключение также предоставляется совместно. Дополнительные сведения см. в обзоре соединителей для приложений на основе холста — Power Apps | Документация Майкрософт
| Имя | Тип | Description | Обязательно |
|---|---|---|---|
| Управляемое удостоверение LogicApps | управляемая идентичность | Вход с помощью управляемого удостоверения Logic Apps | True |
| Имя ресурса Переводчика | струна | Введите имя ресурса Microsoft Translator | True |
| Ключ ресурса | securestring | Ключ ресурса Azure Cognitive Services для Переводчика. | True |
По умолчанию [не рекомендуется]
Применимо: все регионы
Этот параметр предназначен только для старых подключений без явного типа проверки подлинности и предоставляется только для обратной совместимости.
Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.
| Имя | Тип | Description | Обязательно |
|---|---|---|---|
| Имя ресурса Переводчика | струна | Введите имя ресурса Microsoft Translator | True |
| Ключ ресурса | securestring | Ключ ресурса Azure Cognitive Services для Переводчика. | True |
Ограничения регулирования
| Имя | Вызовы | Период обновления |
|---|---|---|
| Вызовы API для каждого подключения | 100 | 60 секунд |
Действия
| Transliterate |
Преобразует текст на одном языке из одного скрипта в другой скрипт. |
| Запуск перевода документов |
Это действие запускает задание перевода документов. |
| Отмена перевода |
Отменяет задание перевода документов, которое в настоящее время обрабатывается или помещается в очередь. |
| Перевод текста |
Перевод указанного исходного текста языка в целевой текст языка. |
| Получение поддерживаемых источников хранилища |
Возвращает список поддерживаемых источников и параметров хранилища. |
| Получение сведений о поддерживаемых форматах глоссария |
Возвращает список поддерживаемых форматов глоссарий. |
| Получение сведений о поддерживаемых форматах документов |
Возвращает список поддерживаемых форматов документов. |
| Получение состояния документа |
Возвращает состояние определенного документа в задании. |
| Получение состояния документов |
Возвращает состояние всех документов в задании перевода. |
| Получение состояния перевода |
Возвращает сводку состояния для конкретного запроса на перевод документов. |
| Получение состояния перевода |
Возвращает список вместе с состоянием всех запросов на перевод, отправленных пользователем. |
| Получение языков |
Извлекает все языки, поддерживаемые переводчиком Microsoft Azure Cognitive Services. |
Transliterate
Преобразует текст на одном языке из одного скрипта в другой скрипт.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Language
|
language | True | string |
Задает язык текста для преобразования из одного скрипта в другой. |
|
Исходный скрипт
|
fromScript | True | string |
Имя скрипта входного текста. |
|
Целевой скрипт
|
toScript | True | string |
Имя скрипта транслитерированного текста. |
|
Текст
|
Text | True | string |
Текст для перевода. |
Возвращаемое значение
- response
- array of TransliterationResults
Запуск перевода документов
Это действие запускает задание перевода документов.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Тип хранилища входных документов
|
storageType | True | string |
Выберите файл или папку. |
|
Исходный язык
|
sourceLanguage | True | string |
Языковой код. Если ни один из них не указан, Microsoft Translator попытается автоматически обнаружить язык документов. |
|
Расположение исходных документов
|
sourceURL | True | string |
Расположение исходных документов, которые могут быть одним файлом или папкой. Это расположение — это ссылка НА URL-адрес из хранилища BLOB-объектов Azure. |
|
Фильтр префикса
|
documentFilterPrefix | string |
Строка префикса с учетом регистра для фильтрации документов в исходном пути для перевода. Например, при использовании URI BLOB-объектов хранилища Azure используйте префикс, чтобы ограничить вложенные папки для перевода. |
|
|
Фильтр Суффикса
|
documentFilterSuffix | string |
Строка суффикса с учетом регистра для фильтрации документов в исходном пути для перевода. Чаще всего он используется для расширений файлов. |
|
|
Категория
|
targetCategory | string |
Строка, указывающая категорию (домен) перевода. Этот параметр используется для получения переводов из настраиваемой системы, созданной с помощью Пользовательского переводчика. |
|
|
Расположение переведенных документов
|
targetContainerURL | True | string |
Расположение, в котором будут храниться переведенные документы. Это расположение — это ссылка НА URL-адрес из хранилища BLOB-объектов Azure. |
|
Целевой язык
|
targetLanguage | True | string |
Код целевого языка. |
|
URL-адрес глоссария
|
glossaryUrl | string |
Расположение документов глоссария. Это расположение — это ссылка НА URL-адрес из хранилища BLOB-объектов Azure. |
|
|
Формат документа и версия глоссария
|
glossaryFormatVersion | string |
Формат документа и версия глоссария. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
operationID
|
operationID | string |
Идентификатор операции. |
Отмена перевода
Отменяет задание перевода документов, которое в настоящее время обрабатывается или помещается в очередь.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор операции
|
id | True | string |
Идентификатор операции. |
Возвращаемое значение
Перевод текста
Перевод указанного исходного текста языка в целевой текст языка.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Исходный язык
|
from | True | string |
Исходный код языка (например: en). Если исходный код языка не указан, для определения исходного языка применяется автоматическое обнаружение языка. |
|
Целевой язык
|
to | True | string |
Код целевого языка (например, fr). |
|
Тип текста
|
textType | string |
Определяет, является ли преобразованный текстовым форматом обычный текст или HTML. |
|
|
Действие ненормативной лексики
|
profanityAction | string |
Указывает, как следует рассматривать ненормативную лексику в переводах. |
|
|
Маркер ненормативной лексики
|
profanityMarker | string |
Указывает, как ненормативная лексика должна быть помечена в переводах. |
|
|
Включить длину предложения
|
includeSentenceLength | string |
Указывает, следует ли включать границы предложения для входного текста и переведенного текста. |
|
|
Предлагаемый исходный язык
|
suggestedFrom | string |
Указывает резервный язык, если язык входного текста не удается определить. |
|
|
Скрипт исходного текста
|
fromScript | string |
Имя скрипта входного текста. |
|
|
Скрипт переведенного текста
|
toScript | string |
Имя скрипта переведенного текста. |
|
|
Категория
|
category | string |
Строка, указывающая категорию (домен) перевода. Этот параметр используется для получения переводов из настраиваемой системы, созданной с помощью Пользовательского переводчика. |
|
|
Разрешить резервный доступ к общему домену
|
allowFallback | string |
Указывает, что служба может вернуться к общей системе, если пользовательская система не существует. |
|
|
Текст
|
Text | True | string |
Текст для перевода. |
Возвращаемое значение
- response
- array of TranslationResults
Получение поддерживаемых источников хранилища
Возвращает список поддерживаемых источников и параметров хранилища.
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
value
|
value | array of string |
Значение ответа. |
Получение сведений о поддерживаемых форматах глоссария
Получение сведений о поддерживаемых форматах документов
Получение состояния документа
Возвращает состояние определенного документа в задании.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор операции
|
id | True | string |
Идентификатор операции. |
|
Идентификатор документа
|
documentId | True | string |
Идентификатор документа. |
Возвращаемое значение
Получение состояния документов
Возвращает состояние всех документов в задании перевода.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор операции
|
id | True | string |
Идентификатор операции. |
|
Общее количество возвращаемых записей
|
$top | integer |
Общее количество записей, которые пользователь хочет вернуть на всех страницах. |
|
|
Количество записей для пропуска
|
$skip | integer |
Количество записей, пропускаемых из списка на основе метода сортировки. |
|
|
Максимальные возвращаемые записи
|
$maxpagesize | integer |
Максимальное количество записей, возвращаемых на странице. |
|
|
Сортировать по
|
$orderBy | array |
Запрос сортировки коллекции. (Eg., "CreatedDateTimeUtc asc", "CreatedDateTimeUtc desc". |
|
|
Дата начала
|
createdDateTimeUtcStart | date-time |
Дата начала, после чего элементы будут получаться. |
|
|
Дата окончания
|
createdDateTimeUtcEnd | date-time |
Дата окончания для получения элементов до. |
|
|
Фильтрация по состоянию
|
statuses | array |
Состояния, используемые в фильтрации. |
|
|
Фильтрация по идентификатору документа
|
ids | array |
Идентификаторы документов для фильтрации. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
value
|
value | array of object |
Значение ответа. |
|
путь
|
value.path | string |
Расположение документа или папки. |
|
исходный путь
|
value.sourcePath | string |
Расположение исходного документа. |
|
createdDateTimeUtc
|
value.createdDateTimeUtc | string |
Время создания операции. |
|
lastActionDateTimeUtc
|
value.lastActionDateTimeUtc | string |
Дата, в течение которого была обновлена состояние операции. |
|
статус
|
value.status | string |
Список возможных состояний для задания или документа. |
|
Кому
|
value.to | string |
Целевой язык. |
|
прогресс
|
value.progress | integer |
Ход перевода, если он доступен. |
|
id
|
value.id | string |
Идентификатор документа. |
|
characterCharged
|
value.characterCharged | integer |
Символы, оплачиваемые API. |
|
@nextLink
|
@nextLink | string |
URL-адрес для следующей страницы. Значение NULL, если последняя страница. |
Получение состояния перевода
Возвращает сводку состояния для конкретного запроса на перевод документов.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор операции
|
id | True | string |
Идентификатор операции. |
Возвращаемое значение
Получение состояния перевода
Возвращает список вместе с состоянием всех запросов на перевод, отправленных пользователем.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Общее количество возвращаемых записей
|
$top | integer |
Общее количество записей, которые пользователь хочет вернуть на всех страницах. |
|
|
Количество записей для пропуска
|
$skip | integer |
Количество записей, пропускаемых из списка на основе метода сортировки. |
|
|
Максимальные возвращаемые записи
|
$maxpagesize | integer |
Максимальное количество записей, возвращаемых на странице. |
|
|
Сортировать по
|
$orderBy | array |
Запрос сортировки для коллекции, например,'CreatedDateTimeUtc asc', "CreatedDateTimeUtc desc". |
|
|
Дата начала
|
createdDateTimeUtcStart | date-time |
Дата начала для получения записей после. |
|
|
Дата окончания
|
createdDateTimeUtcEnd | date-time |
Дата окончания для получения записей до. |
|
|
Фильтрация по состоянию
|
statuses | array |
Состояния, используемые в фильтрации. |
|
|
Фильтрация по идентификаторам операций
|
ids | array |
Идентификаторы операций для фильтрации. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
value
|
value | array of TranslationStatusResponse |
Значение ответа. |
|
@nextLink
|
@nextLink | string |
URL-адрес для следующей страницы. Значение NULL, если последняя страница. |
Получение языков
Извлекает все языки, поддерживаемые переводчиком Microsoft Azure Cognitive Services.
Возвращаемое значение
- response
- array of Language
Определения
TranslationResults
Результат перевода.
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Переведённый текст
|
TranslatedText | string |
Возвращает переведенный текст. |
|
Транслитерированный текст
|
TransliteratedText | string |
Возвращает транслитерированный текст. |
TransliterationResults
Результаты транслитерации.
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Текст
|
text | string |
Возвращает транслитерированный текст. |
|
Скрипт
|
script | string |
Транслитерированный скрипт. |
Language
Языковой код. Если ни один из них не указан, Microsoft Translator попытается автоматически обнаружить язык документов.
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Код языка
|
Code | string |
Возвращает или задает языковой код. |
|
Language
|
Name | string |
Возвращает или задает язык. |
FormatOKResponse
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
value
|
value | array of object |
Формат файла с подробными сведениями. |
|
format
|
value.format | string |
Имя формата документа. |
|
fileExtensions
|
value.fileExtensions | array of string |
Поддерживаемо расширение файла для этого формата. |
|
contentTypes
|
value.contentTypes | array of string |
Поддерживаемые типы контента для этого формата. |
|
versions
|
value.versions | array of string |
Поддерживаемая версия. |
|
defaultVersion
|
value.defaultVersion | string |
Версия по умолчанию, если она не указана. |
TranslationStatusResponse
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
id
|
id | string |
Идентификатор операции. |
|
createdDateTimeUtc
|
createdDateTimeUtc | string |
Время создания операции. |
|
lastActionDateTimeUtc
|
lastActionDateTimeUtc | string |
Дата, в течение которого была обновлена состояние операции. |
|
статус
|
status | string |
Список возможных состояний для задания или документа, таких как Canceled, Canceling, Failed, NotStarted, Running, Succeeded, ValidationFailed. |
|
итог
|
summary.total | integer |
Количество общих документов. |
|
ошибка
|
summary.failed | integer |
Сбой количества документов. |
|
success
|
summary.success | integer |
Количество документов успешно переведено. |
|
inProgress
|
summary.inProgress | integer |
Количество выполняемых документов. |
|
notYetStarted
|
summary.notYetStarted | integer |
Количество документов, которые еще не начали обработку. |
|
cancelled
|
summary.cancelled | integer |
Количество отмененных документов. |
|
totalCharacterCharged
|
summary.totalCharacterCharged | integer |
Общее количество символов, за которые взимается плата. |
DocumentStatusResponse
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
путь
|
path | string |
Расположение документа или папки. |
|
исходный путь
|
sourcePath | string |
Расположение исходного документа. |
|
createdDateTimeUtc
|
createdDateTimeUtc | string |
Время создания операции. |
|
lastActionDateTimeUtc
|
lastActionDateTimeUtc | string |
Дата, в течение которого была обновлена состояние операции. |
|
статус
|
status | string |
Список возможных состояний для задания или документа, таких как Canceled, Canceling, Failed, NotStarted, Running, Succeeded, ValidationFailed. |
|
Кому
|
to | string |
Целевой язык. |
|
прогресс
|
progress | integer |
Ход перевода, если он доступен. |
|
id
|
id | string |
Идентификатор документа. |
|
characterCharged
|
characterCharged | integer |
Символы, оплачиваемые API. |