Construa seu primeiro agente de IA (sem o hype)

"Agente" virou palavra da moda, então deixa eu desinflar isso. Um agente é três coisas: um objetivo, um conjunto de ferramentas que ele pode usar e um loop onde ele age, vê o resultado e decide o próximo passo. É só isso. Um chatbot responde uma mensagem por vez — quem dirige é você. Um agente pega algo como "triar minha caixa de entrada toda manhã" e toca a sequência inteira sozinho: lê, decide, age, confere, repete. A diferença não é inteligência, é quem está com a mão no volante.

O erro que todo mundo comete é começar grande demais — "um agente que toca o time inteiro". Esse é o próprio alerta da Anthropic em Building effective agents: use a coisa mais simples que resolve e só adicione complexidade agêntica quando a tarefa realmente pedir. Comece pelo menor agente que tira uma tarefa chata real das suas costas, e cresça dali.

A boa notícia: você não precisa construir o loop do zero na mão. Existem três portas de entrada reais, e elas se organizam por quanta encanação você quer ter. Escolha a que combina com onde você está hoje.

Nível 1 — um agente gerenciado que você nem instala (Claude Cowork)

O caminho de menor atrito é o Claude Cowork, o agente de background da Anthropic para trabalho de conhecimento. Não tem nada pra instalar: na caixa de mensagem do Claude você escolhe Cowork, descreve um resultado em vez de uma pergunta, e ele planeja os passos, roda tudo nos servidores da Anthropic e te devolve a coisa pronta — um documento formatado, uma pasta organizada, um relatório sintetizado. Como roda remoto, o trabalho continua mesmo se você fechar o notebook.

Dê a ele uma tarefa com linha de chegada clara, não um desejo aberto. Como EM, eu uso pra coisas como: "Leia as últimas 20 threads deste projeto e me dê um status de uma página com riscos e responsáveis." O truque é escrever o objetivo como briefing, a mesma disciplina de um bom prompt, mais a única coisa que um prompt não precisa — uma definição de pronto:

Objetivo: um digest de segunda com os incidentes de on-call da semana passada.
Ferramentas: ler o export do canal de incidentes, escrever um resumo em markdown.
Pronto: digest datado, contagem por severidade, os 3 mais lentos de resolver, uma tendência.
Restrições: menos de 200 palavras, sem nomes de clientes.

• O que faz dele um agente: ele quebra o pedido em subtarefas e executa de ponta a ponta, não um turno por vez.
• Custo: já vem em qualquer plano pago do Claude (Pro, Max, Team, Enterprise) — sem conta extra.
• Melhor para: quem quer ganhar tempo hoje, com zero configuração técnica.

Nível 2 — um agente que constrói as suas ferramentas (Claude Code)

O Claude Code é o agente de programação da Anthropic, e é o passo em que o agente para de produzir documentos e começa a produzir software. Você descreve o que quer em linguagem natural e ele lê o código, edita arquivos pelo projeto inteiro, roda comandos, corrige os próprios erros e abre o pull request. Você não precisa saber escrever o código — precisa saber descrever o resultado e conferir o que saiu.

Instale a CLI com curl -fsSL https://claude.ai/install.sh | bash, ou pule a instalação local e rode no navegador em claude.ai/code. Aí peça algo concreto: "Me monta um dashboard pequeno que lê este CSV de leads, marca quem a gente não deu retorno em 7 dias e deixa exportar a lista de atrasados." Ele planeja, escreve, roda e itera enquanto você acompanha.

• O que faz dele um agente: ele não só rascunha código — ele executa, depura, faz o commit e ainda pode rodar agendado ou se dividir em subagentes.
• Custo: a ferramenta é grátis de instalar; ela roda em cima de uma assinatura paga do Claude.
• Melhor para: quem quer ferramentas de verdade, sob medida — trackers, dashboards, scripts internos, automações que são suas.

Nível 3 — um agente 24/7 no seu próprio hardware (OpenClaw)

