Создание потока перевода документов переводчика ИИ Azure (предварительная версия)

Это важно

Соединитель Microsoft Azure Translator в настоящее время доступен в общедоступной предварительной версии. Функции, подходы и процессы могут изменяться до выпуска общедоступной версии на основе отзывов пользователей.

В этом руководстве описано, как настроить облачный поток соединителя Microsoft Azure Translator версии 3, поддерживающий перевод документов. Соединитель Translator версии 3 создает соединение между экземпляром службы переводчика и Microsoft Power Automate, что позволяет использовать одну или несколько предварительно созданных операций в качестве шагов в приложениях и рабочих процессах.

Перевод документов — это облачная функция REST API службы Azure AI Translator. API перевода документов включает несколько и сложных переводов документов при сохранении исходной структуры документа и формата данных.

В этом руководстве рассматриваются следующие темы:

• Создайте учетную запись хранения BLOB-объектов с контейнерами для исходных и целевых файлов.
• Настройте управляемое удостоверение с помощью управления доступом на основе ролей (RBAC).
• Перевод документов из учетной записи Хранилище BLOB-объектов Azure.
• Перевод документов с сайта SharePoint.

Предпосылки

Вот что необходимо приступить к работе: ресурс переводчика, учетная запись хранения Azure с двумя контейнерами и назначаемое системой управляемое удостоверение с доступом на основе ролей.

Ресурс переводчика

• Если у вас нет активной учетной записи Azure, ее можно создать бесплатно.

• Создайте ресурс Переводчика с одной службой (а не ресурс Azure AI Foundry с несколькими службами). По завершении поля сведений о проекте и экземпляре Переводчика обратите особое внимание на следующие записи:

  • Область ресурсов. Выберите географическийрегион, например западная часть США (не глобальный регион).

  • Ценовая категория. Выберите "Стандартный" S1 , чтобы попробовать службу.

• Используйте ключ и имя из ресурса Переводчика, чтобы подключить приложение к Power Automate. Ключи ресурсов Переводчика находятся в разделе "Управление ресурсами" в портал Azure, а имя ресурса находится в верхней части страницы.

  

• Скопируйте и вставьте имя ключа и ресурса в удобное расположение, например Microsoft Notepad.

Служба хранилища Azure

• Затем вам потребуется учетная запись Хранилище BLOB-объектов Azure и по крайней мере два контейнера для исходных и целевых файлов:

  • Контейнер исходных файлов. В этом контейнере вы отправляете файлы для перевода (обязательно).
  • Целевой контейнер. В этом контейнере хранятся преобразованные файлы (обязательные).

• Если учетная запись хранения находится за брандмауэром, необходимо включить дополнительные конфигурации:

  1. Откройте портал Azure и войдите в свою учетную запись Azure.

  2. Выберите учетную запись хранения.

  3. В группе "Безопасность и сеть " в левой области выберите "Сеть".

  4. На вкладке "Брандмауэры и виртуальные сети " выберите "Включено" из выбранных виртуальных сетей и IP-адресов.

     

  5. Отмените выбор всех флажков.

  6. Убедитесь, что выбрана маршрутизация сети Майкрософт .

  7. В разделе "Экземпляры ресурсов" выберите Microsoft.CognitiveServices/accounts в качестве типа ресурса и выберите ресурс Переводчика в качестве имени экземпляра.

  8. Убедитесь, что Allow Azure services on the trusted services list to access this storage account флажок установлен. Дополнительные сведения об управлении исключениями см. в разделе "Настройка служба хранилища Azure брандмауэров и виртуальных сетей".

     

  9. Нажмите кнопку "Сохранить". Для распространения изменений сети может потребоваться до 5 минут.

Управляемое удостоверение с помощью RBAC

Наконец, прежде чем вы сможете использовать операции соединителя Translator версии 3 для перевода документов, необходимо предоставить вашему ресурсу Translator доступ к учетной записи хранения, используя управляемую идентификацию с системой управления доступом на основе ролей (RBAC).

