Visão Geral
O Workflow Agent é o tipo mais avançado e flexível de agente na plataforma Evo AI. Utilizando LangGraph como engine de execução e React Flow para interface visual, permite criar workflows complexos com múltiplos tipos de nodes, condições, delays e controle de fluxo sofisticado. Diferentemente dos outros tipos de agentes (Sequential, Parallel, Loop), o Workflow Agent oferece controle granular sobre cada etapa do processo, permitindo criar lógicas de negócio complexas com ramificações condicionais, loops customizados e orquestração avançada.Baseado em LangGraph: Implementação usando LangGraph para execução de workflows e React Flow para interface visual de construção.
Características Principais
Interface Visual
Construção drag-and-drop com React Flow para workflows intuitivos
LangGraph Engine
Execução robusta baseada em LangGraph para workflows complexos
Múltiplos Node Types
Agent, Message, Condition e Delay nodes para máxima flexibilidade
Teste Integrado
Teste individual de agentes e teste completo do workflow
Tipos de Nodes
1. Agent Node
Agent Node - Núcleo do Workflow
Agent Node - Núcleo do Workflow
Função: Executa agentes (novos ou existentes) como parte do workflowConfigurações:
Formulário de configuração:
- Selecionar Agente Existente: Escolha de agentes já criados na plataforma
- Criar Novo Agente: Criação inline de agente específico para o workflow
- Editar Agente: Modificação de agentes existentes
- Input Mapping: Mapeamento de dados de entrada
- Output Key: Chave para armazenar resultado no contexto


2. Message Node
Message Node - Controle de Etapas
Message Node - Controle de Etapas
Função: Envia mensagens diretas como agente no fluxo, ideal para controle de etapasConfigurações:Casos práticos:Status de Progresso:Contexto para Próxima Etapa:
Formulário de configuração:
- Type: Tipo da mensagem (atualmente apenas “Texto” disponível)
- Content: Conteúdo da mensagem a ser enviada
- Texto: Mensagem em formato texto simples
- Instruções para próximos nodes: Orientações específicas para agentes subsequentes
- Mensagens de status: Informações sobre progresso do workflow
- Dados estruturados: Informações formatadas para processamento
- Controle de contexto: Mensagens que definem contexto entre etapas
- Notificações: Avisos sobre estados ou condições específicas
- Logs de processo: Registros de etapas importantes do workflow


3. Condition Node
Condition Node - Controle de Fluxo
Condition Node - Controle de Fluxo
Função: Verifica output do node anterior e direciona execução baseado em condiçõesCondition Type:Verificação de Score de Qualidade:Verificação de Status de Execução:Verificação com Regex:Como configurar:
Formulário de configuração:
Dialog de adição de condição:
- Previous output: Valida o resultado retornado pelo node anterior (único tipo disponível)
- Output Field: Campo do output anterior para verificar (Content ou Status)
- Operator: Operador de comparação
- Comparison Value: Valor para comparação
- Preview: Visualização da condição configurada
- Content: Conteúdo da resposta do node anterior
- Status: Status de execução do node anterior
- is defined: Verifica se o campo está definido
- is not defined: Verifica se o campo não está definido
- is equal to: Campo é igual ao valor especificado
- is not equal to: Campo não é igual ao valor especificado
- contains: Campo contém o texto especificado
- does not contain: Campo não contém o texto especificado
- starts with: Campo inicia com o texto especificado
- ends with: Campo termina com o texto especificado
- is greater than: Campo é maior que o valor numérico
- is greater than or equal to: Campo é maior ou igual ao valor
- is less than: Campo é menor que o valor numérico
- is less than or equal to: Campo é menor ou igual ao valor
- matches the regex: Campo corresponde à expressão regular
- does not match the regex: Campo não corresponde à regex
- Selecione “Previous output” como Condition Type
- Escolha o Output Field (Content ou Status)
- Selecione o Operator apropriado
- Digite o Comparison Value
- Verifique o Preview da condição
- Configure os caminhos True/False conectando as saídas