No topo da escada tem um agente totalmente autônomo que vive fora de qualquer app e roda o tempo todo. O projeto open source aqui é o OpenClaw (licença MIT, e um dos repositórios que mais cresceu no GitHub). Ele roda um processo Gateway num hardware que você controla e faz a ponte com os apps de mensagem que você já usa — WhatsApp, Telegram, Slack, Discord, iMessage e dezenas de outros — então você fala com o seu agente do mesmo jeito que manda mensagem pra um colega. Ele é agnóstico de modelo: você traz sua própria chave de API da Anthropic, OpenAI ou Google e escolhe o cérebro.

O que você precisa antes:

• Um hardware que não dorme. Seu notebook não serve — um agente 24/7 precisa de uma máquina sempre ligada. Um Mac Mini (~US$ 599 no M4 base) ou um VPS barato (US$ 4–5/mês, ou uma instância do free tier da AWS) resolvem.
• Software. Node.js 24 (recomendado) ou 22.19+, e então npm install -g openclaw@latest.
• Uma chave de API do modelo em que você confia.

A configuração leva uns 30 minutos:

1. Instale — npm install -g openclaw@latest na sua máquina sempre ligada.
2. Rode o assistente — openclaw onboard --install-daemon. O daemon é o que mantém ele vivo 24/7 depois que você fecha o terminal; o assistente te guia pelo provedor do modelo, sua chave de API e o Gateway.
3. Conecte um canal. O Telegram é o mais rápido: fale com o @BotFather, rode /newbot, copie o token e registre. Pro WhatsApp, rode openclaw channels login e escaneie o QR code — use um número dedicado e tranque com uma lista de permitidos, pra só você conseguir mandar mensagem.
4. Adicione skills. Puxe capacidades do registro de skills da comunidade do OpenClaw — comece por e-mail, navegação web e calendário, pro agente de fato fazer coisas, não só conversar.
5. Teste. Mande uma mensagem pro seu agente: "Resume este link" ou "O que tenho na agenda amanhã?" Se ele responde a partir das suas ferramentas de verdade, está no ar.

• Custo: o software é grátis; você paga por hardware (um Mac Mini uma vez só ou um VPS de ~US$ 5/mês) e pelo uso de API. Um modelo econômico custa poucos dólares por mês; um modelo premium em volume alto pode chegar a ~US$ 140/mês. A maioria dos setups pessoais fica em torno de US$ 6–13/mês no total.
• Melhor para: gente com cabeça de operações que quer automação 24/7 de verdade, em várias ferramentas ao mesmo tempo.

Por qual nível começar?

Comece no Nível 1. Construa um agente no Cowork que te economize 30 minutos por dia e pegue o jeito de delegar tarefas e revisar o que sai. Suba pro Claude Code quando quiser uma ferramenta que ainda não existe. Vá pro OpenClaw quando quiser trabalho acontecendo enquanto você dorme. Cada nível treina o músculo que o próximo exige.

De uma rodada a rodar sozinho

A linha entre um assistente esperto e um agente de verdade é se ele roda sem você acionar. O Cowork cruza essa linha com tarefas agendadas: digite /schedule em qualquer tarefa (ou abra Scheduled na barra lateral) e ele roda de hora em hora, diariamente, semanalmente, em dias de semana ou sob demanda — remoto, mesmo com o seu computador desligado. O Claude Code faz o mesmo via rotinas, e o OpenClaw roda no daemon por padrão. Aponte pra uma tarefa recorrente — um digest de incidentes na segunda, um resumo noturno de builds que quebraram — e ele simplesmente aparece.

A orientação de context engineering da Anthropic é direta sobre o que quebra primeiro: a maioria das falhas de agente é falha de contexto — ou faltou algo que ele precisava, ou tinha ruído demais. Então, antes de agendar qualquer coisa, rode na mão algumas vezes e conserte o contexto, não o modelo.

Esta semana

Escolha uma tarefa com um fim claro. Escreva o briefing de quatro linhas acima pra ela. Rode manualmente no Cowork três vezes e conserte o contexto a cada rodada. Na terceira, você vai ter algo que vale a pena agendar — e vai entender agentes por dentro, não pelo hype.

Fontes

• Anthropic — Building effective agents
• Anthropic — Effective context engineering for AI agents
• Claude Cowork — Get started
• Claude Code — Overview
• OpenClaw — Getting started