Создайте управляемое удостоверение

Сначала создайте управляемое удостоверение, назначаемое системой для ресурса Переводчика, и предоставьте этим удостоверениям определенные разрешения для доступа к учетной записи хранения Azure:

1. Откройте портал Azure и войдите в свою учетную запись Azure.

2. Выберите ресурс Переводчика.

3. В группе Управление ресурсами в левой области выберите Удостоверение.

4. На вкладке " Назначаемая системой" включите переключатель "Состояние ".

5. Нажмите кнопку "Сохранить".

   

Назначение ролей

Затем назначьте Storage Blob Data Contributor роль управляемому удостоверению в области хранилища для ресурса хранилища.

1. Откройте портал Azure и войдите в свою учетную запись Azure.

2. Выберите ресурс Переводчика.

3. В группе Управление ресурсами в левой области выберите Удостоверение.

4. В разделе Разрешения выберите Назначения ролей Azure.

   

5. На открывшейся странице назначений ролей Azure выберите подписку в раскрывающемся меню и нажмите кнопку +Добавить назначение ролей.

   

6. Наконец, назначьте роль участника данных BLOB-объектов хранилища ресурсу службы Переводчика. Роль Участник для данных BLOB-объектов хранилища предоставляет Переводчику (который представлен этим управляемым удостоверением, назначаемым системой) доступ на чтение, запись и удаление самого контейнера больших двоичных объектов и данных в нем. В всплывающем Add role assignment окне заполните поля следующим образом и нажмите кнопку "Сохранить".

   Поле	Ценность
   Объем	Хранилище.
   Подписка	Подписка, связанная с ресурсом хранилища.
   Ресурс	Имя ресурса хранилища.
   Роль	Участник для данных BLOB-объектов хранилища.

7. После появления сообщения подтверждения назначения добавленной роли обновите страницу, чтобы увидеть добавление назначения ролей.

   

8. Если новое назначение роли не отображается сразу, подождите и повторите попытку обновления страницы. При добавлении или удалении назначений ролей может потребоваться до 30 минут, чтобы изменения вступили в силу.

   

Настройка потока перевода документов

Теперь, когда вы выполнили предварительные требования и начальную настройку, давайте приступим к работе с соединителем Переводчика версии 3 для создания потока перевода документов:

1. Войдите в Power Automate.

2. Выберите "Создать" в меню левой боковой панели.

3. Выберите мгновенный поток облака из основной области содержимого.

   

4. В всплывающем окне назовите поток, а затем нажмите кнопку "Вручную активировать поток " и нажмите кнопку "Создать".

   

5. Первый шаг для мгновенного потока ( вручную активирует поток) отображается на экране. Выберите Создать шаг.

   

Перевод документов

Далее мы готовы выбрать действие. Вы можете перевести документы, расположенные в вашей Хранилище BLOB-объектов Azure или учетной записи Microsoft SharePoint.

Использование Хранилище BLOB-объектов Azure

Azure Blob-хранилище

Ниже приведены шаги по переводу файла в хранилище BLOB-объектов Azure с помощью соединителя Translator версии 3.

• Выберите соединитель Translator версии 3.
• Выберите перевод документов.
• Введите свои Хранилище BLOB-объектов Azure учетные данные и расположения контейнеров.
• Преобразуйте документы, выбрав исходные и целевые языки.
• Получение состояния операции перевода.

1. Во всплывающем окне "Выбор операции" введите Переводчик v3 в строке поиска соединителей и действий и выберите значок Microsoft Azure Translator v3.

   

2. Выберите действие "Пуск перевода документов".

3. Если вы используете коннектор Translator v3 в первый раз, необходимо ввести учетные данные ресурса.

   • Имя подключения. Введите имя для подключения.

   • Ключ подписки. Ключи ресурсов Переводчика находятся в разделе "Управление ресурсами" боковой панели ресурса в портал Azure. Введите один из ключей. Убедитесь, что ресурс Переводчика назначен географическому региону, например западной части США (не глобально).

   • Имя ресурса Переводчика. Введите имя ресурса Переводчика, найденного в верхней части страницы ресурса в портал Azure. Нажмите кнопку "Создать".

     

     Замечание

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

