Agentes de IA: Qué son y cómo construir el tuyo paso a paso

Todo el mundo habla de los agentes de IA. Pero si le preguntas a la mayoría de la gente qué es realmente un agente, obtienes una respuesta vaga sobre "IA que hace cosas de forma autónoma".

La realidad es más útil que eso. Los agentes no son una categoría. Son un espectro.

Esta guía explica dónde se sitúan las diferentes herramientas de IA en ese espectro, qué separa una interacción básica con un LLM de un flujo de trabajo verdaderamente agéntico, y cómo construir tu propio agente con Claude Code y conectarlo a Telegram sin necesidad de escribir código tú mismo.

Antes de empezar, sígueme en X.

X -

https://x.com/ai_rohitt

Qué Hace que Algo Sea un Agente

Preguntarle a Claude "¿qué debería publicar hoy?" no es un agente. Eso es un chat.

Decirle a Claude "encuentra los tres temas que son tendencia en IA ahora mismo, elige el que tenga más potencial de engagement, redacta una publicación en mi estilo y guárdala en un archivo" y que haga todo eso sin que toques nada — eso es un agente.

La diferencia no es el modelo. Es la estructura que lo rodea.

Un agente tiene tres cosas que un chat normal no tiene. Herramientas que puede usar por sí mismo: búsqueda, sistemas de archivos, ejecución de código, APIs externas. Memoria que persiste entre tareas, no solo dentro de una sesión. Y un bucle que se ejecuta hasta que la tarea está terminada, no hasta que genera una sola respuesta.

Cuantas más de esas tres cosas agregues, menos involucrado estarás. Esa es la idea.

El Espectro: Del Chat al Agente

En un extremo tienes un chat básico. Preguntas, Claude responde, la sesión termina. Sin herramientas, sin un objetivo continuo, sin capacidad de actuar en el mundo.

Un paso más arriba: Claude con herramientas habilitadas. Cuando Claude busca en la web antes de responder, lee un archivo adjunto o genera una imagen, ya es ligeramente agéntico. No le dijiste que hiciera esas cosas paso a paso; él mismo decidió que las necesitaba.

Más arriba: flujos de trabajo de múltiples pasos. Das un objetivo, Claude lo divide en pasos, ejecuta cada uno, verifica el resultado y entrega un resultado final. No intervienes entre los pasos.

En la cima: agentes completamente autónomos. El agente se ejecuta en un horario, monitorea entradas, llama a servicios externos y completa tareas complejas sin un humano en el bucle. Estableces el objetivo una vez y verificas el resultado.

La diferencia entre la parte inferior y la superior no es un modelo diferente. Es lo que rodea al modelo: herramientas que puede usar, memoria que mantiene el contexto y un bucle que sigue ejecutándose hasta que la tarea está hecha.

Tipos de Agentes que Puedes Construir Hoy

Para darte una idea de cómo pueden ser los agentes hoy en día, he preparado algunos ejemplos a continuación. Estos no son límites; puedes construir lo que se adapte a tu situación específica.

Agente de investigación: recopila información sobre un tema, lee múltiples fuentes, extrae lo que importa y entrega un resumen estructurado. Le das una pregunta. Te da una respuesta que te habría llevado horas recopilar manualmente.

Agente de escritura: escribe contenido según un sistema que tú defines. Dale tu tono, formato, audiencia y tema. Se encarga de borradores, reescrituras y ediciones sin que tengas que gestionar cada frase.

Agente de código: escribe código, lo ejecuta, lee los errores, los corrige y sigue adelante. Describes lo que el código debería hacer. El agente se encarga de la implementación y el bucle de depuración.

Agente de negocios: maneja tareas comerciales repetitivas: redactar correos electrónicos, procesar solicitudes de clientes, calificar leads, generar informes. Funciona en piloto automático una vez que defines las reglas.

Agente personal: gestiona tu agenda, organiza tareas, prepara informes y maneja el trabajo de planificación que haces manualmente todos los días.

Construyendo tu Primer Agente - Empieza Aquí

Usarás Claude Code para construir un bot de Telegram que se ejecute en un servidor remoto y use a Claude como su cerebro. Claude Code escribe todo el código por ti; solo describes lo que quieres en inglés sencillo. Una vez configurado, toda la comunicación con el bot ocurre directamente a través de Telegram.

Toda la configuración toma entre 10 y 20 minutos. No necesitas saber programar.

Plantillas de Prompt del Sistema - Pega en el Prompt 2

Cuando ejecutes el Prompt 2 de la configuración a continuación, necesitas describir qué tipo de agente quieres. Estas son plantillas listas para usar; copia la que se ajuste, pégala en el Prompt 2 donde dice "El agente debe ser:", y Claude Code construirá ese agente específico. Ajusta cualquier detalle para que coincida con tu situación.