4. Delay Node
Delay Node - Controle de Tempo
Delay Node - Controle de Tempo
Função: Adiciona delays simples no workflow para controle de timingConfigurações:Delay para Processamento:Delay para Priorização:Delay para Agendamento:Casos práticos:
Formulário de configuração:
- Delay Value: Valor numérico do delay
- Time Unit: Unidade de tempo (segundos, minutos, horas, dias)
- Description: Descrição opcional do propósito do delay
- Segundos: Para delays curtos (1-59 segundos)
- Minutos: Para delays médios (1-59 minutos)
- Horas: Para delays longos (1-23 horas)
- Dias: Para delays muito longos (1+ dias)
- Rate limiting: Evitar sobrecarga de APIs externas
- Aguardar processamento: Tempo para sistemas externos processarem
- Simular tempo humano: Delays realistas em automações
- Controle de throughput: Gerenciar velocidade de processamento
- Agendamento: Delays para horários específicos
- Priorização: Delays diferentes baseados em prioridade


Criando um Workflow Agent
Passo a Passo na Plataforma
1. Iniciar criação
1. Iniciar criação
- Na tela principal do Evo AI, clique em “New Agent”
- No campo “Type”, selecione “Workflow Agent”
- Você verá a interface visual do React Flow

2. Configurar informações básicas
2. Configurar informações básicas
Name: Nome descritivo do workflowDescription: Resumo do workflow complexoGoal: Objetivo do workflow
3. Construir workflow visual
3. Construir workflow visual
Interface React Flow:Palette de Nodes: Arraste nodes da palette para o canvas
Menu de Content Nodes:
Menu de Logic Nodes:
- 🤖 Agent Node - Para executar agentes
- 💬 Message Node - Para mensagens diretas
- 🔀 Condition Node - Para lógica condicional
- ⏱️ Delay Node - Para delays temporais



4. Configurar nodes individuais
4. Configurar nodes individuais
Para cada node no workflow:Agent Nodes:
- Selecione agente existente ou crie novo
- Configure input mapping
- Defina output key
- Escreva conteúdo da mensagem
- Use variáveis do contexto
- Configure tipo de mensagem
- Defina lógica de verificação
- Configure caminhos true/false
- Teste condições
- Configure duração
- Defina condições de skip
- Configure delays dinâmicos
5. Conectar e validar fluxo
5. Conectar e validar fluxo
Conexões entre nodes:
- Arraste da saída de um node para entrada do próximo
- Valide que todas as conexões fazem sentido
- Configure múltiplas saídas para Condition Nodes
- Verificação de loops infinitos
- Validação de tipos de dados
- Checagem de nodes órfãos
- Verificação de caminhos completos
- Todo workflow precisa de um Start node
- Configure End nodes para diferentes cenários
Exemplos Práticos
1. Pipeline de Aprovação de Conteúdo
Estrutura do Workflow
Estrutura do Workflow
Objetivo: Automatizar aprovação de conteúdo com múltiplas verificaçõesFluxo do workflow:Configuração detalhada:1. Message Node: “Instrução Inicial”2. Agent Node: “Analisador de Qualidade”3. Condition Node: “Score >= 8.0?”4. Agent Node: “Aprovação Automática”5. Agent Node: “Revisão Manual”6. Condition Node: “Aprovado na Revisão?”7. Delay Node: “1 hora”
2. Workflow de Análise de Leads
Estrutura do Workflow
Estrutura do Workflow
Objetivo: Processar leads com análise inteligente e roteamento automáticoFluxo do workflow:Nodes principais:1. Agent Node: “Enriquecedor de Dados”
- Enriquece dados do lead com informações públicas
- Output: dados_enriquecidos
- Calcula score baseado em critérios
- Input: dados_enriquecidos
- Output: lead_score
- Filtra leads de baixa qualidade
- Condition: score maior que 70
- Identifica leads VIP
- Condition: score maior que 90
- Roteador VIP: Para vendedores sênior
- Roteador Normal: Para vendedores padrão
- VIP: 5 minutos (alta prioridade)
- Normal: 30 minutos (prioridade padrão)
3. Workflow de Processamento de Documentos
Estrutura do Workflow
Estrutura do Workflow
Objetivo: Processar documentos com validação e aprovação automáticaFluxo complexo com loops:
Funcionalidades de Teste
Teste Individual de Agentes
Agent Form Test
Agent Form Test
Teste de agentes individuais dentro do workflow:Como usar:
- Clique em qualquer Agent Node no workflow
- Selecione “Test Agent” no menu contextual
- Configure inputs de teste
- Execute teste isolado
- Analise outputs e performance
- Validação rápida de agentes individuais
- Debug de problemas específicos
- Teste de diferentes inputs
- Verificação de outputs esperados
Teste Completo do Workflow
Test Workflow
Test Workflow
Teste do workflow completo com dados reais:Como usar:Interface de teste do workflow:
- Clique em “Test Workflow” na barra superior
- Configure inputs iniciais do workflow
- Execute teste completo
- Acompanhe execução em tempo real
- Analise resultados finais
- Execução passo a passo: Veja cada node sendo executado
- Visualização de dados: Acompanhe dados fluindo entre nodes
- Breakpoints: Pause execução em nodes específicos
- Logs detalhados: Registros completos de execução
- Performance metrics: Tempo de execução por node

