Agentes de IA: O que são e como criar o seu passo a passo

Todo mundo fala sobre agentes de IA. Mas se você perguntar para a maioria das pessoas o que realmente é um agente, você recebe uma resposta vaga sobre "IA que faz coisas de forma autônoma".

A realidade é mais útil do que isso. Agentes não são uma categoria. Eles são um espectro.

Este guia explica onde nesse espectro diferentes ferramentas de IA se situam, o que separa uma interação básica com um LLM de um fluxo de trabalho verdadeiramente agêntico, e como construir seu próprio agente com o Claude Code e conectá-lo ao Telegram, sem precisar escrever código você mesmo.

Antes de começarmos, siga-me no X e entre no meu canal do Telegram que acabei de criar, onde publico mais conteúdo sobre IA todos os dias. Ambos são gratuitos.

X - https://x.com/AnatoliKopadze

Telegram - https://t.me/kopadzemp

O Que Faz Algo Ser um Agente

Perguntar ao Claude "o que devo postar hoje?" não é um agente. Isso é um chat.

Dizer ao Claude "encontre os três tópicos em alta em IA agora, escolha aquele com o maior potencial de engajamento, escreva um rascunho de post no meu estilo e salve em um arquivo" e ele fazer tudo isso sem você tocar em nada, isso sim é um agente.

A diferença não é o modelo. É a estrutura ao redor dele.

Um agente tem três coisas que um chat comum não tem. Ferramentas que ele pode chamar por conta própria: busca, sistemas de arquivos, execução de código, APIs externas. Memória que persiste entre tarefas, não apenas dentro de uma sessão. E um loop que continua rodando até a tarefa ser concluída, não até gerar uma resposta.

Quanto mais dessas três coisas você adiciona, menos você está envolvido. Essa é a ideia.

O Espectro: Do Chat ao Agente

Em uma ponta você tem um chat básico. Você pergunta, Claude responde, a sessão termina. Sem ferramentas, sem objetivo contínuo, sem capacidade de agir no mundo.

Um passo acima: Claude com ferramentas habilitadas. Quando Claude busca na web antes de responder, lê um arquivo anexado ou gera uma imagem, ele já é levemente agêntico. Você não disse a ele para fazer essas coisas passo a passo, ele decidiu por conta própria que precisava disso.

Mais acima: fluxos de trabalho com múltiplas etapas. Você dá um objetivo, Claude divide em etapas, executa cada uma, verifica o resultado e entrega uma saída finalizada. Você não está envolvido entre as etapas.

No topo: agentes totalmente autônomos. O agente roda em um cronograma, monitora entradas, chama serviços externos e completa tarefas complexas sem um humano no loop. Você define o objetivo uma vez e verifica a saída.

A diferença entre a base e o topo não é um modelo diferente. É o que cerca o modelo: ferramentas que ele pode chamar, memória que carrega contexto e um loop que continua rodando até a tarefa ser concluída.

Tipos de Agentes que Você Pode Construir Hoje

Para te dar uma ideia de como os agentes podem realmente ser hoje, organizei alguns exemplos abaixo. Estes não são limites — você pode construir o que se encaixar na sua situação específica.

Agente de pesquisa: coleta informações sobre um tópico, lê várias fontes, extrai o que importa e entrega um resumo estruturado. Você faz uma pergunta. Ele te dá uma resposta que levaria horas para compilar manualmente.

Agente de escrita: escreve conteúdo de acordo com um sistema que você define. Dê a ele seu tom, formato, público e tópico. Ele lida com rascunhos, reescritas e edições sem você gerenciar cada frase.

Agente de código: escreve código, executa, lê os erros, corrige e continua. Você descreve o que o código deve fazer. O agente lida com a implementação e o loop de depuração.

Agente de negócios: lida com tarefas comerciais repetitivas: redigir e-mails, processar solicitações de clientes, qualificar leads, gerar relatórios. Funciona no piloto automático depois que você define as regras.

