Criar um fluxo de tradução de documentos (visualização)

Importante

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

Este tutorial orienta você na configuração de um fluxo de nuvem de conector do Microsoft Translator V3 que oferece suporte à tradução de documentos. O conector do Translator V3 cria uma conexão entre a instância do Serviço de Tradutor e o Microsoft Power Automatic, permitindo que você use uma ou mais operações pré-criadas como etapas em seus aplicativos e fluxos de trabalho.

A Tradução de Documentos é um recurso de API REST baseado em nuvem do serviço Azure AI Translator. 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 dos dados.

Neste tutorial:

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

Pré-requisitos

Aqui está o que você precisa para começar: recurso Translator, conta de armazenamento do Azure com pelo menos dois contêineres e uma identidade gerenciada atribuída ao sistema com acesso baseado em função.

Recurso do tradutor

• Se não tiver uma conta ativa do Azure, pode criar uma gratuitamente.

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

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

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

• Use a chave e o nome do recurso Tradutor para conectar seu aplicativo ao Power Automate. As chaves de recurso do Translator encontram-se na secção Gestão de Recursos no portal do Azure e o seu nome de 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 de Armazenamento de Blob do Azure e pelo menos dois contêineres para seus arquivos de origem e de destino:

  • Recipiente de origem. Este contentor é onde carrega os seus ficheiros para tradução (obrigatório).
  • Recipiente de destino. Este contêiner é onde seus arquivos traduzidos são armazenados (obrigatório).

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

  1. Aceda ao portal do Azure e inicie sessão com a sua conta do Azure.

  2. Selecione sua conta de armazenamento.

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

  4. Na guia Firewalls e redes virtuais, selecione Habilitado em redes virtuais e endereços IP selecionados.

     

  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 seu recurso Translator 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 essa conta de armazenamento está marcada. Para obter mais informações sobre como gerenciar exceções, consulteConfigurar firewalls de armazenamento do Azure e redes virtuais.

     

  9. Selecione Guardar. Pode levar até 5 minutos para que as alterações de rede se propaguem.

Identidade gerenciada com RBAC

Finalmente, antes de poder usar as operações do conector do Translator V3 para tradução de documentos, você deve conceder ao recurso do Translator acesso à 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 seu recurso do Translator e conceda a essa identidade permissões específicas para acessar sua conta de armazenamento do Azure:

1. Aceda ao portal do Azure e inicie sessão com a sua conta do Azure.

2. Selecione o recurso Tradutor.

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

4. Na guia Sistema atribuído, ative a alternância Status.

5. Selecione Guardar.

   

Atribuição de função

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

1. Aceda ao portal do Azure e inicie sessão com a 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 foi aberta, escolha sua assinatura no menu suspenso e selecione + Adicionar atribuição de função.

   

6. Por fim, atribua uma função de Colaborador de Dados de Blob de Armazenamento ao seu recurso de serviço do Translator. A função de Colaborador de Dados de Blob de Armazenamento dá ao Tradutor (representado pela identidade gerenciada atribuída ao sistema) acesso de leitura, gravação e exclusão ao contêiner de blob e aos dados. Na janela pop-up Adicionar atribuição de função, preencha os campos da seguinte forma e selecione Guardar:

   Campo	Valor
   Scope	Armazenamento.
   Subscrição	A subscrição associada ao seu recurso de armazenamento.
   Recurso	O nome do recurso de armazenamento.
   Função	Contribuidor de dados de Blob de armazenamento.

7. Depois que a mensagem de confirmação Atribuição de função adicionada for exibida, 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 seu fluxo de tradução de documentos:

1. Inicie sessão no Power Automate.

2. Selecione Criar no menu da barra lateral esquerda.

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

   

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

   

5. O primeiro passo para o seu fluxo instantâneo — acionar manualmente um fluxo — aparece na tela. Selecione Novo passo.

   

Traduzir documentos

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

Usar o Armazenamento de Blobs do Azure

Armazenamento de Blobs do Azure

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

