O que é
O Sócio é um agente de IA para o dono de um restaurante pequeno que vende pelo iFood. Ele trabalha onde o dono já está, no WhatsApp, e em um painel web. Cuida das tarefas repetitivas da loja: cadastrar o cardápio, responder avaliações, explicar as vendas e resumir o dia. Toda mudança na loja passa antes pela aprovação do dono.
O que ele faz
- Cardápio por foto: o dono fotografa o cardápio de papel. O agente extrai itens, descrições e preços, monta um rascunho e avisa quando um preço foge muito do padrão dos outros itens.
- Avaliações: de hora em hora, o agente lê as avaliações novas, separa por tipo e redige uma resposta para cada uma. O dono aprova, ajusta ou descarta.
- Analista de vendas: o dono pergunta, em texto ou áudio, algo como “o que mais vendeu na sexta?”. O agente transforma a pergunta em uma consulta ao banco e responde em duas ou três frases, com um gráfico.
- Briefing diário: todo dia às 10h, o dono recebe no WhatsApp um áudio curto com os números do dia anterior.
Como funciona
As mensagens do WhatsApp chegam pelo n8n, que cuida de webhooks, rotinas agendadas, novas tentativas e botões de aprovação. O painel web usa as mesmas rotas da API. As duas entradas chegam a um orquestrador, que passa cada pedido ao agente certo: Cardápio, Avaliações ou Analista. Cada agente usa o modelo mais barato que dá conta da tarefa. Leitura de imagem, classificação rápida, redação e transcrição de áudio podem ficar com modelos diferentes, e a troca é feita por configuração, sem mudar código.
Os dados ficam no Supabase (Postgres, com busca por similaridade e armazenamento das fotos). A integração com o iFood fica atrás de uma interface própria, com uma versão simulada no mesmo formato. Assim o projeto roda e é testado sem uma loja real, e a troca para a versão real é feita por uma variável de ambiente.
Os mesmos serviços também ficam disponíveis por um servidor MCP, para que outros agentes de IA usem as ferramentas da loja.
Regras de segurança
- Nada é publicado sem aprovação: nenhuma ferramenta de escrita (catálogo, resposta, envio) roda sem uma aprovação válida registrada.
- Texto de terceiros é só dado: avaliações, fotos e mensagens de clientes nunca viram instrução para o agente.
- Consultas só de leitura: o Analista consulta o banco com um usuário restrito, só em visões preparadas, com limite de linhas e de tempo.
- Dados pessoais protegidos: nome e telefone de clientes são mascarados antes de chegar ao modelo.
- Tudo fica registrado: cada execução guarda o custo, cada decisão do dono fica na fila de aprovações e o tempo economizado também é registrado.
Como a qualidade é medida
A leitura do cardápio será comparada com um gabarito feito à mão, e os testes de qualidade vão rodar no CI com o promptfoo. Um modelo diferente do avaliado faz o papel de juiz. O rastreamento de cada chamada aos modelos fica no Langfuse, e os custos aparecem no painel.
Fora do escopo
O Sócio não aceita nem recusa pedidos e não faz nenhuma operação que movimente dinheiro.
Como está sendo construído
O projeto é construído com o Claude Code, uma tarefa por sessão, seguindo um roadmap de 25 tarefas em quatro fases: base, primeira versão, agentes e prova com um restaurante de verdade. A base do monorepo já está pronta. Agora vêm o banco de dados, a integração simulada com o iFood e o agente de cardápio, que formam a primeira versão.