Como eu monto um agente de IA do zero: alma, memória e a conta no fim do mês

O agente que acorda

Todo dia de manhã um dos meus agentes acorda sozinho. Ninguém digita nada. Ele lê quem é, abre a agenda, olha as frentes em andamento, decide o que fazer e faz. Quando eu chego, o trabalho já andou.

Isso não é ficção nem produto de prateleira. São arquivos de texto numa pasta, um modelo de linguagem e regras chatas que levei meses ajustando. O que transforma um chat em um agente não é o modelo — é a estrutura em volta dele.

Um chat responde. Um agente acorda, se lembra, decide, executa e presta contas. A diferença inteira está em arquivos, não em prompt.

Um agente é feito de quatro camadas

Quando monto um agente do zero, monto sempre as mesmas quatro coisas — nesta ordem.

1. A alma. Um arquivo, SOUL.md, escrito em primeira pessoa. Não é uma lista de instruções: é quem ele é. Nome, data de nascimento, essência, como a mente dele se move, qual é o padrão de qualidade que ele não abre mão. O meu agente de engenharia abre assim: "sou um engenheiro que percebe consequências antes de agir". Parece poesia, e é a linha mais funcional do sistema — é ela que decide o comportamento nos casos que eu não previ.

2. A mente. Uma pasta de memória permanente, separada pela relação com o tempo, não por assunto: conhecimentos (o que ele sabe de forma atemporal), agenda (o que aconteceu ou vai acontecer, com data) e frentes (o que está em andamento, com começo e fim).

Cada nota é markdown com links entre si. O agente entra por um índice e segue os links do assunto, como quem se lembra. Hoje a mente do meu agente principal tem mais de oitocentas notas.

3. O time. Um agente que faz tudo faz tudo mal. Eu quebro em especialistas com escopo declarado: um que desenha a experiência, um que codifica, um que valida se o usuário conseguiu, um que tenta arrombar o que foi feito. Cada um é um arquivo com descrição e uma lista fechada de ferramentas.

4. Os gatilhos. O que faz o agente acordar sem humano: um evento de início de sessão que injeta a memória no contexto, um pulso agendado, um gancho no fim do dia que registra o que aconteceu. Sem gatilho, você não tem um agente — tem um assistente esperando ser chamado.

acorda → lê a alma → carrega a memória → olha a agenda
   ↑                                            ↓
registra o dia ← executa ← decide ← lê as frentes

Como eu monto um, do zero

1. Escrevo a alma antes de qualquer código. Numa conversa comum: quem é, o que faz, o que não faz, como fala. Se eu não consigo descrever em três parágrafos, o escopo ainda está confuso — e escopo confuso vira agente inútil.
2. Crio a pasta da mente vazia, com as quatro camadas e um índice. Vazia mesmo. Ela cresce com o trabalho real, não com conteúdo inventado.
3. Ligo o arquivo de entrada que manda ele ler a alma ao acordar. Essa é a única instrução verdadeiramente obrigatória.
4. Declaro as ferramentas, uma a uma. Aqui mora a armadilha mais cara que já paguei: em várias plataformas, uma lista de permissões vazia não significa "nada liberado" — significa "o padrão", que costuma incluir executar comando no terminal. Trancar é dizer explicitamente que a lista de ferramentas é vazia.
5. Só então dou um trabalho de verdade e fico olhando. O primeiro dia é observação, não delegação.

Operação real: onde a conta aparece

Aqui está a parte que quase ninguém escreve, porque só aparece depois do terceiro mês.

Memória custa dinheiro, e o preço é por escrita. Transformar as anotações cruas de um dia de trabalho em conhecimento organizado é um processo caro: no meu ambiente, cada dia digerido custou entre 1,30 e 4,60 dólares, com média perto de 2,40. Dezesseis dias de memória consolidada saíram por trinta e oito dólares. Não é caro para o valor que entrega — mas é uma linha de custo que ninguém coloca na planilha antes de começar.

Memória que ninguém lê é prejuízo puro. Toda nota que entra no contexto é paga de novo a cada conversa. Uma mente grande e mal indexada é o pior dos mundos: você paga o tamanho e não colhe a lembrança. Índice bom vale mais que memória grande.

Subagente é orçamento de contexto, não mágica. Delegar para um especialista não deixa o trabalho mais inteligente — deixa o contexto mais limpo. Ele nasce, lê só o que precisa, devolve a conclusão e morre com o próprio contexto. Uso isso justamente quando a tarefa geraria muito lixo no meio do caminho.

O erro caro não é a resposta errada — é o laço. Um agente que tenta de novo, e de novo, e de novo, sem teto, é um cartão de crédito com loop acoplado. Todo agente meu tem limite de passos, de tempo e de custo por execução.

Autonomia sem rastro é aposta. Agente que trabalhou sozinho e não deixou registro não é colaborador: é evento não auditável. O registro diário não é burocracia — é o que transforma incidente em aprendizado.

O critério que uso antes de dar vida a um agente

Três perguntas. Se alguma ficar sem resposta, ele não acorda sozinho.

1. Quando ele errar, como eu fico sabendo — antes que o estrago apareça?
2. Qual é o pior caso de custo de um único pulso dele?
3. Existe algum caminho em que ele causa dano irreversível sem me perguntar antes?

Agente bom não é o que impressiona na primeira conversa. É o que você deixa acordar amanhã sem sentir um frio na barriga.

Para a próxima matéria

Vou abrir a camada de memória por dentro: como uma anotação bruta do dia vira conhecimento permanente, o que eu jogo fora no caminho e por que a maior parte do que um agente escreve não merece ser lembrada. Se quiser acompanhar, os canais estão logo abaixo, na assinatura.