Criar um fluxo de Tradução de Documento (versão prévia)

Importante

O conector do Translator está disponível atualmente em visualização pública. Recursos, abordagens e processos podem mudar, antes da Disponibilidade Geral (GA), com base no feedback dos usuários.

Este tutorial orienta você durante a configuração de um fluxo de nuvem do conector do Microsoft Translator V3 que dá suporte à tradução de documento. O conector do Translator V3 cria uma conexão entre sua instância do Serviço de Tradução e o Microsoft Power Automate, permitindo que você use uma ou mais operações predefinidas como etapas em seus aplicativos e fluxos de trabalho.

A Tradução de Documento é um recurso da API REST baseado em nuvem do serviço de Tradutor de IA do Azure. A API de Tradução de Documentos permite traduções de documentos múltiplas e complexas, preservando a estrutura original do documento e o formato de dados.

Neste tutorial:

• Crie uma conta de armazenamento de blobs com contêineres para seus arquivos de origem e de destino.
• Configurar uma identidade gerenciada com RBAC (controle de acesso baseado em função).
• Traduza documentos da sua conta de Armazenamento de Blobs do Azure.
• Traduza documentos do site do SharePoint.

Pré-requisitos

Veja o que você precisa para começar: Recurso de Tradução, Conta de armazenamento do Azure com pelo menos dois contêineres e uma identidade gerenciada atribuída pelo sistema com acesso baseado em função.

Recurso Tradutor

• Se você ainda não tem uma conta do Azure ativa, crie-a gratuitamente.

• Crie um recurso de Tradução de serviço único (não um recurso multisserviço dos serviços de IA do Azure). Ao concluir os campos de detalhes da instância e do projeto de Tradução, preste atenção especial às seguintes entradas:

  • Região do recurso. Escolha uma região geográfica como Oeste dos EUA (não a região Global).

  • Tipo de preço. Selecione Standard S1 para experimentar o serviço.

• Use a chave e o nome do recurso de Tradução para conectar seu aplicativo ao Power Automate. As chaves de recurso de Tradução são encontradas na seção Gerenciamento de Recursos no portal do Azure e o nome do recurso está localizado na parte superior da página.

  

• Copie e cole a chave e o nome do recurso em um local conveniente, como o Bloco de Notas da Microsoft.

Armazenamento do Azure

• Em seguida, você precisa de uma Conta Armazenamento de Blobs do Azure e pelo menos dois contêineres para seus arquivos de origem e de destino:

  • Contêiner de origem. Esse contêiner é onde você carrega os arquivos para tradução (obrigatório).
  • Contêiner de destino. Esse contêiner é o local em que os arquivos traduzidos são armazenados (obrigatório).

• Se sua conta de armazenamento estiver protegida por um firewall, você deverá habilitar configurações adicionais:

  1. Vá para o portal do Azure e entre em sua conta do Azure.

  2. Selecione sua conta de armazenamento.

  3. No grupo Segurança + sistema de rede no painel esquerdo, selecione Sistema de Rede.

  4. Na guia Firewalls e redes virtuais, selecione Habilitado entre redes virtuais selecionadas e endereços IP.

     

  5. Desmarque todas as caixas de seleção.

  6. Verifique se o Roteamento de rede da Microsoft está selecionado.

  7. Na seção Instâncias de Recurso, selecione Microsoft.CognitiveServices/accounts como o tipo de recurso e selecione o recurso Tradutor como o nome da instância.

  8. Verifique se a caixa Permitir que os serviços do Azure na lista de serviços confiáveis acessem esta conta de armazenamento está selecionada. Para obter mais informações sobre como gerenciar exceções, vejaConfigurar redes virtuais e firewalls do Armazenamento do Microsoft Azure.

     

  9. Selecione Salvar. Pode levar até 5 minutos para propagar as alterações de rede.

Identidade gerenciada com o RBAC

Por fim, antes de usar as operações do conector do Translator V3 para tradução de documentos, você deve conceder acesso ao recurso de Tradução à sua conta de armazenamento usando uma identidade gerenciada com RBAC (controle de identidade baseado em função).

Criar uma identidade gerenciada

Primeiro, crie uma identidade gerenciada atribuída pelo sistema para o recurso de Tradução e conceda a essa identidade permissões específicas para acessar sua conta de armazenamento do Azure:

1. Vá para o portal do Azure e entre em sua conta do Azure.

2. Selecione o recurso Tradutor.

3. No grupo Gerenciamento de Recursos no painel esquerdo, selecione Identidade.

4. Na guia Atribuído pelo sistema, ative a alternância de Status.

5. Selecione Salvar.

   

Atribuição de função

Em seguida, atribua uma função Storage Blob Data Contributor à identidade gerenciada no escopo de armazenamento do recurso de armazenamento.

1. Vá para o portal do Azure e entre em sua conta do Azure.

2. Selecione o recurso Tradutor.

3. No grupo Gerenciamento de Recursos no painel esquerdo, selecione Identidade.

4. Em Permissões, selecione Atribuições de função do Azure:

   

5. Na página Atribuições de função do Azure que é aberta, escolha sua assinatura no menu suspenso e, em seguida, selecione + Adicionar atribuição de função.

   

6. Por fim, atribua uma função de Colaborador de Armazenamento de Dados do Blob ao seu recurso de serviço de Tradução. A função Colaborador de Dados do Armazenamento de Blobs fornece ao Tradutor (representado pela identidade gerenciada atribuída pelo sistema) acesso de leitura, gravação e exclusão ao contêiner de blobs e aos dados. Na janela pop-up Adicionar atribuição de função, preencha os campos como segue, e selecione Salvar:

   Campo	Valor
   Escopo	Armazenamento.
   Assinatura	A assinatura associada ao recurso de armazenamento.
   Recurso	O nome do recurso de armazenamento.
   Função	Colaborador de Dados de Blob de Armazenamento.

7. Depois que a mensagem de confirmação Atribuição de função adicionada aparecer, atualize a página para ver a atribuição de função adicionada.

   

8. Se você não vir a nova atribuição de função imediatamente, aguarde e tente atualizar a página novamente. Quando você atribui ou remove atribuições de função, pode levar até 30 minutos para que as alterações entrem em vigor.

   

Configurar um fluxo de Tradução de Documentos

Agora que você concluiu os pré-requisitos e a configuração inicial, vamos começar a usar o conector do Translator V3 para criar o fluxo de tradução de documentos:

1. Entre no Power Automate.

2. Selecione Criar no menu da barra lateral esquerda.

3. Selecione Fluxo de nuvem instantânea na área de conteúdo principal.

   

4. Na janela pop-up, nomeie seu fluxo, escolha Disparar um fluxo manualmente e selecione Criar.

   

5. A primeira etapa para o fluxo instantâneo — Disparar um fluxo manualmente — é exibida na tela. Selecione Nova etapa.

   

Traduzir documentos

Em seguida, estamos prontos para selecionar uma ação. Você pode traduzir documentos localizados em seu Armazenamento de Blobs do Azure ou na conta do Microsoft SharePoint.

Usar o Armazenamento de Blobs do Azure

Armazenamento do Blobs do Azure

Estas são as etapas para traduzir um arquivo no Armazenamento de Blobs do Azure usando o conector do Translator V3:

• Escolha o conector do Translator V3.
• Selecione Tradução de documento.
• Insira suas credenciais de Armazenamento de Blobs do Azure e locais de contêiner.
• Traduza seus documentos escolhendo idiomas de origem e de destino.
• Obtenha o status da operação de tradução.

1. Na janela pop-up Escolher uma operação, insira Translator V3 na barra de pesquisa Pesquisar conectores e ações e selecione o ícone Microsoft Translator V3.

   

2. Selecione a ação Iniciar tradução de documento.

3. Se você estiver usando o conector do Translator V3 pela primeira vez, será necessário inserir suas credenciais de recurso:

   • Nome da conexão. Digite um nome para a conexão.

   • Chave de assinatura. As chaves de recurso de Tradução são encontradas na seção Gerenciamento de Recursos da barra lateral do recurso no portal do Azure. Insira uma das suas chaves. Verifique se o recurso de Tradução está atribuído a uma região geográfica, como Oeste dos EUA (não global).

   • Nome do recurso de Tradução. Insira o nome do recurso de Tradução encontrado na parte superior da página de recursos no portal do Azure. Selecione Criar.

     

     Observação

     Depois de configurar sua conexão, você não precisará inserir novamente suas credenciais para fluxos subsequentes.