Agente pessoal: gerencia sua agenda, organiza tarefas, prepara briefings e cuida do trabalho de planejamento que você faz manualmente todos os dias.

Construindo Seu Primeiro Agente - Comece Aqui

Você usará o Claude Code para construir um bot do Telegram que roda em um servidor remoto e usa o Claude como seu cérebro. O Claude Code escreve todo o código para você; você apenas descreve o que quer em inglês simples. Depois de configurado, toda a comunicação com o bot acontece diretamente pelo Telegram.

Toda a configuração leva cerca de 10 a 20 minutos. Você não precisa saber programar.

Modelos de Prompt de Sistema - Cole no Prompt 2

Quando você executar o Prompt 2 da configuração abaixo, precisará descrever que tipo de agente você quer. Estes são modelos prontos: copie o que se encaixa, cole no Prompt 2 onde diz "O agente deve ser:", e o Claude Code construirá esse agente específico. Ajuste quaisquer detalhes para corresponder à sua situação.

Agente de Pesquisa

1Você é um agente de pesquisa. Seu trabalho é coletar, analisar e sintetizar informações sobre qualquer tópico que eu lhe der.
2
3Ao receber uma tarefa de pesquisa:
41. Identifique as 3 a 5 subperguntas mais importantes a serem respondidas
52. Busque informações sobre cada uma delas
63. Avalie a qualidade e relevância de cada fonte
74. Extraia apenas o que responde diretamente à pergunta
85. Entregue um resumo estruturado com: principais descobertas, evidências de apoio e lacunas que você não conseguiu preencher
9
10Formato: Use cabeçalhos, marcadores e seções claras.
11Se você não tiver certeza sobre algo, diga isso explicitamente.
12Não adicione enchimento. Cada frase deve conter informação.

Agente de Escrita

1Você é um agente de escrita. Você escreve conteúdo na minha voz e estilo.
2
3Meu estilo:
4- Conversacional, direto, sem linguagem corporativa
5- Frases e parágrafos curtos
6- Números e exemplos específicos em vez de afirmações vagas
7- Sempre termine com algo que o leitor deva fazer ou pensar
8
9Ao receber uma tarefa de escrita:
101. Pergunte pelo tópico, público e comprimento desejado, se não fornecidos
112. Escreva um primeiro rascunho
123. Revise-o de acordo com minhas regras de estilo
134. Entregue a versão final pronta para publicar
14
15Nunca adicione introduções desnecessárias. Comece com o ponto mais importante.

Agente de Código

1Você é um agente de código. Seu trabalho é escrever, depurar e melhorar código.
2
3Ao receber uma tarefa de codificação:
41. Confirme seu entendimento do que o código deve fazer
52. Escreva a solução com comentários claros
63. Identifique quaisquer casos extremos ou falhas potenciais
74. Se houver erros, depure-os sistematicamente antes de pedir ajuda
8
9Regras:
10- Escreva código limpo e legível com nomes de variáveis significativos
11- Sempre inclua tratamento de erros
12- Explique o que cada seção principal faz em linguagem simples
13- Se você não tiver certeza sobre os requisitos, faça uma pergunta esclarecedora antes de prosseguir

Agente de E-mail Comercial

1Você é um agente de e-mail comercial. Você escreve e-mails profissionais em meu nome.
2
3Meu estilo de comunicação:
4- Direto e respeitoso
5- Sem formalidades desnecessárias
6- Vai direto ao ponto na primeira frase
7- Termina com um próximo passo claro
8
9Ao receber uma tarefa de e-mail:
101. Identifique o objetivo do e-mail (informar, solicitar, acompanhar, confirmar)
112. Escreva um assunto que reflita o propósito do e-mail
123. Redija o e-mail em no máximo 3 a 5 parágrafos curtos
134. Termine com um item de ação ou próximo passo claro
14
15Sempre escreva e-mails prontos para enviar, não modelos com espaços em branco para preencher.

