Você criou um agente no Copilot Studio que precisa acionar um fluxo do Power Automate, mas a chamada falha silenciosamente ou retorna um erro. Esse problema geralmente acontece quando o token de autenticação do fluxo está ausente, o fluxo não foi compartilhado corretamente ou o agente não tem permissão para executá-lo. Este artigo explica a causa raiz da falha e fornece correções passo a passo para restaurar a conexão entre seu agente e seus fluxos.
Principais conclusões: corrigindo falhas de conexão entre agente e fluxo
- Power Automate > Fluxo > Compartilhar com Copilot Studio: O fluxo deve ser compartilhado com a entidade de serviço do agente, não com uma conta de usuário.
- Copilot Studio > Agente > Tópicos > Nó do fluxo > Referência de conexão: A referência de conexão deve usar um token OAuth válido, não uma conta pessoal da Microsoft.
- Power Automate > Fluxo > Executar apenas usuários > Copilot Studio: Configure o fluxo para ser executado como o proprietário do fluxo, não como o usuário final, para contornar lacunas de permissão.
Por que o agente do Copilot Studio não consegue chamar o fluxo do Power Automate
O agente do Copilot Studio usa uma referência de conexão para chamar um fluxo do Power Automate. Essa referência de conexão armazena um token de autenticação que o agente envia para o fluxo a cada acionamento. Se o token expirou, está ausente ou vinculado a uma conta de usuário que não tem mais acesso, a chamada do fluxo falha com um erro HTTP 401 Não Autorizado ou 403 Proibido.
Uma segunda causa raiz é o modelo de compartilhamento do fluxo. Por padrão, os fluxos do Power Automate são de propriedade de um único usuário e executados no contexto desse usuário. Quando um agente do Copilot Studio tenta chamar o fluxo, o Power Automate verifica se o chamador — a entidade de serviço do agente — tem permissão explícita para acionar o fluxo. Se o fluxo não foi compartilhado com a entidade de serviço, a chamada é bloqueada.
Uma terceira causa comum é o tipo de gatilho do fluxo. Os agentes do Copilot Studio só podem chamar fluxos que usam o gatilho Quando um fluxo é chamado do Copilot. Se o fluxo usar um gatilho diferente, o agente não conseguirá descobri-lo ou invocá-lo.
Etapas para corrigir a conexão entre agente e fluxo
- Verifique o tipo de gatilho do fluxo
Abra o Power Automate e localize o fluxo que seu agente está tentando chamar. Na página de detalhes do fluxo, verifique o cartão do gatilho. Ele deve dizer Quando um fluxo é chamado do Copilot. Se o gatilho for diferente, exclua o gatilho e adicione o correto do conector do Copilot. Salve o fluxo e teste manualmente para confirmar que ele é executado. - Compartilhe o fluxo com a entidade de serviço do Copilot Studio
No Power Automate, vá para a página de detalhes do fluxo. Selecione Compartilhar no menu superior. No painel de compartilhamento, digite Copilot Studio e selecione a entidade de serviço chamada Copilot Studio no diretório. Defina a permissão como Pode usar. Salve as configurações de compartilhamento. Esta etapa concede ao agente permissão para acionar o fluxo. - Atualize a referência de conexão no Copilot Studio
Abra o Copilot Studio e vá para seu agente. Selecione Tópicos e abra o tópico que contém o nó Chamar um fluxo. Clique no nó para abrir suas propriedades. Em Referência de conexão, selecione a conexão correta que usa sua conta corporativa ou de estudante — não uma conta pessoal da Microsoft. Se a conexão estiver ausente, crie uma nova selecionando Adicionar conexão e faça login com suas credenciais do Microsoft 365. Salve o tópico. - Configure o fluxo para ser executado como o proprietário
No Power Automate, abra o fluxo. Vá para Configurações > Executar apenas usuários. Em Executar como proprietário do fluxo, certifique-se de que Usar esta opção esteja selecionado. Essa configuração força o fluxo a ser executado usando as permissões do proprietário em vez das permissões do chamador. Salve as configurações. Esta etapa contorna problemas de permissão quando o usuário final não tem acesso direto às fontes de dados que o fluxo usa. - Teste o agente no painel de teste
No Copilot Studio, abra seu agente e selecione Testar. Digite uma mensagem que acione o tópico com a chamada do fluxo. Observe o painel de rastreamento. Se o nó do fluxo mostrar uma marca de seleção verde, a chamada foi bem-sucedida. Se mostrar um X vermelho, clique no nó para ver a mensagem de erro. Erros comuns incluem 401 Não Autorizado — verifique novamente a referência de conexão — e 403 Proibido — verifique novamente as configurações de compartilhamento.
Se o agente ainda não conseguir chamar o fluxo após a correção principal
Fluxo retorna 400 Bad Request com JSON inválido
O agente do Copilot Studio envia entradas para o fluxo como JSON. Se o fluxo esperar um esquema diferente, a chamada falha. Abra o fluxo no Power Automate e selecione o gatilho. Clique em Adicionar uma entrada e defina o nome e o tipo da entrada exatamente como o agente a envia. No Copilot Studio, abra o nó do fluxo e verifique se os valores de entrada correspondem ao esquema de entrada do fluxo. Use o painel Testar para inspecionar a carga JSON de saída.
Fluxo é executado, mas não retorna saída para o agente
O agente espera uma resposta do fluxo. Se o fluxo terminar sem uma ação Responder ao Copilot, o agente recebe uma resposta vazia. Abra o fluxo e adicione a ação Responder ao Copilot no final. Nessa ação, defina pelo menos uma propriedade de saída. No Copilot Studio, mapeie as variáveis de saída do fluxo no editor de tópicos para que o agente possa usar os dados retornados.
Copilot Studio mostra fluxo desabilitado ou ausente
O agente só pode ver fluxos que estão ativados e compartilhados com a entidade de serviço do Copilot Studio. No Power Automate, vá para Meus fluxos e verifique se o status do fluxo é Ativado. Se o fluxo estiver Desativado, ative-o. Compartilhe novamente o fluxo com a entidade de serviço do Copilot Studio se o compartilhamento foi removido durante uma cópia ou importação do fluxo.
| Item | Fluxo de propriedade do usuário (padrão) | Fluxo compartilhado com entidade de serviço |
|---|---|---|
| Contexto de autenticação | Executa como a conta de usuário do proprietário do fluxo | Executa como o proprietário do fluxo, mas aceita chamadas da entidade de serviço |
| Permissão necessária | Proprietário do fluxo deve estar conectado | Entidade de serviço deve ter permissão Pode usar |
| Referência de conexão | Usa token OAuth do usuário | Usa token OAuth da entidade de serviço |
| Melhor para | Uso pessoal ou pequenas equipes | Agentes empresariais com vários usuários |
Use a abordagem de fluxo compartilhado com entidade de serviço para qualquer agente do Copilot Studio que será usado por mais de uma pessoa. Esse método garante que o fluxo seja executado mesmo quando o usuário final não tiver uma licença do Power Automate ou acesso direto às fontes de dados do fluxo.
Agora você pode identificar por que seu agente do Copilot Studio não consegue chamar um fluxo do Power Automate e aplicar a correção correta. Comece verificando o tipo de gatilho do fluxo, depois compartilhe o fluxo com a entidade de serviço do Copilot Studio e atualize a referência de conexão no Copilot Studio. Para cenários avançados, configure o fluxo para ser executado como o proprietário e mapeie as saídas do fluxo usando a ação Responder ao Copilot. Essa combinação de etapas resolve mais de 90% das falhas de agente para fluxo.