Simulação de saída

Simulação de saída no Fluxo para testar a lógica subsequente sem executar a ação real de um nó durante uma execução de teste.

A simulação de saída permite definir uma saída fixa para qualquer nó durante uma execução de teste, sem realmente executar a ação real do nó. Isso é útil para testar a lógica downstream quando a ação real é lenta, cara ou requer dependências externas que não estão disponíveis durante uma execução do Debug.

Como a simulação funciona

Quando você habilita uma simulação em um nó, o Fluxo ignora a execução real do nó durante a execução de teste e injeta os valores de saída simulados diretamente. Todos os nós subsequentes recebem os valores simulados como se o nó tivesse sido executado normalmente.

As simulações são aplicáveis apenas durante execuções de teste. Eles nunca estão ativos em fluxos de trabalho de produção publicados.

Configurando uma simulação

1. Selecione o nó que você deseja simular na tela.
2. No painel de configuração, abra a seção Saída simulada .
3. Habilite a alternância de simulação.
4. Insira os valores de saída que você quer injetar. Use JSON válido que corresponda ao esquema de saída do nó.

Resultado: o nó é simulado. Na próxima execução de teste, o Fluxo pula sua execução real e injeta seus valores subsequentes.

Casos de uso comum

• Nós de tarefa humana — Simule uma resposta aprovada ou rejeitada sem esperar um aprovador real.
• Nós de solicitação HTTP — Simule uma resposta de API específica, incluindo respostas de erro, para testar seus caminhos de tratamento de erros.
• Nós de agente — Simule a saída de um agente de IA para testar como seu fluxo de trabalho lida com diferentes respostas do agente.
• Nós de subfluxo — Simule a saída de um fluxo de trabalho filho para testar o fluxo de trabalho pai isoladamente.

Redefinição de simulações

Para executar um fluxo de trabalho com execução real, desabilite a alternância de simulação em cada nó simulado antes de executar o teste. As simulações não são salvas como parte da definição de fluxo de trabalho publicada.

Erros comuns

• Publicação com uma simulação ainda habilitada — As simulações são desabilitadas automaticamente na publicação, portanto, isso não é um risco de produção. Mas se você esquecer de desabilitar uma simulação antes de sua execução de teste final, você estará testando com dados falsos, não com uma execução real.
• Inserção de dados simulados que não correspondem ao esquema de saída do nó — Se o JSON simulado não corresponder à forma que os nós downstream esperam, você receberá erros de runtime downstream que não aconteceriam com dados reais. Corresponda exatamente ao esquema.
• Simulação de muitos nós de uma só vez — Se você simular cinco nós para testar o seis, um teste de aprovação não diz muito. Simule apenas os nós que impedem que você teste a parte com a qual você realmente se importa.

Páginas relacionadas

• Depuração eficaz
• Avaliações
• Nó de tarefa humana
• Nó de agente