4. A janela de ação Iniciar tradução de documento agora é exibida. Preencha os campos da seguinte maneira:

   • Em Tipo de armazenamento dos documentos de entrada. Selecione Arquivo ou Pasta.

   • Selecione um Idioma de Origem no menu suspenso ou mantenha a opção Detecção automática padrão.

   • Localização dos documentos de origem. Insira a URL dos documentos no contêiner do documento de origem do armazenamento do Azure.

   • Local dos documentos traduzidos. Insira a URL do contêiner do documento de destino de armazenamento do Azure.

     Para localizar suas URLs de origem e de destino:

     • Navegue até sua conta de armazenamento no portal do Azure.

     • Na barra lateral esquerda, em Armazenamento de dados, selecione Contêineres:

       Fonte	Destino
       Marcar a caixa de seleção próxima do contêiner de origem	Marque a caixa de seleção próxima do contêiner de destino.
       Na área da janela principal, selecione um arquivo ou documento para tradução.	Selecione as reticências localizadas à direita e escolha Propriedades.
       A URL de origem está localizada na parte superior da lista Propriedades. Selecione ícone Copiar para Área de Transferência.	A URL de destino está localizada na parte superior da lista Propriedades. Selecione ícone Copiar para Área de Transferência.
       Navegue até o fluxo do Power Automate e cole a URL de origem no campo Local dos documentos de origem.	Navegue até o fluxo do Power Automate e cole a URL de destino no campo Local dos documentos de tradução.

   • Escolha um Idioma de Destino no menu suspenso e selecione Salvar.

     

Obter status de documentos

Agora que você enviou seus documentos para tradução, vamos verificar o status da operação.

1. Selecione Nova etapa.

2. Insira Translator V3 na caixa de pesquisa e escolha Microsoft Translator V3.

3. Selecione Obter status de documentos (não a ação única Obter status do documento).

   

4. Em seguida, você inserirá uma expressão para recuperar o valor operation ID.

5. Selecione o campo ID da operação. Uma janela suspensa Conteúdo dinâmico / Expressão é exibida.

6. Selecione a guia Expressão e insira a seguinte expressão no campo de função:

   
      body('Start_document_translation').operationID
   
   

   

7. Selecione OK. A função aparece na janela ID da operação. Selecione Salvar.

   

Testar o fluxo do conector

Hora de verificar nossos resultados de fluxo e tradução de documentos.

1. Há uma barra verde na parte superior da página indicando que Seu fluxo está pronto.

2. Selecione Teste no canto superior direito da página.

   

3. Selecione os seguintes botões: Testar fluxo → Manualmente → Teste na janela do lado direito.

4. Na próxima janela, selecione o botão Executar fluxo.

5. Por fim, selecione o botão Concluído.

6. Você deve receber uma mensagem Seu fluxo foi executado com êxito e as marcas de seleção verdes se alinham a cada etapa bem-sucedida.

   

7. Selecione a etapa Obter status dos documentos e, em seguida, selecione Mostrar saídas brutas na seção Saídas.

8. Uma janela Obter status dos documentos é exibida. Na parte superior da resposta JSON, você verá "statusCode":200 indicando que a solicitação foi bem-sucedida.

   

9. Como verificação final, navegue até o contêiner de origem de destino Armazenamento de Blobs do Azure. Lá, você deverá ver o documento traduzido na seção Visão geral. O documento pode estar em uma pasta rotulada com o código do idioma de tradução.

Usar o Microsoft SharePoint

Microsoft SharePoint

Estas são as etapas para carregar um arquivo do site do SharePoint para o Armazenamento de Blobs do Azure, traduzir o arquivo e retornar o arquivo traduzido para o SharePoint:

• Recupere o conteúdo do arquivo de origem do seu site do SharePoint.
• Crie um blob de armazenamento do Azure do arquivo de origem.
• Traduza o arquivo de origem.
• Obtenha status de documentos.
• Obtenha conteúdo e metadados de blob.
• Crie uma nova pasta do SharePoint.
• Crie seu arquivo traduzido no Sharepoint.

Obter conteúdo do arquivo