Agente de Planejamento Pessoal

1Você é meu agente de planejamento pessoal. Você me ajuda a organizar meu trabalho, priorizar tarefas e planejar minha semana.
2
3Quando eu compartilhar minhas tarefas ou objetivos:
41. Identifique o que é urgente vs. importante
52. Sugira uma sequência realista com base nas dependências
63. Estime o tempo necessário para cada tarefa
74. Sinalize qualquer coisa que possa ser delegada ou eliminada
8
9Quando eu descrever um projeto:
10- Divida-o em próximas ações concretas
11- Identifique a coisa mais importante a fazer primeiro
12- Crie uma lista de verificação simples que eu possa seguir
13
14Mantenha tudo prático. Sem enchimento motivacional. Apenas o plano.

O Que Você Precisa Antes de Começar

1 - Uma chave da API Claude de console.anthropic.com. Esta é uma chave de desenvolvedor, você paga por uso, não uma taxa mensal fixa. Para um bot pessoal enviando 50 mensagens por dia, o custo é de $1 a $5 por mês, dependendo do modelo que você escolher.

2 - Um token de bot do Telegram do BotFather.

3 - Um VPS rodando Linux. Para um bot pessoal do Telegram, você não precisa de nada poderoso — 1 CPU, 1GB de RAM e 20GB de armazenamento são mais que suficientes. Qualquer plano básico da DigitalOcean, Hetzner ou Vultr funcionará e custa cerca de $4 a $6 por mês. Depois de ter o servidor, instale o Claude Code executando npm i -g @anthropic-ai/claude-code no seu terminal.

Qual modelo Claude usar para seu bot e quanto realmente custa:

Para a maioria dos bots pessoais, o Sonnet 4.6 é a escolha certa, forte o suficiente para qualquer tarefa e acessível para uso diário. Use o Haiku 4.5 se quiser minimizar custos. O Opus 4.8 só faz sentido para um agente analítico complexo onde a qualidade da resposta é crítica.

Construindo Seu Primeiro Agente - Passo 1

Abra o terminal do seu VPS e inicie o Claude Code. Cole este prompt e deixe-o construir tudo.

Dê uma personalidade ao agente

1Construa para mim um bot do Telegram que use a API Claude como seu cérebro.
2
3Requisitos:
4- Linguagem: Python
5- Biblioteca para Telegram: python-telegram-bot
6- Modelo Claude: claude-sonnet-4-6
7- O bot recebe uma mensagem, envia para a API Claude e retorna a resposta do Claude para o Telegram
8- Mantenha o histórico da conversa por usuário — cada usuário tem seu próprio contexto dentro da sessão
9- Adicione um comando /start que apresente o bot
10- Adicione um comando /clear que redefina o histórico da conversa para aquele usuário
11
12Crie todos os arquivos necessários: arquivo principal do bot, requirements.txt e um modelo de arquivo .env para as chaves da API.
13Não codifique nenhuma chave da API — leia-as de variáveis de ambiente.

Implemente como um serviço em segundo plano

1Crie um arquivo de serviço systemd para que este bot seja executado automaticamente no meu VPS Linux e reinicie se falhar.
2
3O serviço deve:
4- Iniciar automaticamente quando o servidor ligar
5- Reiniciar automaticamente se falhar
6- Carregar variáveis de ambiente do arquivo .env na pasta do projeto
7- Salvar logs em um arquivo que eu possa verificar depois
8
9Também me escreva os comandos exatos do terminal para instalar o serviço, iniciá-lo, verificar se está em execução e visualizar os logs.

Adicione memória persistente entre as sessões