4. Откроется окно действия перевода документов "Пуск". Заполните поля следующим образом:

   • Для типа хранилища входных документов. Выберите файл или папку.

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

   • Расположение исходных документов. Введите URL-адрес документов в контейнере исходного документа хранилища Azure.

   • Расположение переведенных документов. Введите URL-адрес целевого контейнера документов хранилища Azure.

     Чтобы найти исходные и целевые URL-адреса, выполните приведенные ниже действия.

     • Войдите в свою учетную запись хранения на портале Azure.

     • В левой боковой панели в разделе хранилища данных выберите контейнеры:

       Исходный материал	Цель
       Установите флажок рядом с исходным контейнером	Установите флажок рядом с целевым контейнером.
       В главной области окна выберите файл или документ для перевода.	Выберите многоточие, расположенные справа, а затем выберите "Свойства".
       Исходный URL-адрес находится в верхней части списка свойств. Выберите значок копирования в буфер обмена.	Целевой URL-адрес расположен в верхней части списка свойств. Выберите значок копирования в буфер обмена.
       Перейдите к потоку Power Automate и вставьте исходный URL-адрес в поле "Расположение исходных документов ".	Перейдите к потоку Power Automate и вставьте целевой URL-адрес в поле "Расположение переведенных документов ".

   • Выберите целевой язык в раскрывающемся меню и нажмите кнопку "Сохранить".

     

Получение сведений о состоянии документов

Теперь, когда вы отправили документы для перевода, давайте проверим состояние операции.

1. Выберите Создать шаг.

2. Введите переводчик версии 3 в поле поиска и выберите Microsoft Azure Translator версии 3.

3. Выберите " Получить документы" (а не единственное действие "Получить документ ").

   

4. Затем вы введете выражение для получения operation ID значения.

5. Выберите поле идентификатора операции. Откроется раскрывающееся окно динамического выражения содержимого / .

6. Перейдите на вкладку "Выражение" и введите следующее выражение в поле функции:

   
      body('Start_document_translation').operationID
   
   

   

7. Нажмите ОК. Функция отображается в окне идентификатора операции. Нажмите кнопку "Сохранить".

   

Тестирование потока соединителя

Время проверки результатов потока и перевода документов.

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

2. Выберите "Тест" в правом верхнем углу страницы.

   

3. Выберите следующие кнопки: тестовый поток → вручную → Тест в правом окне.

4. В следующем окне нажмите кнопку "Запустить поток ".

5. Наконец, нажмите кнопку "Готово ".

6. Вы должны получить сообщение о успешном выполнении потока и зеленые флажки, которые соответствуют каждому успешному шагу.

   

7. Выберите шаг состояния "Получить документы", а затем выберите "Показать необработанные выходные данные" в разделе "Выходные данные".

8. Появится окно состояния "Получить документы". В верхней части ответа JSON вы увидите "statusCode":200 , что запрос выполнен успешно.

   

9. В качестве окончательной проверки перейдите к целевому контейнеру источника Хранилище BLOB-объектов Azure. Там вы увидите переведенный документ в разделе "Обзор ". Документ может находиться в папке, помеченной кодом языка перевода.

Использование Microsoft SharePoint

Microsoft SharePoint

Ниже приведены инструкции по отправке файла с сайта SharePoint в Хранилище BLOB-объектов Azure, переводе файла и возврате преобразованного файла в SharePoint:

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

Получить содержимое файла

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

   

2. В окне шага "Получить содержимое файла" заполните следующие поля:

   • Адрес сайта. Выберите URL-адрес сайта SharePoint, в котором находится файл в раскрывающемся списке.
   • Идентификатор файла. Выберите значок папки и выберите документы для перевода.