Agente de Investigación

1Eres un agente de investigación. Tu trabajo es recopilar, analizar y sintetizar información sobre cualquier tema que te dé.
2
3Cuando se te asigne una tarea de investigación:
41. Identifica las 3 a 5 subpreguntas más importantes para responder
52. Busca información sobre cada una
63. Evalúa la calidad y relevancia de cada fuente
74. Extrae solo lo que responda directamente a la pregunta
85. Entrega un resumen estructurado con: hallazgos clave, evidencia de apoyo y lagunas que no pudiste llenar
9
10Formato: Usa encabezados, viñetas y secciones claras.
11Si no estás seguro de algo, dilo explícitamente.
12No agregues relleno. Cada oración debe contener información.

Agente de Escritura

1Eres un agente de escritura. Escribes contenido con mi voz y estilo.
2
3Mi estilo:
4- Conversacional, directo, sin lenguaje corporativo
5- Oraciones y párrafos cortos
6- Números y ejemplos específicos en lugar de afirmaciones vagas
7- Siempre termina con algo que el lector debería hacer o considerar
8
9Cuando se te asigne una tarea de escritura:
101. Pregunta por el tema, la audiencia y la longitud deseada si no se proporcionan
112. Escribe un primer borrador
123. Revísalo según mis reglas de estilo
134. Entrega la versión final lista para publicar
14
15Nunca agregues introducciones innecesarias. Empieza con el punto más importante.

Agente de Código

1Eres un agente de código. Tu trabajo es escribir, depurar y mejorar código.
2
3Cuando se te asigne una tarea de codificación:
41. Confirma tu comprensión de lo que el código debe hacer
52. Escribe la solución con comentarios claros
63. Identifica cualquier caso extremo o posible fallo
74. Si hay errores, depúralos sistemáticamente antes de pedir ayuda
8
9Reglas:
10- Escribe código limpio y legible con nombres de variables significativos
11- Incluye siempre manejo de errores
12- Explica en lenguaje sencillo lo que hace cada sección principal
13- Si no estás seguro de los requisitos, haz una pregunta aclaratoria antes de proceder

Agente de Correo Electrónico de Negocios

1Eres un agente de correo electrónico de negocios. Escribes correos profesionales en mi nombre.
2
3Mi estilo de comunicación:
4- Directo y respetuoso
5- Sin formalismos innecesarios
6- Va al grano en la primera oración
7- Cierra con un siguiente paso claro
8
9Cuando se te asigne una tarea de correo:
101. Identifica el objetivo del correo (informar, solicitar, dar seguimiento, confirmar)
112. Escribe un asunto que refleje el propósito del correo
123. Redacta el correo en un máximo de 3 a 5 párrafos cortos
134. Termina con un elemento de acción o siguiente paso claro
14
15Escribe siempre correos listos para enviar, no plantillas con espacios en blanco para rellenar.

Agente de Planificación Personal

1Eres mi agente de planificación personal. Me ayudas a organizar mi trabajo, priorizar tareas y planificar mi semana.
2
3Cuando comparto mis tareas u objetivos:
41. Identifica lo que es urgente vs. importante
52. Sugiere una secuencia realista basada en dependencias
63. Estima el tiempo requerido para cada tarea
74. Señala cualquier cosa que pueda delegarse o eliminarse
8
9Cuando describo un proyecto:
10- Divídelo en acciones concretas a seguir
11- Identifica la única cosa más importante que hacer primero
12- Crea una lista de verificación simple que pueda seguir
13
14Mantén todo práctico. Sin relleno motivacional. Solo el plan.

Lo que Necesitas Antes de Empezar

1 - una clave API de Claude desde console.anthropic.com. Esta es una clave de desarrollador; pagas por uso, no una tarifa mensual fija. Para un bot personal que envía 50 mensajes al día, el costo es de $1 a $5 por mes dependiendo del modelo que elijas.

2 - un token de bot de Telegram desde BotFather.

3 - un VPS con Linux. Para un bot de Telegram personal, no necesitas nada potente: 1 CPU, 1 GB de RAM y 20 GB de almacenamiento es más que suficiente. Cualquier plan básico de DigitalOcean, Hetzner o Vultr funcionará y cuesta entre $4 y $6 al mes. Una vez que tengas el servidor, instala Claude Code ejecutando npm i -g @anthropic-ai/claude-code en tu terminal.

Qué modelo de Claude usar para tu bot y cuánto cuesta realmente:

Para la mayoría de los bots personales, Sonnet 4.6 es la opción correcta, lo suficientemente potente para cualquier tarea y asequible para uso diario. Usa Haiku 4.5 si quieres minimizar costos. Opus 4.8 solo tiene sentido para un agente analítico complejo donde la calidad de la respuesta es crítica.

