Esta guia explica como criar, configurar e automatizar um workflow para o seu AI Worker na Darwin.
🔎 Antes de começar
🎯 Defina o objetivo do workflow
(exemplo: qualificar leads, reativar contatos, suporte, cobrança).🧭 Liste as etapas necessárias
e determine quais condições farão uma conversa avançar dentro do flux
🏗️ Passo 1 — Criação de Pipeline
Acesse a seção Pipelines.
Clique em Editar (no canto superior direito) e depois em Criar Pipeline.
────────────────────────────────────────
🧩 Passo 2 — Criação de Etapas
Você pode criar etapas de duas maneiras.
📍 Opção A: a partir de Pipelines
Dentro do pipeline, clique em Adicionar etapa.
Complete Nome, Descrição e Tipo.
Tipos disponíveis:
🤖 Automated: a IA atende automaticamente esta etapa.
👤 Human Intervention: a etapa é atendida por uma pessoa (pelo mesmo canal da IA).
🚨 Escalation (recomendado configurar em todos os pipelines): para conversas escaladas por SEVERE_ANGER (raiva severa), HUMAN_TRANSFER (solicitação de falar com um assessor), PROMPT_INJECTION (tentativa de manipular a IA) ou escaladas manualmente.
🛑 Checkpoint: permite selecionar outro pipeline para acesso rápido (os pipelines podem ser conectados entre si).
🧰 Opção B: a partir de Workforce > Automações de Etapas
Acesse Workforce > Automações de Etapas.
Localize o pipeline criado e selecione Criar nova etapa (a configuração é igual à da Opção A).
⚠️ Importante: sempre inclua uma etapa de Escalation para garantir o tratamento adequado de casos sensíveis.
────────────────────────────────────────
⚙️ Passo 3 — Automação de Etapas
Vá até Workforce e selecione o worker correspondente.
Acesse Automações de Etapas.
Na primeira etapa criada, clique em “Atender esta etapa com [Nome da IA]”. Você verá as seguintes seções:
🎯 a) Objetivo
Descreva com precisão o que a IA deve fazer nesta etapa: ações, perguntas, validações e restrições.
Modelo sugerido (copiar e adaptar):
Objetivo da etapa:
Propósito: descreva o objetivo principal (ex.: qualificar o lead com 3 perguntas).
Ações: detalhe as tarefas (ex.: solicitar orçamento mensal, modelo de interesse, estado/região).
Restrições: indique limites (ex.: o valor do orçamento mensal deve ser informado em USD).
Tom e estilo: especifique o tom (ex.: formal, conciso e empático).
🛠️ b) Ferramentas
Se houver um catálogo, uma função Python ou um MCP disponível, selecione-o para que a IA possa usá-lo nesta etapa.
No campo Objetivo, indique de forma explícita quando e como a ferramenta deve ser utilizada.
Exemplo de instrução dentro do Objetivo:
Sempre que a pessoa consultar sobre produtos, use a ferramenta ‘catalogo_produtos’.
🔗 c) Próximas etapas
Conecte a etapa atual às seguintes, definindo condições.
Conectar etapa quando: especifique a condição que habilita o avanço.
Ex.: “quando o humano mencionar seu orçamento mensal, o modelo de interesse e a região”.
Próxima etapa: escolha uma no menu suspenso. Se ainda não existir, selecione Criar nova etapa.
É possível configurar múltiplas conexões de saída com base em diferentes condições.
🧪 d) Teste rápido da etapa (sem salvar)
Antes de salvar, é possível testar o que foi configurado na etapa diretamente nesta tela, na seção “Testar o comportamento desta etapa”.
O teste:
É executado com a configuração exibida em tela.
Não persiste alterações nem exige salvar previamente.
Permite validar prompts, lógica e uso de ferramentas.
Passos sugeridos:
Clique em Testar etapa.
Insira uma mensagem de exemplo e execute o teste.
Revise a conversa simulada e o uso de ferramentas.
Ajuste Objetivo/condições se necessário e test
🧪 Testes e verificação
Verifique se o Objetivo está sendo cumprido e se a IA pergunta/age conforme o esperado.
Confirme que as Ferramentas são acionadas quando necessário.
Revise se as condições em Próximas etapas direcionam corretamente.
Utilize o Teste rápido da etapa para iterar antes de salvar.
Você pode testar o workflow completo na seção do menu “Testar Agora”.
🌟 Boas práticas
Uma intenção por etapa: mantenha cada etapa focada em um objetivo específico.
Nomenclatura consistente: facilite a manutenção futura.
Mensagens claras: indique à IA restrições e critérios de sucesso de forma explícita.
🗂️ Glossário breve
Pipeline: contêiner do workflow (objetivo geral e etapas).
Etapa: passo dentro do pipeline (Automated, Human Intervention, Escalation, Checkpoint).