• Escolha o conector Translator V3.
• Selecione a tradução do documento.
• Insira suas credenciais de Armazenamento de Blob do Azure e locais de contêiner.
• Traduza o(s) seu(s) documento(s) escolhendo as línguas de partida e de chegada.
• Obtenha o status da operação de tradução.

1. Na janela pop-up Escolha uma operação, digite Translator V3 na barra de pesquisa Conectores de pesquisa e ações e selecione o ícone Microsoft Translator V3.

   

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

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

   • Nome da ligação. Introduza um nome para a sua ligação.

   • Chave de subscrição. Suas chaves de recurso do Translator são encontradas na seção Gerenciamento de Recursos da barra lateral de recursos no portal do Azure. Introduza uma das suas chaves. Certifique-se de que o recurso Tradutor está atribuído a uma região geográfica, como Oeste dos EUA (não global).

   • Nome do recurso do tradutor. Insira o nome do recurso do Translator encontrado na parte superior da página do recurso no portal do Azure. Selecione Criar.

     

     Nota

     Depois de configurar a ligação, não será necessário reintroduzir as credenciais para os fluxos subsequentes.

4. A janela de ação Iniciar conversão de documentos agora é exibida. Preencha os campos da seguinte forma:

   • Para o tipo de armazenamento dos documentos de entrada. Selecione Arquivo ou Pasta.

   • Selecione um idioma de origem no menu suspenso ou mantenha a opção de deteção automática padrão.

   • Localização dos documentos-fonte. Insira a URL do(s) seu(s) documento(s) no contêiner de documentos de origem de armazenamento do Azure.

   • Localização dos documentos traduzidos. Insira a URL para seu contêiner de documento de destino de armazenamento do Azure.

     Para encontrar os URLs de origem e de destino:

     • Navegue para a sua conta de armazenamento no portal do Azure.

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

       Source	Target
       Marque a caixa de seleção ao lado do contêiner de origem	Marque a caixa de seleção ao lado 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, em seguida, escolha Propriedades.
       O URL de origem está localizado na parte superior da lista Propriedades. Selecione o ícone Copiar para a área de transferência.	O URL de destino está localizado na parte superior da lista Propriedades. Selecione o ícone Copiar para a área de transferência.
       Navegue até o fluxo Power automate e cole o URL de origem no campo Localização dos documentos de origem.	Navegue até o fluxo Power automate e cole o URL de destino no campo Localização dos documentos traduzidos.

   • Escolha um idioma de destino no menu suspenso e selecione Salvar.

     

Obter o status dos documentos

Agora que você enviou o(s) seu(s) documento(s) para tradução, vamos verificar o status da operação.

1. Selecione Novo passo.

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

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

   

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

5. Selecione o campo ID da operação. Uma janela suspensa Expressão de conteúdo / dinâmico é 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 Guardar.

   

Teste o fluxo do conector

Hora de verificar o nosso fluxo e os resultados da tradução de documentos.

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

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

   

3. Selecione os seguintes botões: Test Flow → Manualmente → Test na janela do lado direito.

4. Na janela seguinte, selecione o botão Executar fluxo .

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

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

   

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

8. É apresentada uma janela de estado Obter documentos. Na parte superior da resposta JSON, você vê "statusCode":200 indicando que a solicitação foi bem-sucedida.

   

9. Como verificação final, navegue até o contêiner de origem de destino do Armazenamento de Blobs do Azure. Lá, você deve 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

Aqui estão as etapas para carregar um arquivo do seu 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 a partir do arquivo de origem.
• Traduza o arquivo de origem.
• Obter o status dos documentos.
• Obtenha conteúdo de blob e metadados.
• Crie uma nova pasta do SharePoint.
• Crie seu arquivo traduzido no Sharepoint.

Obter conteúdo de ficheiro

1. Na janela pop-up Escolha uma operação, insira SharePoint e selecione Obter conteúdo do arquivo . O Power Automate inicia automaticamente sessão na(s) sua(s) conta(s) do SharePoint.

   

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

   • Endereço do site. Selecione a URL do site do SharePoint onde o arquivo está localizado na lista suspensa.
   • Identificador de arquivo. Selecione o ícone da pasta e escolha o(s) documento(s) para tradução.