Construyendo tu Primer Agente - Paso 1

Abre la terminal de tu VPS e inicia Claude Code. Pega este prompt y deja que construya todo.

Dale una personalidad al agente

1Construye un bot de Telegram que use la API de Claude como su cerebro.
2
3Requisitos:
4- Lenguaje: Python
5- Librería para Telegram: python-telegram-bot
6- Modelo de Claude: claude-sonnet-4-6
7- El bot recibe un mensaje, lo envía a la API de Claude y devuelve la respuesta de Claude a Telegram
8- Mantén el historial de conversación por usuario — cada usuario tiene su propio contexto dentro de la sesión
9- Agrega un comando /start que presente el bot
10- Agrega un comando /clear que reinicie el historial de conversación para ese usuario
11
12Crea todos los archivos necesarios: archivo principal del bot, requirements.txt y una plantilla de archivo .env para las claves API.
13No codifiques ninguna clave API — léelas desde las variables de entorno.

Despliega como un servicio en segundo plano

1Crea un archivo de servicio systemd para que este bot se ejecute automáticamente en mi VPS Linux y se reinicie si falla.
2
3El servicio debe:
4- Iniciarse automáticamente cuando el servidor arranque
5- Reiniciarse automáticamente si falla
6- Cargar las variables de entorno desde el archivo .env en la carpeta del proyecto
7- Guardar los registros en un archivo que pueda consultar más tarde
8
9También escríbeme los comandos exactos de terminal para instalar el servicio, iniciarlo, verificar si está funcionando y ver los registros.

Agrega memoria persistente entre sesiones

1El bot pierde el historial de conversación cuando se reinicia. Soluciona esto.
2
3Guarda el historial de conversación de cada usuario en un archivo JSON en el disco después de cada mensaje. Cárgalo automáticamente cuando el bot se inicie.
4
5Agrega una longitud máxima de historial — conserva solo los últimos 20 mensajes por usuario para que la ventana de contexto nunca sea demasiado larga.

Agregando Habilidades a tu Bot de Claude Code

Las habilidades son capacidades que agregas a tu bot con el tiempo. Cada una es un nuevo prompt que le das a Claude Code, y él escribe el código para hacerlo funcionar. Aquí están las más útiles.

**Habilidad: Búsqueda web

**Tu agente puede buscar información en tiempo real en lugar de responder solo de memoria.

1Agrega capacidad de búsqueda web al bot usando la API de Tavily.
2
3Cuando el usuario pregunte algo que requiera información actual — noticias, precios, eventos recientes — el bot busca automáticamente en la web e incluye los resultados en su respuesta.
4
5El bot debe decidir por sí mismo cuándo buscar y cuándo responder de memoria. Agrega TAVILY_API_KEY a la plantilla del archivo .env.
6
7Usa la función de uso de herramientas de Claude para implementar esto de manera limpia.

**Habilidad: Guardar notas

**Tu agente puede guardar cualquier cosa que le digas en un archivo — ideas, tareas, hallazgos de investigación y recuperarlos más tarde.

1Agrega una función de guardado de notas al bot.
2
3Cuando el usuario diga "guarda esto", "recuerda esto" o "nota:", el bot guarda el contenido en un archivo notes.txt con una marca de tiempo.
4
5Agrega un comando /notes que devuelva las últimas 10 notas guardadas.
6Agrega un comando /clearnotes que elimine todas las notas guardadas.

**Habilidad: Restringir solo a tu cuenta

**Por defecto, cualquiera que encuentre tu bot puede usarlo y consumir tus créditos de API. Esto lo bloquea solo para ti.

1Agrega una restricción de usuario al bot para que solo yo pueda usarlo.
2
3Agrega mi ID de usuario de Telegram al archivo .env como ALLOWED_USER_ID.
4Si alguien más le envía un mensaje al bot, responde con "Este bot es privado." e ignora todos los mensajes posteriores de ese usuario.
5
6También agrega cómo puedo encontrar mi propio ID de usuario de Telegram — ya sea a través del propio bot u otro método.

**Habilidad: Rastrear costos de API

**La API de Claude cobra por token. Esto agrega un rastreador de costos simple para que siempre sepas lo que estás gastando.

1Agrega un seguimiento básico de costos al bot.
2
3Después de cada respuesta de la API de Claude, registra el número de tokens de entrada y tokens de salida utilizados.
4Mantén un total acumulado en un archivo costs.json.
5
6Agrega un comando /costs que muestre: total de tokens usados hoy, total de tokens usados en total y un costo estimado en USD basado en el precio de claude-sonnet-4-6.

**Habilidad: Resumen diario programado

**El agente te envía un mensaje cada mañana sin que tengas que pedirlo.

