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:
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:
Vá para o portal do Azure e entre em sua conta do Azure.
Selecione sua conta de armazenamento.
No grupo Segurança + sistema de rede no painel esquerdo, selecione Sistema de Rede.
Na guia Firewalls e redes virtuais, selecione Habilitado entre redes virtuais selecionadas e endereços IP.
Desmarque todas as caixas de seleção.
Verifique se o Roteamento de rede da Microsoft está selecionado.
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.
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, consulte Configurar redes virtuais e firewalls do Armazenamento do Azure.
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:
Vá para o portal do Azure e entre em sua conta do Azure.
Selecione o recurso Tradutor.
No grupo Gerenciamento de Recursos no painel esquerdo, selecione Identidade.
Na guia Atribuído pelo sistema, ative a alternância de Status.
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.
Vá para o portal do Azure e entre em sua conta do Azure.
Selecione o recurso Tradutor.
No grupo Gerenciamento de Recursos no painel esquerdo, selecione Identidade.
Em Permissões, selecione Atribuições de função do Azure:
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.
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. 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.
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 Translator V3 para criar seu fluxo de tradução de documentos:
Entre no Power Automate.
Selecione Criar no menu da barra lateral esquerda.
Selecione Fluxo de nuvem instantânea na área de conteúdo principal.
Na janela pop-up, nomeie seu fluxo, escolha Disparar um fluxo manualmente e selecione Criar.
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.
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.
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.
Selecione a ação Iniciar tradução de documento.
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.
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 seus documentos no contêiner de documentos de origem de 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 andamento da operação.
Selecione Nova etapa.
Insira Translator V3 na caixa de pesquisa e escolha Microsoft Translator V3.
Selecione Obter status de documentos (não a ação única Obter status do documento).
Em seguida, você inserirá uma expressão para recuperar o valor
operation ID.Selecione o campo ID da operação. Uma janela suspensa Conteúdo dinâmico / Expressão é exibida.
Selecione a guia Expressão e insira a seguinte expressão no campo de função:
body('Start_document_translation').operationID
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.
Há uma barra verde na parte superior da página indicando que Seu fluxo está pronto.
Selecione Teste no canto superior direito da página.
Selecione os seguintes botões: Testar fluxo → Manualmente → Teste na janela do lado direito.
Na próxima janela, selecione o botão Executar fluxo.
Por fim, selecione o botão Concluído.
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.
Selecione a etapa Obter status dos documentos e, em seguida, selecione Mostrar saídas brutas na seção Saídas.
Uma janela Obter status dos documentos é exibida. Na parte superior da resposta JSON, você verá
"statusCode":200indicando que a solicitação foi bem-sucedida.
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.
É isso! Você aprendeu a automatizar processos de tradução de documentos usando o conector Microsoft Translator V3 e o Power Automate.