Criar um blob de armazenamento

1. Selecione Nova etapa e insira Armazenamento de Blob 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, precisará 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 suas contas de recursos do Armazenamento de Blobs e do Tradutor do Azure.

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

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

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

   • Nome do blob. Introduza o nome do ficheiro que está a traduzir.

   • Conteúdo de Blob. Selecione o campo Conteúdo de 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 documentos

1. Selecione Novo passo.

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

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

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

   • Nome da ligação. Introduza um nome para a sua ligação.

   • Chave de subscrição. Insira uma de suas chaves que você copiou do portal do Azure.

   • Nome do recurso do tradutor. Insira o nome do recurso do Translator encontrado na parte superior da página do recurso no portal do Azure.

   • Selecione Criar.

     

     Nota

     Depois de configurar sua conexão, não será necessário reinserir suas credenciais para fluxos subsequentes do Translator.

5. A janela de ação Iniciar conversão de documentos agora é exibida. Preencha os campos da seguinte forma:

6. Para o 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 de deteção automática padrão.

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

9. Localização dos documentos traduzidos. Insira a URL para seu contêiner de documento de destino de armazenamento do Azure.

   Para encontrar o URL do contêiner de destino:

   • Navegue para a 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 ao lado do contêiner de destino.
   • Selecione as reticências localizadas à direita e, em seguida, escolha Propriedades.
   • O URL de destino está localizado na parte superior da lista Propriedades. Selecione o ícone Copiar para a área de transferência.
   • Navegue de volta ao seu fluxo Power automate e cole o URL de destino no campo Localização dos documentos traduzidos.

10. Escolha um idioma de destino no menu suspenso e selecione Salvar.

    

Obter o status dos 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 Novo passo. Digite Agendar na caixa de pesquisa e escolha Atrasar.

   • para contagem. Digite 30.
   • para a unidade. Digite Second na lista suspensa.

   

2. Selecione Novo passo. Digite Translator V3 na caixa de pesquisa e escolha Microsoft Translator V3.

3. Selecione Obter status de documentos (não o singular Obter status de documento).

   

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

5. Selecione o campo ID da operação. Uma janela suspensa Expressão de conteúdo / dinâmico é 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 Guardar.

   

Obter conteúdo de blob e metadados

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

1. Selecione Nova etapa, digite Controle na caixa de pesquisa e selecione Aplicar a cada uma delas 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. Digite Controle na caixa de pesquisa e selecione Fazer até na lista Ações .

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

6. Preencha os três campos da seguinte forma: → de progresso é igual a → 1:

   

7. Selecione Adicionar uma ação, insira Armazenamento de Blob do Azure na caixa de pesquisa e selecione a ação Obter conteúdo deblob usando 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 de Blob para mostrar a janela Conteúdo dinâmico, selecione Expressão e insira a seguinte lógica no campo de 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 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 de Blob para mostrar a janela Conteúdo dinâmico, selecione Expressão e insira a seguinte lógica no campo de 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 sua URL do SharePoint na janela suspensa Endereço do Site.
3. No campo seguinte, selecione uma Lista ou Biblioteca na lista suspensa.
4. Nomeie sua nova pasta e insira-a no campo /Folder Path/ (certifique-se de incluir o nome do caminho com barras para frente).

Criar arquivo do SharePoint

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

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

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

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

5. No campo Conteúdo do Arquivo, na lista Conteúdo dinâmico, em Obter Metadados de Blob usando caminho (V2), selecione Conteúdo do Arquivo .

6. Selecione Guardar.

   

Teste 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 para ir.

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

   

3. Selecione Test Flow → Manually → Test na janela do lado direito.

4. Na janela Fluxo de execução , selecione os botões Continuar e, em seguida, 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 com cada etapa bem-sucedida.

   

Está feito! Você aprendeu a automatizar os processos de tradução de documentos usando o conector Microsoft Translator V3 e o Power Automate.

Próximos passos

Explore o guia de referência da Tradução de Documentos