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

Todo mundo está falando sobre agentes de IA. Mas se você perguntar para a maioria das pessoas o que realmente é um agente, a resposta é vaga: "uma 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 diferentes ferramentas de IA se encaixam nesse espectro, 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 Torna Algo um Agente

Perguntar ao Claude "o que devo publicar 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 maior potencial de engajamento, escreva um post no meu estilo e salve-o em um arquivo" e fazê-lo realizar tudo isso sem que você toque 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ê adicionar, menos você estará 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 pesquisa na web antes de responder, lê um arquivo anexado ou gera uma imagem, ele já está ligeiramente agêntico. Você não disse a ele para fazer essas coisas passo a passo, ele decidiu por conta própria que precisava.

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

No topo: agentes totalmente autônomos. O agente opera em uma programação, monitora entradas, chama serviços externos e conclui tarefas complexas sem um humano no loop. Você define o objetivo uma vez e confere o resultado.

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 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 adequar à sua situação específica.Agente de pesquisa: coleta informações sobre um tópico, lê múltiplas 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ê seu tom, formato, público e tópico. Ele lida com rascunhos, reescritas e edições sem que você gerencie 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 empresariais 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 lida com o 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ê só 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 do Sistema - Cole no Prompt 2

Ao executar o Prompt 2 da configuração abaixo, você precisa descrever que tipo de agente deseja. Estes são modelos prontos. Copie o que se adequar, cole no Prompt 2 onde diz "O agente deve ser:", e o Claude Code construirá aquele 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. Pesquise 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 estiver incerto sobre algo, diga 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 alegaçõ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 extensão desejada, 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 publicação
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 em linguagem simples o que cada seção principal faz
13- Se estiver inseguro 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- Encerra 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 uma linha de 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 claro ou próximo passo
14
15Sempre escreva e-mails prontos para envio, 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 ações concretas seguintes
11- Identifique a coisa mais importante a ser feita 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 US$ 1 a 5 por mês, dependendo do modelo escolhido.

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, 1 GB de RAM e 20 GB de armazenamento são mais que suficientes. Qualquer plano básico da DigitalOcean, Hetzner ou Vultr funcionará e custa cerca de US$ 4 a US$ 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 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 reinicie 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 de API.
13Não codifique nenhuma chave de API — leia-as de variáveis de ambiente.

Implante 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 for ligado
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á rodando e visualizar os logs.

Adicione memória persistente entre 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 pesquisar informações em tempo real em vez de responder apenas com a 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 pesquisa automaticamente 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 do 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 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 de 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 para o bot, ele responde com "Este bot é privado." e ignora todas as mensagens futuras 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ê sempre saiba 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 mostra: total de tokens usados hoje, total de tokens usados de todos os tempos e um custo estimado em USD com base no preço 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á rodando. 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 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 fio da conversa permanece intacto.

Adicione os fatos-chave 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 dure.

Prompt de Ponto de Verificação

1Antes de continuarmos, escreva um breve ponto de verificação:
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 porquê]
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 nisto:
61. Confirme seu entendimento de onde estamos
72. Identifique a próxima etapa
83. Faça quaisquer perguntas necessárias para continuar
9
10Não repita trabalhos que já foram concluídos.

Prompt de Resumo Contínuo

1A conversa está ficando longa. Comprima tudo o 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 você mesmo. Espero que isso tenha sido útil.

Se quiser ficar 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