Создание BLOB-объекта хранилища

1. Выберите новый шаг и введите Хранилище BLOB-объектов Azure в поле поиска.

2. Create blob (V2) Выберите действие.

3. Если вы используете шаг хранилища Azure в первый раз, необходимо ввести проверку подлинности ресурсов хранилища:

4. В поле "Тип проверки подлинности" выберите интегрированную учетную запись Майкрософт, а затем нажмите кнопку "Войти".

   

5. Выберите учетную запись Microsoft Entra, связанную с Хранилище BLOB-объектов Azure и учетными записями ресурсов Переводчика.

6. После завершения проверки подлинности Хранилище BLOB-объектов Azure появится шаг создания БОЛЬШОго двоичного объекта. Заполните поля следующим образом:

   • Имя учетной записи хранения или конечная точка BLOB-объектов. Выберите "Ввести настраиваемое значение " и введите имя учетной записи хранения.

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

   • Имя BLOB-объекта. Введите имя преобразованного файла.

   • Содержимое BLOB-объектов. Выберите поле содержимого BLOB-объектов, чтобы открыть раскрывающийся список динамического содержимого и выбрать значок содержимого файла SharePoint.

     

Запуск перевода документов

1. Выберите Создать шаг.

2. Введите переводчик версии 3 в поле поиска и выберите Microsoft Azure Translator версии 3.

3. Выберите действие "Пуск перевода документов".

4. Если вы используете коннектор Translator v3 в первый раз, необходимо ввести учетные данные ресурса.

   • Имя подключения. Введите имя для подключения.

   • Ключ подписки. Введите один из ключей, скопированных из портал Azure.

   • Имя ресурса Переводчика. Введите имя ресурса Переводчика, найденного в верхней части страницы ресурса в портал Azure.

   • Нажмите кнопку "Создать".

     

     Замечание

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

5. Откроется окно действия перевода документов "Пуск". Заполните поля следующим образом:

6. Для типа хранилища входных документов. Выберите файл или папку.

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

8. Расположение исходных документов. Выберите поле и добавьте путь, за которым следует имя из раскрывающегося списка динамического содержимого.

9. Расположение переведенных документов. Введите URL-адрес целевого контейнера документов хранилища Azure.

   Чтобы найти URL-адрес целевого контейнера, выполните приведенные действия.

   • Войдите в свою учетную запись хранения на портале Azure.
   • В левой боковой панели в разделе хранилища данных выберите контейнеры.
   • Установите флажок рядом с целевым контейнером.
   • Выберите многоточие, расположенные справа, а затем выберите "Свойства".
   • Целевой URL-адрес расположен в верхней части списка свойств. Выберите значок копирования в буфер обмена.
   • Вернитесь к потоку Power Automate и вставьте целевой URL-адрес в поле "Расположение переведенных документов ".

10. Выберите целевой язык в раскрывающемся меню и нажмите кнопку "Сохранить".

    

Получение сведений о состоянии документов

Перед получением состояния документов давайте запланируем 30-секундную задержку, чтобы убедиться, что файл обрабатывается для перевода:

1. Выберите Создать шаг. Введите расписание в поле поиска и нажмите кнопку "Задержка".

   • Для счетчика. Введите значение 30.
   • Для единицы. Введите второй из раскрывающегося списка.

   

2. Выберите Создать шаг. Введите переводчик версии 3 в поле поиска и выберите Microsoft Azure Translator версии 3.

3. Выберите " Получить документы" (а не состояние "Получить документ ").

   

4. Затем вы введете выражение для получения operation ID значения.

5. Выберите поле идентификатора операции. Откроется раскрывающееся окно динамического выражения содержимого / .

6. Перейдите на вкладку "Выражение" и введите следующее выражение в поле функции:

   
     body('Start_document_translation').operationID
   
   

   

7. Нажмите ОК. Функция отображается в окне идентификатора операции. Нажмите кнопку "Сохранить".

   

Получение содержимого и метаданных BLOB-объектов