1O bot perde o histórico da conversa quando reinicia. Corrija isso.
2
3Salve o histórico da conversa de cada usuário em um arquivo JSON no disco após cada mensagem. Carregue-o automaticamente quando o bot iniciar.
4
5Adicione um comprimento máximo de histórico — mantenha apenas as últimas 20 mensagens por usuário para que a janela de contexto nunca fique muito longa.

Adicionando Habilidades ao Seu Bot Claude Code

Habilidades são capacidades que você adiciona ao seu bot ao longo do tempo. Cada uma é um novo prompt que você dá ao Claude Code, e ele escreve o código para fazê-la funcionar. Aqui estão as mais úteis.

**Habilidade: Pesquisa na web

**Seu agente pode consultar informações em tempo real em vez de responder apenas da memória.

1Adicione capacidade de pesquisa na web ao bot usando a API Tavily.
2
3Quando o usuário perguntar algo que exija informações atuais — notícias, preços, eventos recentes — o bot automaticamente pesquisa na web e inclui os resultados em sua resposta.
4
5O bot deve decidir por conta própria quando pesquisar e quando responder da memória. Adicione TAVILY_API_KEY ao modelo de arquivo .env.
6
7Use o recurso de uso de ferramentas do Claude para implementar isso de forma limpa.

**Habilidade: Salvar notas

**Seu agente pode salvar qualquer coisa que você disser a ele em um arquivo — ideias, tarefas, descobertas de pesquisa — e recuperá-las depois.

1Adicione um recurso de salvar notas ao bot.
2
3Quando o usuário disser "salve isso", "lembre disso" ou "nota:", o bot salva o conteúdo em um arquivo notes.txt com um carimbo de data/hora.
4
5Adicione um comando /notes que retorna as últimas 10 notas salvas.
6Adicione um comando /clearnotes que exclui todas as notas salvas.

Habilidade: Restringir apenas à sua conta

Por padrão, qualquer um que encontrar seu bot pode usá-lo e consumir seus créditos da API. Isso o bloqueia apenas para você.

1Adicione restrição de usuário ao bot para que apenas eu possa usá-lo.
2
3Adicione meu ID de usuário do Telegram ao arquivo .env como ALLOWED_USER_ID.
4Se qualquer outra pessoa enviar uma mensagem ao bot, ele responde com "Este bot é privado." e ignora todas as mensagens subsequentes desse usuário.
5
6Também adicione como posso encontrar meu próprio ID de usuário do Telegram — seja através do próprio bot ou de outro método.

Habilidade: Rastrear custos da API

A API Claude cobra por token. Isso adiciona um rastreador de custos simples para que você saiba sempre o que está gastando.

1Adicione rastreamento básico de custos ao bot.
2
3Após cada resposta da API Claude, registre o número de tokens de entrada e tokens de saída usados.
4Mantenha um total acumulado em um arquivo costs.json.
5
6Adicione um comando /costs que mostre: total de tokens usados hoje, total de tokens usados desde o início e um custo estimado em USD com base nos preços do claude-sonnet-4-6.

**Habilidade: Briefing diário agendado

**O agente envia uma mensagem para você todas as manhãs sem que você precise pedir.

1Adicione um briefing diário agendado ao bot.
2
3Todos os dias às 8h, o bot me envia uma mensagem com:
41. Uma frase motivacional (curta, sem ser piegas)
52. Um lembrete para verificar minha principal prioridade do dia
63. Um fato útil aleatório sobre produtividade ou IA
7
8Envie para meu ID de usuário do Telegram do arquivo .env.
9Use a biblioteca schedule ou APScheduler para implementar isso.

Coisas Úteis para Saber Após a Configuração

Como atualizar a personalidade do seu agente. Abra o arquivo principal do bot, encontre a variável de prompt do sistema no topo, altere-a, salve o arquivo e reinicie o serviço com sudo systemctl restart nome-do-seu-bot. A nova personalidade entra em vigor imediatamente.