1Agrega un resumen diario programado al bot.
2
3Todos los días a las 8:00 am, el bot me envía un mensaje con:
41. Una frase motivacional corta (breve, no cursi)
52. Un recordatorio para revisar mi máxima prioridad del día
63. Un dato útil aleatorio sobre productividad o IA
7
8Envíalo a mi ID de usuario de Telegram desde el archivo .env.
9Usa la librería schedule o APScheduler para implementar esto.

Cosas Útiles que Saber Después de la Configuración

Cómo actualizar la personalidad de tu agente. Abre el archivo principal del bot, encuentra la variable del prompt del sistema en la parte superior, cámbiala, guarda el archivo y reinicia el servicio con sudo systemctl restart nombre-de-tu-bot. La nueva personalidad está activa de inmediato.

Cómo verificar si el bot está funcionando. Ejecuta sudo systemctl status nombre-de-tu-bot en tu terminal. Si dice "active (running)", está funcionando. Si dice "failed", revisa los registros.

Cómo leer los registros. Ejecuta journalctl -u nombre-de-tu-bot -n 50 para ver las últimas 50 líneas. Aquí es donde encuentras los mensajes de error si algo falla.

Cómo agregar una nueva habilidad. Abre Claude Code en la carpeta de tu proyecto y describe lo que quieres: "Agrega la función X al bot." Claude Code lee tu código existente, agrega la nueva función de manera limpia y te dice si es necesario reiniciar.

El Problema de Memoria que Todo Agente Tiene

Este es el problema más común con el que la gente se encuentra. El agente pierde contexto entre sesiones, a lo largo de tareas largas, después de demasiados mensajes, y comienza a cometer errores o repetir trabajo que ya hizo.

Hay tres formas en que esto sucede:

Las tareas largas eventualmente superan el límite de contexto de Claude, y el agente comienza a perder el inicio de la conversación: el objetivo original, las decisiones ya tomadas, las restricciones que estableciste.

Cuando cierras una sesión y abres una nueva, el agente comienza desde cero.

Si el agente es interrumpido a mitad de una tarea, no tiene forma de saber dónde se detuvo.

Cuatro cosas pueden solucionar esto:Dile al agente que escriba una nota de progreso después de cada paso importante: lo que se hizo, lo que se decidió, lo que aún falta. Pega esa nota al inicio de la siguiente sesión para restaurar el contexto completo.

Cada diez o quince mensajes, pídele al agente que resuma dónde está. Esto lo obliga a comprimir el contexto antes de que se desborde.

Antes de que la conversación se vuelva demasiado larga, pídele al agente que comprima todo en un resumen y continúe desde allí. El hilo permanece intacto.

Agrega los datos clave que tu agente necesita siempre directamente al prompt del sistema en el código de tu bot. Claude lee esto al inicio de cada conversación, por lo que esa información siempre está en contexto sin importar cuánto se alargue.

Prompt de Punto de Control

1Antes de continuar, escribe un breve punto de control:
21. ¿Qué has completado hasta ahora?
32. ¿Cuáles son las decisiones o hallazgos clave de esta sesión?
43. ¿Qué queda por hacer?
54. ¿Qué contexto necesitarías para continuar esta tarea en una nueva sesión?
6
7Mantenlo en menos de 200 palabras.

Prompt de Archivo de Memoria

1Después de completar cada paso importante, escribe una nota de memoria en este formato:
2
3PASO COMPLETADO: [lo que se hizo]
4DECISIONES CLAVE: [decisiones tomadas y por qué]
5ESTADO ACTUAL: [dónde se encuentra la tarea ahora]
6SIGUIENTE PASO: [lo que debería suceder después]
7
8Esta nota se usará para reanudar la tarea en una nueva sesión sin perder contexto.

Prompt de Recuperación de Contexto

1Estamos reanudando una tarea de una sesión anterior. Aquí está el contexto:
2
3[pega tu nota de memoria aquí]
4
5Basado en esto:
61. Confirma tu comprensión de dónde estamos
72. Identifica el siguiente paso
83. Haz cualquier pregunta necesaria para continuar
9
10No repitas el trabajo que ya se ha completado.

Prompt de Resumen Continuo

1La conversación se está alargando. Comprime todo lo importante en un resumen:
2
31. Objetivo original
42. Lo que se ha hecho y lo que se encontró
53. Decisiones clave tomadas
64. Lo que aún debe suceder
7
8Después de escribir el resumen, continúa desde allí. Trata este resumen como el nuevo punto de partida.

Ahora sabes qué son los agentes, qué pueden hacer y cómo construir uno tú mismo. Espero que te haya sido útil.

Si quieres mantenerte al día con todo lo que está pasando en IA, sígueme en X.

X - https://x.com/ai_rohitt