Harness, loop ou graph: 3 jeitos de montar agente de IA
Um comando pronto pra cada jeito de montar agente, no Claude ou na IA que você preferir, e os links pra entender cada um.
Antes de tudo
- Os 3 comandos funcionam no Claude ou em qualquer IA de chat.
- O que está entre [colchetes] você preenche com o seu caso.
- No chat comum, o resultado é texto: um arquivo de regras, uma resposta em voltas e um mapa de etapas. Não é uma automação pronta.
1. Harness: o andaime
Decida o que o agente vê, toca e confere. Com o mesmo modelo dá pra ter um agente bem melhor. A diferença tá no andaime.
- Guias: as regras que ele segue. No Claude Code, é o arquivo CLAUDE.md ou AGENTS.md.
- Contexto: o que ele enxerga, como histórico, documentos e arquivos.
- Ferramentas: o que ele pode mexer e onde pede licença.
- Conferência: o teste que a resposta tem que passar antes de sair, mais o registro de cada passo.
Manual de conduta
Escreva o arquivo de regras do agente: o que ele vê, o que pode mexer, onde pede aprovação e como confere.
Você é especialista em montar agentes de IA. Escreva o arquivo de regras de um agente de [função] da [empresa] em 4 partes: regras que ele segue, o que pode consultar, o que faz sozinho e onde pede minha aprovação, e como confere antes de enviar. Frases curtas. Se faltar dado, pergunte. Dados: [cole aqui].
O Claude trata esse arquivo como contexto, não como trava. Pra bloquear uma ação de verdade, o caminho é um hook.
Onde colar o resultado
- No Claude: num Projeto, no campo de instruções do projeto. Essas instruções valem pra todas as conversas daquele projeto. Projetos existem em todos os planos, inclusive o grátis (até 5 projetos).
- No Claude Code: o resultado vira o arquivo CLAUDE.md da pasta do projeto. Se a pasta já tem um AGENTS.md e não tem CLAUDE.md, o Claude Code lê o AGENTS.md.
2. Loop: o ciclo
Deixe o agente repetir até terminar. O prompt só dá a partida, quem termina o serviço é a volta.
- O agente roda sempre a mesma volta: olha a situação, pensa, age e confere. Depois repete até cumprir o objetivo.
- Em vez de dar um prompt a cada passo, você monta a volta: objetivo claro, conferência a cada volta e hora de parar, por limite de voltas, de tempo ou de gasto.
- Entre uma volta e outra, ele anota o que já fez.
Volta com freio
Dê ao agente um objetivo, uma conferência a cada volta e hora de parar.
Você é um agente de [função] da [empresa]. Objetivo: [o que conta como pronto]. Trabalhe em voltas: analise, faça uma parte, confira contra o objetivo e anote o que fez em 1 linha. Pare quando cumprir o objetivo, depois de [5] voltas ou se travar, e diga o que falta. Tarefa: [cole aqui].
Num chat comum, como o Claude.ai, ele simula as voltas dentro de uma resposta só. A volta de verdade, com a IA executando e conferindo sozinha, acontece em ferramentas de agente, como o Claude Code.
3. Graph: o mapa
Desenhe as etapas e quem decide a próxima. No prompt, a regra é só um pedido. No mapa, ela vira caminho obrigatório.
- As etapas fazem o trabalho e as setas decidem o que vem depois.
- Uma ficha leva as informações de uma etapa pra outra.
- Exemplo: no suporte, o cliente escreve «fui cobrado duas vezes» e o agente classifica o pedido. Se for reembolso, ele confere a política e espera uma pessoa aprovar. Se for dúvida, busca nos documentos e em atendimentos antigos, confere a resposta e, se não passar, refaz.
Mapa com aprovação
Desenhe as etapas do agente, quem faz cada uma, a regra que escolhe a próxima e onde uma pessoa aprova.
Você é especialista em processos com IA. Desenhe o mapa de etapas de um agente de [função] da [empresa]: cada etapa, quem faz (IA, sistema ou pessoa), a regra que decide a próxima e onde uma pessoa precisa aprovar. Entregue em lista numerada. Onde faltar regra, escreva [definir]. Como é hoje: [descreva aqui].
O resultado é um plano em texto, não uma automação. Onde faltar regra, ele marca [definir] pra você completar.
Deu erro?
Quer ver isso em vídeo?
No meu canal do YouTube eu mostro, passo a passo, como usar IA no seu negócio.
Ver o canal no YouTube