06 / Operação · Arquitetura agêntica · Pessoa no circuito
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 no projeto
- Arquitetura e desenvolvimento
- Stack
- n8n
- OpenAI
- Gemini
- Whisper
- Postgres
- Redis
- Google Calendar
- Google Drive
- Evolution API
- Notion
Números do projeto
- workflows
- 8
- tabelas
- 7
- dos crons em menos de 1 s
- ~95%
Nomes de empresas, clientes e pessoas foram omitidos.
I / O problema
Agenda, tarefas e ações de reuniões ficavam espalhadas, e tudo dependia de registro manual.
II / A solução
Um 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.
Fluxo
Como funciona
assistente-multiagente.workflow
- gatilho
- processo
- IA
- pessoa
- saída
01gatilho
WhatsApp
Texto ou áudio (Whisper), com debounce e circuit breaker.
02IA
Agente central
GPT-4.1 mini com Gemini de reserva; só conversa com sub-workflows.
03processo
Sub-workflows
Cada ferramenta guarda a própria credencial e serve o agente e os crons.
04gatilho
Crons e transcrições
Resumos no horário do cliente; reuniões do Drive viram tarefas.
05pessoa
Confirmação humana
Ações de risco passam por confirmação; as proibidas nem existem.
06saída
Agenda e tarefas
Google Calendar e o quadro de tarefas no Notion.
Em detalhe · Segurança por construção
O que é perigoso não depende de o modelo obedecer.
Cada ação tem uma classe de risco definida no grafo do fluxo, não no prompt. A ação proibida não é recusada pelo modelo: ela simplesmente não existe.
01
Segura
Executa direto
Leituras e ações sem efeito colateral relevante.
02
Risco
Só com confirmação
O assistente pergunta no WhatsApp e espera o sim antes de agir.
03
Proibida
Não existe no grafo
Ações destrutivas sem confirmação não têm caminho: o agente não tem como chamá-las.
Proteções no canal
- circuit breaker por conversa
- 12/min
- camadas de dedupe nas transcrições
- 3
- destino possível: o da ficha do cliente
- 1
Horário ambíguo nunca vira evento: vira a tarefa “marcar horário”.
Por dentro
O sistema, como ele é
assistente-multiagente/core-agent
assistente-multiagente/tools
Decisões técnicas
O que faz o fluxo ser confiável
- 01
Uma ferramenta, dois consumidores.
O agente nunca fala com API externa, só com sub-workflows; a credencial mora na ferramenta, que também serve os crons.
- 02
Segurança por construção.
Ações classificadas como segura, risco ou proibida; as destrutivas nem existem no grafo sem confirmação.
- 03
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.
- 04
Proteções no canal.
Debounce, circuit breaker (12 mensagens por minuto) e anti-eco com Redis.
- 05
Idempotência.
Claim atômico (INSERT … ON CONFLICT) e dedupe em 3 camadas nas transcrições.
- 06
Ambiguidade vira tarefa.
Horário ambíguo nunca vira evento: vira a tarefa “marcar horário”.
- 07
Multi-tenant de verdade.
Trocar de cliente não exige editar nenhum nó.
- 08
Observabilidade.
Tokens, modelo e ferramentas 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.
Qual destes fluxos resolve o seu gargalo?
Quatro perguntas e uma calculadora. A recomendação sai na hora, a partir do seu processo.