На этом шаге вы получите переведенный документ из Хранилище BLOB-объектов Azure и отправьте его в SharePoint.

1. Выберите новый шаг, введите элемент управления в поле поиска и выберите "Применить к каждому из списка действий ".

2. Выберите поле ввода, чтобы отобразить окно динамического содержимого и выбрать значение.

   

3. Выберите Добавить действие.

   

4. Введите элемент управления в поле поиска и выберите "Сделать", пока в списке "Действия ".

5. Выберите поле "Выбор значения", чтобы отобразить окно динамического содержимого и выбрать ход выполнения.

6. Выполните три поля следующим образом: ход выполнения → равен → 1:

   

7. Нажмите кнопку "Добавить действие", введите Хранилище BLOB-объектов Azure в поле поиска и выберите Get blob content using path (V2) действие.

8. В поле "Имя учетной записи хранения" или "Конечная точка BLOB-объектов" выберите "Введите настраиваемое значение " и введите имя учетной записи хранения.

9. Выберите поле пути большого двоичного объекта, чтобы отобразить окно динамического содержимого, выберите выражение и введите следующую логику в поле формулы:

   
      concat(split(outputs('Get_documents_status')?['body/path'],'/')[3],'/',split(outputs('Get_documents_status')?['body/path'],'/')[4],'/',split(outputs('Get_documents_status')?['body/path'],'/')[5])
   
   

10. Нажмите кнопку "Добавить действие", введите Хранилище BLOB-объектов Azure в поле поиска и выберите Get Blob Metadata using path (V2) действие.

11. В поле "Имя учетной записи хранения" или "Конечная точка BLOB-объектов" выберите "Введите настраиваемое значение " и введите имя учетной записи хранения.

    

12. Выберите поле пути большого двоичного объекта, чтобы отобразить окно динамического содержимого, выберите выражение и введите следующую логику в поле формулы:

    
       concat(split(outputs('Get_documents_status')?['body/path'],'/')[3],'/',split(outputs('Get_documents_status')?['body/path'],'/')[4],'/',split(outputs('Get_documents_status')?['body/path'],'/')[5])
    
    

Создание папки

1. Выберите " Добавить действие", введите SharePoint в поле поиска и выберите действие "Создать новую папку ".
2. Выберите URL-адрес SharePoint в раскрывающемся окне "Адрес сайта".
3. В следующем поле выберите список или библиотеку из раскрывающегося списка.
4. Назовите новую папку и введите ее в поле /Folder Path/ (обязательно заключите имя пути с косыми чертами вперед).

Создание файла SharePoint

1. Выберите " Добавить действие", введите SharePoint в поле поиска и выберите действие "Создать файл ".

2. Выберите URL-адрес SharePoint в раскрывающемся окне "Адрес сайта".

3. В поле "Путь к папке" в списке динамического содержимого в разделе "Создать новую папку" выберите "Полный путь".

4. В поле "Имя файла" в списке динамического содержимого в разделе "Получение метаданных BLOB-объектов" с помощью пути (V2) выберите "Имя".

5. В поле "Содержимое файла" в списке динамического содержимого в разделе "Получение метаданных BLOB-объектов" с помощью пути (V2) выберите "Содержимое файла".

6. Нажмите кнопку "Сохранить".

   

Тестирование потока соединителя

Давайте проверим поток перевода документов и результаты.

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

2. Выберите "Тест" в правом верхнем углу страницы.

   

3. Выберите Test Flow → Вручную → Тест в правом окне.

4. Run flow В окне нажмите кнопку "Продолжить", а затем кнопкиRun flow.

5. Наконец, нажмите кнопку Done .

6. Вы должны получить сообщение "Поток успешно запущен" и зеленые флажки выровнены по каждому успешному шагу.

   

Вот и все! Вы узнали, как автоматизировать процессы перевода документов с помощью соединителя Microsoft Azure Translator версии 3 и Power Automate.

Дальнейшие шаги

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