1. Na janela pop-up Escolher uma operação, digite SharePoint e selecione o conteúdo Obter conteúdo do arquivo. O Power Automate conecta você automaticamente à sua conta(s) do SharePoint.

   

2. Na janela Obter conteúdo do arquivo, preencha os seguintes campos:

   • Endereço do Site. Selecione a URL do site do SharePoint em que o arquivo está localizado na lista suspensa.
   • Identificador do arquivo. Selecione o ícone de pasta e escolha os documentos para tradução.

Criar um blob de armazenamento

1. Selecione Nova etapa e insira Armazenamento de Blobs do Azure na caixa de pesquisa.

2. Selecione a ação Criar blob (V2).

3. Se você estiver usando a etapa de armazenamento do Azure pela primeira vez, será necessário inserir sua autenticação de recurso de armazenamento:

4. No campo Tipo de autenticação, escolha Microsoft Entra Integrado e, em seguida, selecione o botão Entrar.

   

5. Escolha a conta do Microsoft Entra associada às contas de recursos do Armazenamento de Blobs do Azure e de Tradução.

6. Depois de concluir a autenticação do Armazenamento de Blobs do Azure, a etapa Criar blob será exibida. Preencha os campos da seguinte maneira:

   • Nome ou ponto de extremidade da conta de Armazenamento. Selecione Inserir valor personalizado e insira o nome da conta de armazenamento.

   • Caminho da pasta. Selecione o ícone de pasta e selecione o contêiner do documento de origem.

   • Nome de blob. Insira o nome do arquivo que você está traduzindo.

   • Conteúdo do blob. Selecione o campo Conteúdo do Blob para revelar a lista suspensa Conteúdo dinâmico e escolha o ícone Conteúdo de arquivo do SharePoint.

     

Iniciar a tradução de documento

1. Selecione Nova etapa.

2. Insira Translator V3 na caixa de pesquisa e escolha Microsoft Translator V3.

3. Selecione a ação Iniciar tradução de documento.

4. Se você estiver usando o conector do Translator V3 pela primeira vez, será necessário inserir suas credenciais de recurso:

   • Nome da conexão. Digite um nome para a conexão.

   • Chave de assinatura. Insira uma das chaves copiadas do portal do Azure.

   • Nome do recurso de Tradução. Insira o nome do recurso de Tradução encontrado na parte superior da página de recursos no portal do Azure.

   • Selecione Criar.

     

     Observação

     Depois de configurar sua conexão, você não precisará recuar novamente suas credenciais para fluxos de Tradução subsequentes.

5. A janela de ação Iniciar tradução de documento agora é exibida. Preencha os campos da seguinte maneira:

6. Em Tipo de armazenamento dos documentos de entrada. Selecione Arquivo ou Pasta.

7. Selecione um Idioma de Origem no menu suspenso ou mantenha a opção Detecção automática padrão.

8. Localização dos documentos de origem. Selecione o campo e adicione um Caminho seguido por Nome na lista suspensa Conteúdo dinâmico.

9. Local dos documentos traduzidos. Insira a URL do contêiner do documento de destino de armazenamento do Azure.

   Para localizar a URL do contêiner de destino:

   • Navegue até sua conta de armazenamento no portal do Azure.
   • Na barra lateral esquerda, em Armazenamento de dados, selecione Contêineres.
   • Marque a caixa de seleção próxima do contêiner de destino.
   • Selecione as reticências localizadas à direita e escolha Propriedades.
   • A URL de destino está localizada na parte superior da lista Propriedades. Selecione ícone Copiar para Área de Transferência.
   • Retorne para o fluxo do Power Automate e cole a URL de destino no campo Local dos documentos de tradução.

10. Escolha um Idioma de Destino no menu suspenso e selecione Salvar.

    

Obter status de documentos

Antes de recuperar o status dos documentos, vamos agendar um atraso de 30 segundos para garantir que o arquivo tenha sido processado para tradução:

1. Selecione Nova etapa. Insira Agendamento na caixa de pesquisa e escolha Atraso.

   • Para Contagem. Insira 30.
   • Para Unidade. Insira Segundo na lista suspensa.

   

2. Selecione Nova etapa. Insira Translator V3 na caixa de pesquisa e escolha Microsoft Translator V3.

