Pular para o conteúdo principal

Fluxo de Execucao

O engine inicia no trigger, resolve entradas do node, executa o executor, grava saidas no contexto e segue pelas edges da porta correspondente.

Ciclo de execucao em 5 etapas​

  1. Trigger recebe o evento.
  2. Engine monta contexto inicial.
  3. Node atual executa com dados de entrada.
  4. Saida do node e registrada no contexto.
  5. Proximo node e escolhido pelas edges.

Cenario completo: WhatsApp + integracao + fallback​

Use este cenario como referencia de desenho operacional:

  1. WA Trigger recebe mensagem do cliente.
  2. AI Node classifica intencao e nivel de confianca.
  3. Switch Node decide entre autoatendimento e atendimento humano.
  4. HTTP Request ou node nativo consulta sistema externo.
  5. WA Send Text responde ao cliente.
  6. Em erro externo, fluxo cai para fallback e avisa equipe.

Preview no FlowBuilder

Este exemplo abre direto no FlowBuilder embedado. A visualizacao em Fluxo/JSON, simulacao e operacoes do flow ficam dentro do proprio editor.

Nao foi possivel carregar o preview embedado automaticamente.

Objetivo de tempo por etapa​

  • Trigger + parse inicial: ate 100ms
  • Classificacao de intencao: ate 800ms
  • Consulta externa: ate 1200ms
  • Resposta final: ate 300ms

Se uma etapa ultrapassa o alvo, priorize timeout + fallback antes de publicar.

Onde costuma falhar​

  • Entrada incompleta no trigger
  • Variavel com caminho invalido
  • Node externo com timeout ou erro de autenticacao
  • Rota de saida sem conexao

Como investigar lentidao​

  1. Identifique qual node concentra maior tempo.
  2. Verifique chamadas externas e timeout.
  3. Separe passos pesados em SubFlow.
  4. Revalide com simulacao e payload real.

Ponto de controle de fallback​

Todo node externo critico deve ter:

  • timeout definido
  • estrategia de retry com limite
  • caminho alternativo para nao interromper atendimento
  • mensagem clara para o operador quando houver degradacao

Boas praticas​

  • Mantenha cada node com responsabilidade unica.
  • Evite cadeias muito longas sem logs/observabilidade.
  • Use SubFlow para blocos repetitivos.

Proximo passo​

Continue em Variaveis e Contexto para reduzir falhas de leitura de dados durante a execucao.