Monitoramento e Debugging
Dashboard de Execução
Monitoramento em Tempo Real
Monitoramento em Tempo Real
Acompanhamento visual da execução:Visualização no React Flow:Alertas e notificações:
- Nodes ativos destacados em verde
- Nodes completados marcados com ✓
- Nodes com erro marcados com ✗
- Fluxo de dados visualizado nas conexões
- Falhas de execução
- Timeouts de nodes
- Loops infinitos detectados
- Performance degradada
Debugging Avançado
Debugging Avançado
Ferramentas de debug específicas:1. Breakpoints Visuais2. Data Inspector3. Execution Replay4. Performance Profiler
Configurações Avançadas
Otimização de Performance
Otimização de Execução
Otimização de Execução
Estratégias para workflows eficientes:Paralelização Inteligente:Caching de Resultados:Resource Management:
Resiliência e Confiabilidade
Resiliência e Confiabilidade
Configurações para workflows robustos:Error Handling:State Management:Monitoring e Alerting:
Output Key - Resultado do Workflow
Output Key - Resultado do Workflow
Campo Resultado do workflow:Uso em outros agentes:Boas práticas:
Output Key
na interface:O Output Key permite que o Workflow Agent salve o resultado final do workflow complexo em uma variável específica no estado compartilhado, tornando-o disponível para outros agentes ou processos.Como funciona:- Configure o campo
Output Key
com um nome descritivo - O resultado final do workflow (último node executado) será salvo automaticamente
- Outros agentes podem acessar usando placeholders
{{output_key_name}}
- Funciona em workflows aninhados, loops e sistemas multi-agente
- Use snake_case:
workflow_resultado
,processo_completo
- Seja específico:
aprovacao_credito_workflow
em vez deworkflow
- Documente estrutura do resultado final
- Considere incluir metadados de execução (path, timing, status)
- Use nomes que reflitam o processo de negócio
- Configure o último node para produzir resultado estruturado
Melhores Práticas
Design de Workflows
Design de Workflows
Princípios para workflows eficazes:
- Modularidade: Divida workflows complexos em sub-workflows
- Idempotência: Garanta que re-execuções sejam seguras
- Observabilidade: Adicione logging e monitoramento adequados
- Error handling: Trate falhas graciosamente
- Performance: Otimize caminhos críticos
Colaboração e Manutenção
Colaboração e Manutenção
Práticas para equipes:
- Documentação: Documente propósito de cada node
- Versionamento: Use controle de versão para workflows
- Testing: Implemente testes automatizados
- Code review: Revise workflows antes de produção
- Monitoring: Monitore performance e confiabilidade
Casos de Uso Comuns
Aprovação de Conteúdo
Workflows de Qualidade:
- Análise automática de qualidade
- Aprovação condicional
- Loops de correção
Processamento de Leads
Qualificação Inteligente:
- Enriquecimento de dados
- Scoring automático
- Roteamento inteligente
Automação de Processos
Business Process Automation:
- Workflows de aprovação
- Processamento de documentos
- Integração de sistemas
Análise de Dados
Pipelines de Dados:
- ETL complexos
- Análise multi-etapa
- Relatórios automáticos
Próximos Passos
Sequential Agent
Compare com workflows sequenciais simples
Parallel Agent
Entenda execução paralela básica
Loop Agent
Explore loops iterativos simples
A2A Agent
Integre agentes externos em workflows
O Workflow Agent é a ferramenta mais poderosa para criar automações complexas. Use-o quando precisar de controle granular sobre cada etapa do processo e lógica de negócio sofisticada com múltiplas condições e caminhos de execução.