3. Selecione Obter status de documentos (não Obter status do documento único).

   

4. Em seguida, você inserirá uma expressão para recuperar o valor operation ID.

5. Selecione o campo ID da operação. Uma janela suspensa Conteúdo dinâmico / Expressão é exibida.

6. Selecione a guia Expressão e insira a seguinte expressão no campo de função:

   
     body('Start_document_translation').operationID
   
   

   

7. Selecione OK. A função aparece na janela ID da operação. Selecione Salvar.

   

Obter conteúdo e metadados de blob

Nesta etapa, você recupera o documento traduzido de Armazenamento de Blobs do Azure e o carrega no SharePoint.

1. Selecione Nova Etapa, insira Controle na caixa de pesquisa e selecione Aplicar a cada uma na lista Ações.

2. Selecione o campo de entrada para mostrar a janela Conteúdo dinâmico e selecione o valor.

   

3. Selecione Adicionar uma ação.

   

4. Insira Controle na caixa de pesquisa e selecione Do until na lista Ações.

5. Selecione o campo Escolher um valor para mostrar a janela Conteúdo dinâmico e selecione progresso.

6. Conclua os três campos da seguinte maneira: progresso → é igual a → 1:

   

7. Selecione Adicionar uma ação, insira Armazenamento de Blobs do Azure na caixa de pesquisa e selecione a ação Obter conteúdo de blob usando um caminho (V2).

8. No campo Nome da conta de armazenamento ou ponto de extremidade de blob, selecione Inserir valor personalizado e insira o nome da conta de armazenamento.

9. Selecione o campo Caminho do blob para mostrar a janela Conteúdo dinâmico, selecione Expressão e insira a seguinte lógica no campo fórmula:

   
      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. Selecione Adicionar uma ação, insira Armazenamento de Blobs do Azure na caixa de pesquisa e selecione a ação Obter metadados de blob usando um caminho (V2).

11. No campo Nome da conta de armazenamento ou ponto de extremidade de blob, selecione Inserir valor personalizado e insira o nome da conta de armazenamento.

    

12. Selecione o campo Caminho do blob para mostrar a janela Conteúdo dinâmico, selecione Expressão e insira a seguinte lógica no campo fórmula:

    
       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])
    
    

Criar nova pasta

1. Selecione Adicionar uma ação, insira SharePoint na caixa de pesquisa e selecione a ação Criar nova pasta.
2. Selecione a URL do SharePoint na janela suspensa Endereço do Site.
3. No próximo campo, selecione uma Lista ou Biblioteca na lista suspensa.
4. Nomeie sua nova pasta e insira-a no campo /Caminho da pasta/ (certifique-se de colocar o nome do caminho com barras duplas).

Criar um arquivo do SharePoint

1. Selecione Adicionar uma ação, insira SharePoint na caixa de pesquisa e selecione a ação Criar arquivo.

2. Selecione a URL do SharePoint na janela suspensa Endereço do Site.

3. No campo Caminho da pasta, na lista Conteúdo dinâmico, em Criar pasta, selecione Caminho completo.

4. No campo Nome do arquivo, na lista Conteúdo dinâmico, em Obter metadados de blob usando o caminho (V2), selecione Nome.

5. No campo Conteúdo do arquivo, na lista Conteúdo dinâmico, em Obter metadados de blob usando o caminho (V2), selecione Conteúdo do arquivo.

6. Selecione Salvar.

   

Testar o fluxo do conector

Vamos verificar o fluxo de tradução de documentos e os resultados.

1. Há uma barra verde na parte superior da página indicando que Seu fluxo está pronto..

2. Selecione Teste no canto superior direito da página.

   

3. Selecione Testar fluxo → Manualmente → Teste na janela do lado direito.

4. Na janela Executar fluxo, selecione os botões Continuar e Executar fluxo.

5. Por fim, selecione o botão Concluído.

6. Você deve receber uma mensagem "Seu fluxo foi executado com êxito" e as marcas de seleção verdes se alinham a cada etapa bem-sucedida.

   

É isso! Agora você sabe como automatizar processos de tradução de documentos usando o conector do Microsoft Translator V3 e o Power Automate.

Próximas etapas

Explorar o guia de referência de Tradução de Documento