Arquitetura agêntica · Human-in-the-loop
Assistente pessoal multiagente
Um assistente no WhatsApp que cuida de agenda, tarefas e ações de reunião, com segurança por construção.
- Status
- Em produção
- Papel
- Arquitetura e desenvolvimento
- Stack
- n8n
- OpenAI
- Gemini
- Whisper
- Postgres
- Redis
- Google Calendar
- Google Drive
- Evolution API
- Notion
Resultados
- workflows
- 8
- tabelas
- 7
- dos crons em < 1 s
- ~95%
Problema
Agenda, tarefas e ações de reuniões ficavam espalhadas, e tudo dependia de registro manual.
Solução
Assistente no WhatsApp (texto ou áudio) com acesso à agenda e a um quadro de tarefas no Notion; envia resumos diários e semanais no horário do cliente e transforma transcrições de reunião em tarefas e eventos sem intervenção.
Como funciona
01Trigger
WhatsApp
Texto ou áudio (Whisper), com debounce e circuit breaker.
02AI
Agente central
GPT-4.1 mini com Gemini de fallback; só conversa com sub-workflows.
03Process
Sub-workflows
Cada ferramenta guarda a própria credencial e serve o agente e os crons.
04Trigger
Crons e transcrições
Resumos no horário do cliente e reuniões do Drive viram tarefas.
05Process
Confirmação humana
Ações de risco passam por confirmação; as proibidas nem existem.
06Output
Agenda e tarefas
Google Calendar e o quadro de tarefas no Notion.
Por dentro do sistema
Workflow do agente central
Sub-workflow de agenda (tool)
Decisões técnicas
- Um tool, dois consumidores. O agente nunca fala com API externa, só com sub-workflows; a credencial mora na ferramenta, que também serve os crons.
- Segurança por construção. Ações classificadas como segura, risco ou proibida; as destrutivas nem existem no grafo sem confirmação.
- Destino fixo. O remetente ignora o destino pedido pelo LLM e usa só o da ficha do cliente, fechando a porta para alucinação e prompt injection.
- Proteções no canal. Debounce, circuit breaker (12 msg/min) e anti-eco com Redis.
- Idempotência. Claim atômico (
INSERT … ON CONFLICT) e dedupe em 3 camadas nas transcrições. - Ambiguidade vira tarefa. Horário ambíguo nunca vira evento: vira a tarefa “marcar horário”.
- Multi-tenant provado. Trocar de cliente não exige editar nenhum nó.
- Observabilidade. Tokens, modelo e tools registrados por interação, base para precificação; harness de testes para as allowlists.
Resultado
Agenda, tarefas e ações de reunião num só lugar, sem registro manual, e com as ações perigosas travadas por construção.