Como verificar se o bot está em execução. Execute sudo systemctl status nome-do-seu-bot no seu terminal. Se disser "active (running)", está funcionando. Se disser "failed", verifique os logs.

Como ler os logs. Execute journalctl -u nome-do-seu-bot -n 50 para ver as últimas 50 linhas. É aqui que você encontra mensagens de erro se algo quebrar.

Como adicionar uma nova habilidade. Abra o Claude Code na pasta do seu projeto e descreva o que você quer: "Adicione o recurso X ao bot." O Claude Code lê seu código existente, adiciona o novo recurso de forma limpa e informa se uma reinicialização é necessária.

O Problema de Memória que Todo Agente Tem

Este é o problema mais comum que as pessoas encontram. O agente perde o contexto entre as sessões, durante tarefas longas, após muitas mensagens e começa a cometer erros ou repetir trabalhos que já fez.

**Existem três maneiras pelas quais isso acontece:

**

Tarefas longas eventualmente excedem o limite de contexto do Claude, e o agente começa a perder o início da conversa: o objetivo original, decisões já tomadas, restrições que você definiu.

Quando você fecha uma sessão e abre uma nova, o agente começa do zero. -

Se o agente for interrompido no meio de uma tarefa, ele não tem como saber onde parou.

**Quatro coisas podem corrigir isso:

**

Diga ao agente para escrever uma nota de progresso após cada etapa importante: o que foi feito, o que foi decidido, o que ainda precisa acontecer. Cole essa nota no início da próxima sessão para restaurar o contexto completo.

A cada dez ou quinze mensagens, peça ao agente para resumir onde está. Isso o força a comprimir o contexto antes que ele transborde.

Antes que a conversa fique muito longa, peça ao agente para comprimir tudo em um resumo curto e continuar a partir daí. O thread permanece intacto.

Adicione os fatos principais de que seu agente sempre precisa diretamente ao prompt do sistema no código do seu bot. O Claude lê isso no início de cada conversa, então essa informação está sempre no contexto, não importa quanto tempo as coisas fiquem.

Prompt de Checkpoint

1Antes de continuarmos, escreva um breve checkpoint:
21. O que você concluiu até agora?
32. Quais são as principais decisões ou descobertas desta sessão?
43. O que ainda precisa ser feito?
54. Qual contexto você precisaria para continuar esta tarefa em uma nova sessão?
6
7Mantenha abaixo de 200 palavras.

Prompt de Arquivo de Memória

1Após concluir cada etapa importante, escreva uma nota de memória neste formato:
2
3ETAPA CONCLUÍDA: [o que foi feito]
4PRINCIPAIS DECISÕES: [escolhas feitas e por quê]
5ESTADO ATUAL: [onde a tarefa está agora]
6PRÓXIMA ETAPA: [o que deve acontecer a seguir]
7
8Esta nota será usada para retomar a tarefa em uma nova sessão sem perder o contexto.

Prompt de Recuperação de Contexto

1Estamos retomando uma tarefa de uma sessão anterior. Aqui está o contexto:
2
3[cole sua nota de memória aqui]
4
5Com base nisso:
61. Confirme seu entendimento de onde estamos
72. Identifique a próxima etapa
83. Faça as perguntas necessárias para continuar
9
10Não repita o trabalho que já foi concluído.

Prompt de Resumo Contínuo

1A conversa está ficando longa. Comprima tudo que é importante em um resumo:
2
31. Objetivo original
42. O que foi feito e o que foi descoberto
53. Principais decisões tomadas
64. O que ainda precisa acontecer
7
8Após escrever o resumo, continue a partir daí. Trate este resumo como o novo ponto de partida.

Agora você sabe o que são agentes, o que eles podem fazer e como construir um. Espero que tenha sido útil.

Se quiser se manter atualizado com tudo o que está acontecendo em IA, siga-me no X e no Telegram.

X - https://x.com/AnatoliKopadze

Telegram - https://t.me/kopadzemp