e.agent
Automação com construtor visual e aprovação humana quando importa.
- Automation
- Visual builder
- Tools
- Human-in-the-loop
- Schedules
Visão geral
O e.agent transforma tarefas repetitivas em fluxos executáveis. Um agente combina gatilhos (agenda, webhook, mensagem no e.chat, evento do e.gateway), passos de raciocínio servidos pelo e.brain e ferramentas que atuam em sistemas externos. Passos sensíveis podem exigir aprovação humana, com contexto completo e registo no e.audit.
Funcionalidades principais
Construtor visual
Canvas de nós com ramificações, ciclos, tratamento de erros e variáveis tipadas.
Human-in-the-loop
Nó de aprovação que envia o pedido para o e.chat ou email e aguarda decisão com prazo.
Biblioteca de ferramentas
HTTP, SQL, ficheiros, email e conectores do e.gateway, com esquemas de entrada validados.
Execuções observáveis
Cada execução guarda entradas, saídas, custo e duração por nó, com repetição a partir de qualquer passo.
Ambientes e versões
Rascunho, teste e produção, com promoção controlada e rollback.
Guia de utilização
- 1
Criar o agente
Escolha um modelo em branco ou parta de um exemplo (triagem, relatório, reconciliação).
- 2
Definir o gatilho
Agenda cron, webhook assinado, comando no e.chat ou evento do e.gateway.
yamltrigger: type: schedule cron: "0 7 * * 1-5" timezone: Europe/Lisbon - 3
Adicionar passos e ferramentas
Ligue nós de raciocínio a ferramentas. Cada ferramenta declara o seu esquema de entrada.
yamlsteps: - id: fetch tool: gateway.query with: { connector: crm, query: "open_tickets_last_24h" } - id: summarize model_profile: balanced prompt: "Agrupa os tickets por tema e destaca riscos." - id: approve type: human_approval channel: e.chat approvers: ["group:support-leads"] timeout: 4h - id: post tool: chat.post with: { channel: "#suporte", text: "{{summarize.output}}" } - 4
Testar em modo seco
Execute sem efeitos externos; as ferramentas devolvem respostas simuladas registadas na execução.
- 5
Promover para produção
Publique a versão, defina limites de execução e alertas de falha.
Casos de uso comuns
Triagem de tickets
Classifica, encaminha e responde a pedidos simples com aprovação por amostragem.
Relatório diário
Compila métricas de vários sistemas e publica no canal certo às 7h.
Onboarding de colaborador
Cria contas, envia materiais e agenda formações, com validação do gestor.
Checklist de configuração
- Gatilho e fuso horário confirmados
- Ferramentas com credenciais de menor privilégio
- Passos irreversíveis protegidos por aprovação humana
- Execução em modo seco validada
- Alertas de falha ligados a um canal monitorizado
- Limite de custo por execução definido no e.brain
- Execuções auditadas no e.audit