Ao chamar um fluxo do Power Automate no Copilot Studio, a resposta esperada pode ficar em branco ou ausente. Isso geralmente acontece quando o fluxo termina sem enviar dados de volta ao tópico do copiloto. A causa raiz costuma ser uma variável de saída ausente ou formatada incorretamente no fluxo. Este artigo explica por que a saída está vazia e fornece uma correção passo a passo para garantir que o fluxo retorne os dados corretamente.
Principais Conclusões: Corrigindo Saída Ausente do Fluxo no Copilot Studio
- Copilot Studio > Tópicos > Ação do fluxo > Variável de saída: O fluxo deve ter uma variável de saída definida que corresponda ao nome usado no tópico do copiloto.
- Power Automate > Fluxo > Ação Response: Adicione uma ação Response ao final do fluxo e defina o corpo JSON de saída com a variável correta.
- Copilot Studio > Painel de teste > Mostrar diagnóstico: Use o painel de diagnóstico para ver a resposta bruta do fluxo e identificar dados ausentes.
Por que um Fluxo do Power Automate Não Retorna Saída no Copilot Studio
O Copilot Studio envia uma solicitação a um fluxo do Power Automate quando um tópico o aciona. O fluxo é executado e deve retornar uma resposta ao copiloto. Se o fluxo não incluir uma ação Response, o copiloto não recebe nada. O fluxo termina com sucesso, mas a variável de saída fica vazia. Essa é a causa mais comum.
Outra causa é uma incompatibilidade entre o nome da variável de saída no fluxo e o nome referenciado no tópico do Copilot Studio. O Copilot Studio espera uma chave JSON específica. Se o fluxo retornar uma chave diferente, o copiloto não consegue ler os dados. A saída aparece em branco.
Uma terceira causa é o fluxo ser executado no contexto errado. Os fluxos do Copilot Studio devem usar o conector Microsoft Dataverse ou o conector Power Automate. Fluxos que usam outros conectores podem não retornar dados corretamente. Além disso, o fluxo deve ser compartilhado com o criador do copiloto ou com o usuário final.
Passos para Corrigir um Fluxo do Power Automate Que Não Retorna Saída
Siga estes passos para identificar e corrigir a saída ausente. Você precisa de acesso de edição tanto no Copilot Studio quanto no Power Automate.
- Abra o tópico do copiloto que chama o fluxo
No Copilot Studio, vá em Tópicos e selecione o tópico que aciona o fluxo. Encontre o nó de ação do fluxo que chama o fluxo do Power Automate. Clique no nó para ver suas propriedades. - Verifique o nome da variável de saída
Nas propriedades da ação do fluxo, procure o campo Variável de saída. Anote o nome exato da variável. O Copilot Studio usa esse nome para ler a resposta. Se esse campo estiver em branco, o copiloto não capturará nenhuma saída. - Abra o fluxo do Power Automate
No Power Automate, encontre o fluxo usado pelo copiloto. Abra o fluxo no modo de edição. Observe a última ação do fluxo. Ela deve ser uma ação Response. Se o fluxo terminar com qualquer outra ação, a saída será perdida. - Adicione uma ação Response
Se o fluxo não tiver uma ação Response, adicione uma. Clique no sinal de mais entre a última ação e o final do fluxo. Pesquise por Response e selecione-a. A ação Response aparece como a etapa final. - Defina o corpo da resposta como um objeto JSON
Na ação Response, defina o campo Corpo como um objeto JSON. Use o mesmo nome de variável do passo 2. Por exemplo, se a variável de saída for “flowOutput”, defina o corpo como:{ "flowOutput": "@outputs('NomeDaAcaoAnterior')" }. Substitua NomeDaAcaoAnterior pelo nome da ação que produz os dados. - Salve e teste o fluxo
Salve o fluxo no Power Automate. Volte ao Copilot Studio. Abra o painel de teste e execute o tópico que chama o fluxo. No painel de teste, clique em Mostrar diagnóstico para ver a resposta bruta. Procure a variável de saída no JSON de resposta. Se a variável aparecer com dados, a correção funciona. - Verifique se o fluxo está compartilhado
No Power Automate, vá para a página de detalhes do fluxo. Clique em Compartilhar e confirme que o criador do copiloto ou o usuário final tem acesso. Se o fluxo não estiver compartilhado, o copiloto não pode acioná-lo.
Se o Copilot Studio Ainda Mostrar Saída Ausente Após a Correção Principal
Às vezes, a correção básica não resolve o problema. Abaixo estão outros padrões de falha e suas soluções específicas.
Fluxo Retorna Dados, mas o Copiloto Mostra em Branco
Isso acontece quando a estrutura JSON não corresponde ao que o Copilot Studio espera. Abra a ação Response e confirme se a chave JSON corresponde exatamente ao nome da variável de saída. Use letras minúsculas e sem espaços. Por exemplo, se a variável for “orderNumber”, a chave JSON deve ser “orderNumber”, não “OrderNumber”.
Fluxo Executa, mas Falha com Erro 400 ou 500
Verifique o histórico de execução do fluxo no Power Automate. Abra o fluxo e selecione Histórico de execução. Procure execuções com falha. Erros comuns incluem permissões ausentes, parâmetros de entrada inválidos ou limites do conector. Corrija o erro no fluxo e execute o teste novamente.
Fluxo Não Aciona de Forma Alguma
Se o fluxo nunca for executado, o gatilho pode estar mal configurado. No Copilot Studio, abra o nó de ação do fluxo e verifique se o fluxo está selecionado corretamente. Clique no botão de atualizar para recarregar a lista de fluxos disponíveis. Além disso, certifique-se de que o fluxo está configurado para ser acionado por um copiloto. No Power Automate, o gatilho deve ser “Quando um copiloto chama um fluxo” ou similar.
Variável de Saída Mostra Nulo
Se a resposta contém a variável, mas seu valor é nulo, a ação anterior no fluxo não produziu dados. Abra o fluxo e verifique a ação que gera os dados. Confirme se a ação retorna um valor. Por exemplo, se você usa uma ação Obter item, verifique se o item existe e se a ação está configurada para retornar todos os campos.
Saída do Fluxo no Copilot Studio: Comparação de Configurações Comuns
| Item | Configuração Correta | Configuração Incorreta |
|---|---|---|
| Ação Response presente | Última ação é Response | Última ação é Compose ou Terminate |
| Formato do corpo da resposta | JSON válido com chave correspondente | Texto simples ou chave ausente |
| Nome da variável de saída no Copilot Studio | Corresponde exatamente à chave JSON | Diferença de maiúsculas/minúsculas ou ortografia |
| Compartilhamento do fluxo | Compartilhado com o criador do copiloto | Privado ou compartilhado com usuário errado |
| Gatilho do fluxo | Quando um copiloto chama um fluxo | Gatilho manual ou agendado |
Após fazer essas alterações, teste o fluxo novamente no Copilot Studio. Use o painel de diagnóstico para confirmar se a variável de saída contém os dados esperados. A resposta em branco agora deve mostrar as informações corretas do fluxo.
Se o fluxo ainda não retornar saída, revise o histórico de execução do fluxo em busca de erros. Verifique os parâmetros de entrada passados do Copilot Studio. Certifique-se de que o fluxo usa o conector Microsoft Dataverse ou o conector Power Automate. Evite usar conectores de terceiros que podem não suportar a integração com o copiloto. Você também pode criar um fluxo de teste simples que retorna um valor JSON estático para isolar se o problema está na lógica do fluxo ou na integração em si.