Agentes de IA: Qué son y cómo crear 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 "una IA que hace cosas de forma autónoma".

La imagen real 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 realmente agentivo, y cómo construir tu propio agente con Claude Code y conectarlo a Telegram, sin tener que escribir código tú mismo.

Antes de que entremos en materia, sígueme en X y únete a mi canal de Telegram que acabo de crear, donde publico más contenido sobre IA todos los días. Ambos son gratuitos.

X - https://x.com/AnatoliKopadze

Telegram - https://t.me/kopadzemp

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 están trending 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 sigue ejecutándose hasta que la tarea está terminada, no hasta que genera una respuesta.

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

El espectro: desde el chat hasta el agente

En un extremo tienes un chat básico. Preguntas, Claude responde, la sesión termina. Sin herramientas, sin 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 agentivo. 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. Le das un objetivo, Claude lo divide en pasos, ejecuta cada uno, verifica el resultado y entrega un producto final. No intervienes entre los pasos.

En la cima: agentes totalmente 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 transporta 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. 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 haces una pregunta. Te da una respuesta que te habría llevado horas recopilar manualmente.

Agente de escritura: escribe contenido según un sistema que defines. Dale tu tono, formato, audiencia y tema. Se encarga de borradores, reescrituras y ediciones sin que tú gestiones 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 debe hacer. El agente maneja 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 resúmenes y maneja el trabajo de planificación que haces manualmente todos los días.

Construye tu primer agente: empieza aquí

Usarás Claude Code para construir un bot de Telegram que se ejecute en un servidor remoto y use 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 se realiza directamente a través de Telegram.

Todo el proceso toma entre 10 y 20 minutos. No necesitas saber programar.

Plantillas de prompt del sistema: pégalas en el Prompt 2

Cuando ejecutes el Prompt 2 de la configuración a continuación, debes describir qué tipo de agente quieres. Aquí tienes plantillas ya preparadas: copia la que te sirva, pégala en el Prompt 2 donde dice "El agente debería ser:", y Claude Code construirá ese agente específico. Ajusta cualquier detalle para que se adapte a 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 recibas una tarea de investigación:
41. Identifica las 3-5 preguntas secundarias más importantes que 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 pensar
8
9Cuando recibas una tarea de escritura:
101. Pregunta por el tema, la audiencia y la extensión deseada si no se proporcionan
112. Escribe un primer borrador
123. Revísalo con 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 recibas una tarea de programació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 límite 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 importante
13- Si no estás seguro de los requisitos, haz una pregunta aclaratoria antes de proceder

Agente de correos empresariales

1Eres un agente de correos empresariales. Escribes correos electrónicos profesionales en mi nombre.
2
3Mi estilo de comunicación:
4- Directo y respetuoso
5- Sin formalidades innecesarias
6- Va al grano en la primera oración
7- Cierra con un siguiente paso claro
8
9Cuando recibas 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 próximo paso claro
14
15Siempre escribe 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 comparta mis tareas u objetivos:
41. Identifica lo que es urgente frente a lo 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 describa un proyecto:
10- Divídelo en acciones concretas a continuación
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 personal de Telegram no necesitas nada potente: 1 CPU, 1 GB de RAM y 20 GB de almacenamiento son más que suficientes. 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 elección correcta: lo suficientemente potente para cualquier tarea y asequible para el uso diario. Usa Haiku 4.5 si quieres minimizar el costo. Opus 4.8 solo tiene sentido para un agente analítico complejo donde la calidad de la respuesta es crítica.

Construye 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

1Créame un bot de Telegram que use la API de Claude como su cerebro.
2
3Requisitos:
4- Idioma: Python
5- Librería para Telegram: python-telegram-bot
6- Modelo 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 de 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 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, comprobar si se está ejecutando 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.

Agregar 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 que funcione. 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 forma limpia.

Habilidad: Guardar notas

Tu agente puede guardar cualquier cosa que le digas en un archivo (ideas, tareas, hallazgos de investigación) y recuperarlas 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 API. Esto lo bloquea solo para ti.

1Agrega 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 propia ID de usuario de Telegram, ya sea a través del propio bot o de otro método.

Habilidad: Seguimiento de 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 pedírselo.

1Agrega un resumen diario programado al bot.
2
3Todos los días a las 8:00 a. m., el bot me envía un mensaje con:
41. Una frase motivacional (corta, no cursi)
52. Un recordatorio para revisar mi prioridad principal del día
63. Un dato útil aleatorio sobre productividad o IA
7
8Envíalo a mi ID de usuario de Telegram del 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, busca la variable de prompt del sistema al principio, cámbiala, guarda el archivo y reinicia el servicio con sudo systemctl restart nombre-de-tu-bot. La nueva personalidad estará activa de inmediato.

Cómo comprobar si el bot se está ejecutando. 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 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 forma limpia y te indica si es necesario reiniciar.

El problema de la memoria que tiene todo agente

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

Esto sucede de tres maneras:

• 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 empieza desde cero.
• Si el agente es interrumpido en medio de una tarea, no tiene forma de saber dónde se quedó.

Cuatro cosas pueden solucionarlo:

• Dile al agente que escriba una nota de progreso después de cada paso importante: qué se hizo, qué se decidió, qué falta aún. 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 sea demasiado larga, pídele al agente que comprima todo en un resumen breve y continúe desde allí. El hilo se mantiene 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 dure la conversación.

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é falta aún 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 con este formato:
2
3PASO COMPLETADO: [lo que se hizo]
4DECISIONES CLAVE: [decisiones tomadas y por qué]
5ESTADO ACTUAL: [dónde está la tarea ahora]
6PRÓXIMO PASO: [lo que debería suceder a continuación]
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 aquí tu nota de memoria]
4
5Basándote en esto:
61. Confirma tu comprensión de dónde estamos
72. Identifica el próximo paso
83. Haz cualquier pregunta necesaria para continuar
9
10No repitas trabajo que ya se haya 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 ha encontrado
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 y Telegram.

X - https://x.com/AnatoliKopadze

Telegram - https://t.me/kopadzemp