Saltar al contenido
← La bóveda
GuíaHerramientas y sistemas

Las 3 reglas de los agentes de IA

Qué diferencia a un agente de una simple automatización y las tres reglas para montar el tuyo sin liarte.

Por Félix Go · Publicado el

3reglas
para montar tu agente
6pasos
para tu primer agente
15min
de charla original

Un ingeniero de Anthropic compartió cómo se construyen agentes de IA que funcionan de verdad. Aquí están las 3 ideas clave, sus diapositivas recreadas y un prompt basado en su charla para empezar el tuyo.

En resumen: Según Barry Zhang, ingeniero de Anthropic, un agente de IA eficaz sigue 3 reglas: mantenlo simple (solo entorno, herramientas y system prompt), usa un workflow cuando los pasos están claros y un agente solo para tareas abiertas, y piensa como tu agente, que solo sabe lo que hay en su ventana de contexto. Primero haz que funcione y luego optimiza. Aquí tienes el prompt exacto para diseñar tu primer agente y los 6 pasos para montarlo en Claude sin saber código.

Fuente: Barry Zhang, ingeniero de Anthropic.

Quick recap: de features simples a agentes autónomos

Cómo hemos llegado hasta aquí.

Single-LLM Features
Tareas simples

Resumir, clasificar, extraer. Lo que parecía magia hace 3 años, hoy es estándar.

Workflows
LLMs orquestados por código

Pasos predefinidos. Tú diseñas el camino, el LLM lo ejecuta.

Agents
Trayectorias propias

El LLM decide qué hacer, en qué orden, con qué herramientas.

¿Lo siguiente?
Más agencia, más capacidad

Pero también más coste, más latencia, más consecuencias.

Takeaway 01: mantenlo simple, solo necesitas 3 cosas

Un agente solo necesita tres componentes para arrancar. Nada más. La gente le mete 15 herramientas y un prompt de 800 líneas y luego se queja de que alucina.

Takeaway 01 · Keep it Simple

Cada agente arranca con solo 3 componentes, nada más

Entorno

El sistema donde opera tu agente

browser / codebase / API 01
Herramientas

APIs y funciones que el agente puede usar

search / write / execute 02
System Prompt

Objetivos, restricciones y comportamiento ideal

qué / cómo / cuándo 03
Haz que estos 3 funcionen primero, luego optimiza

La traducción al castellano sin jerga: Entorno = dónde vive el agente (Claude, ChatGPT, OpenClaw…). Herramientas = qué puede hacer (buscar, leer un Drive, mandar un email…). System prompt = qué tiene que hacer y cómo. Tres cosas. Punto.

Takeaway 02: no todo necesita un agente, aprende a decidir

La mayoría de tareas no necesitan autonomía total. Si los pasos están claros, monta un workflow. Si la tarea es abierta y necesita criterio, ahí sí, agente. Te ahorras tokens y dolores de cabeza.

Takeaway 02 · Decision Tree

No todo trabajo necesita un agente: pídele a Claude que te ayude a decidir

Nueva tarea

¿Pueden mapearse los pasos claramente?

Workflow

Pasos predefinidos
Human in the loop

p. ej. reporte semanal
Decisión
← SÍ
¿Decision tree posible?
NO →
Agente IA

Autonomía total
Tarea abierta

p. ej. tarea de research
Menos coste · más fácil de debuggear
Más coste · más potente
Workflow vs agente, punto por puntoPara qué sirve cada uno, ejemplo, revisión humana y coste
Takeaway 02 · Workflow vs AI Agent

Usa la herramienta correcta: la mayoría de tareas no necesitan autonomía total

Workflow Automatizado
Mejor para
Tareas con pasos claros y repetibles
Ejemplo
Mandar reporte semanal cada lunes
Human loop
Sí, revisión antes de enviar
Coste
Pocos tokens · rápido · predecible
Agente de IA
Mejor para
Problemas abiertos y ambiguos
Ejemplo
Investigar un tema con pasos desconocidos
Human loop
Opcional, depende del coste del error
Coste
Más tokens · más lento · más potente

Mi take aplicado a marketing

Yo automatizo los reportes semanales con workflow en una herramienta de automatización. Ahí los pasos están claros: trae datos → genera tabla → manda email. Pero la creación de scripts virales o el análisis competitivo se los dejo a un agente, porque la tarea es abierta y necesita criterio. Mezclar los dos es lo que escala.

Takeaway 03: piensa como tu agente

Si tú no lo entiendes, él tampoco. Tu agente solo conoce lo que está dentro de su ventana de contexto. La mayoría de agentes no fallan por el modelo. Fallan porque tú no sabes explicarte.

Takeaway 03 · Think Like Your Agent

Tu agente solo sabe lo que hay dentro de su ventana de contexto, nada más

✓ Ve
System PromptObjetivos y restricciones
Tarea actualLo que le acabas de pedir
Outputs de toolsRespuestas recientes de la API
Agente IA 10k–20k tokens
✗ No ve
Sesiones anterioresLa memoria se reinicia cada vez
Tus suposicionesContexto que solo tienes tú
Codebase / docs completasTodo lo que esté fuera de la ventana

Usa Claude para debuggear a Claude

Takeaway 03 · Usa Claude para debuggear a Claude

Trabaja con Claude para reducir el peso del system prompt y eliminar ambigüedad

Paso 01
El agente comete un error
Paso 02
Copia el system prompt
Paso 03
Pégalo en Claudey pregúntale qué no está claro
Paso 04
Reescribe las partes ambiguas
El prompt para usar en ClaudePega tu system prompt y te dice qué confunde

Después pega tu system prompt debajo. Claude te dirá exactamente qué confunde.

Aquí tienes el system prompt de mi agente.
¿Qué partes son ambiguas o poco claras?
¿Qué podría causar comportamiento inesperado?

[PEGA AQUÍ TU SYSTEM PROMPT]
Lo que recibes
  • Frases ambiguas concretas
  • Instrucciones contradictorias
  • Vacíos de contexto
Usa el modelo para entender el modelo

Mi take aplicado a marketing

Esto es exactamente por qué mis primeros agentes de copy no funcionaban. Asumía que “ya sabe a qué tono me refiero” cuando en realidad mi system prompt decía “tono directo” y eso significa cien cosas distintas. Lo arreglé pidiéndole a Claude que me leyera mi propio prompt como si fuera el agente. Brutal.

Recapitulando: los 3 takeaways en un solo mapa

Barry Zhang
Ingeniero de Anthropic
15-min talk
Effective AI Agents 3 takeaways
01 · Keep it SimpleEntorno + Herramientas + System Prompt
02 · Decision TreeWorkflow vs Agente: sabe cuál construir
03 · Think Like Your AgentTrabaja dentro de su ventana de contexto

Bonus: primero funciona, luego optimiza

Una vez que el agente con sus 3 componentes está vivo y haciendo su trabajo, hay 3 optimizaciones clave. Pero solo añádelas cuando lo básico funcione. Si las añades antes, vas a perseguir bugs durante semanas.

Fase 01 → Fase 02 · Optimización

Solo añade estas optimizaciones una vez que lo básico funcione

Fase 01
Construye los 3 core
Entorno · Tools · System Prompt
Fase 02
Optimiza
una vez que funciona ✓
Paraleliza tool callsvarias herramientas a la vez → más rápido
Cachea trayectoriasguarda los caminos que funcionan → más barato
Añade sub-agentesespecializa para tareas complejas
Solo despuésde que lo básico funcione
Cómo se ve con sub-agentesUn orquestador que llama a especialistas
Sub-agent Spawning Dinámico

El agente principal decide cuándo necesita ayuda, invocando sub-agentes especializados

Orquestador
Agente principal

Decide qué ayuda necesita

● Modelo ● Memoria
Sub-agente A
Investigadorespecialista en research
Sub-agente B
Redactor de copygenera contenido
Sub-agente C
Revisorrevisa y publica
Output finalresultado sintetizado

Esto es literalmente mi setup en OpenClaw

Jarvis es mi orquestador. Decide qué necesita y llama a Sherlock (research), Ogilvy (copy), Warhol (visuales) o Hermes (distribución). Pero no lo monté así desde el día uno. Empecé con un agente simple que hacía una sola cosa. Luego, cuando funcionaba, añadí los sub-agentes. Si lo haces al revés, te ahogas.

El prompt: pega esto en Claude para construir tu primer agente

Este prompt está basado en lo que explica Barry. Te hace 3 preguntas, te obliga a pensar el problema antes de construir nada, y te devuelve las herramientas, el system prompt y dónde puede fallar tu agente.

Me estás ayudando a construir mi primer agente de IA.

Quiero crear un agente que haga la siguiente tarea:
[DESCRIBE TU TAREA]

Antes de construir nada, hazme estas 3 preguntas, una a una:

1. ¿Esta tarea es demasiado compleja o ambigua como para mapearla en un árbol de decisión simple?
2. ¿A qué herramientas o APIs necesitaría acceder el agente?
3. ¿Cómo se ve el éxito, y cuál es el coste si comete un error?

Cuando haya respondido a las 3, dame exactamente estas 3 cosas:

Herramientas — Una lista de 3 a 5 herramientas que este agente necesitaría para hacer el trabajo.

System Prompt — Un system prompt simple y apto para principiantes, listo para pegar en Claude.

Dónde Podría Fallar — Una advertencia específica sobre el punto de fallo más probable de este agente.

Mantén todo apto para principiantes. Sin jerga técnica.

Cómo construir tu primer agente, sin saber código

Tienes el prompt. Pero, ¿qué haces ahora con él? Aquí va el flujo completo, sin saltarse pasos. Si nunca has montado un agente, empieza por aquí.

01Decide qué tarea quieres automatizarUna frase concreta

Antes de tocar nada, escribe en una frase qué quieres que haga el agente. Cuanto más concreta, mejor. “Que me ayude con marketing” no sirve. “Que cada lunes me prepare un resumen del rendimiento de mis publicaciones de la semana anterior” sí. Ejemplos buenos: redactar borradores de respuestas a comentarios de mis seguidores · investigar 5 competidores y sacarme un informe · clasificar los emails que recibo y archivar los que no necesito leer.

02Abre Claude y empieza una conversación nuevaUn chat nuevo, vale el plan Gratis

Vete a claude.ai y dale a “Nuevo chat”. No necesitas plan de pago para esta parte. Los proyectos y la memoria también están en el plan Gratis (hasta 5 proyectos); Claude Pro te da más uso y conectores como Gmail o Google Drive, pero para el primer experimento basta con la versión Gratis. Importante: esto NO es todavía tu agente. Esto es tú hablando con Claude para diseñarlo. El agente real lo crearás después.

03Pega el prompt y responde a las 3 preguntasTu tarea y 3 respuestas sin tecnicismos

Copia el prompt de arriba, pégalo en Claude reemplazando [DESCRIBE TU TAREA] por tu tarea concreta del paso 01. Claude te hará 3 preguntas, una a una. Respóndelas con calma, sin tecnicismos, como si se lo explicaras a un amigo. Tip: en la pregunta 3 (“¿Cómo se ve el éxito, y cuál es el coste si comete un error?”), sé honesto. Si tu agente manda emails, equivocarse es grave. Si te genera ideas para post, no pasa nada. Eso cambia cómo lo construyes.

04Recibe los 3 entregablesHerramientas, system prompt y punto de fallo

Después de tus respuestas, Claude te devolverá tres cosas: las herramientas que necesitas, el system prompt listo para pegar, y el punto de fallo más probable. Léelo todo antes de moverte al siguiente paso. Si algo no lo entiendes, pídele a Claude que lo explique más simple.

05Crea el agente en Claude (Projects)Proyecto + instrucciones = agente

En Claude.ai, dale a “Proyectos” → “Crear proyecto”. Pon el system prompt que te ha dado Claude en el campo de “Instrucciones del proyecto”. Eso es. Acabas de crear tu primer agente. Cada conversación que abras dentro de ese proyecto seguirá esas instrucciones automáticamente. Si quieres que conecte con apps externas (Google Drive, Gmail, calendario…), conéctalas desde Customize → Connectors (Gmail, Calendar y Drive piden un plan de pago). Eso le da las “herramientas” del paso 04.

06Pruébalo y ajustaPrimero que funcione, luego que funcione bien

Abre el proyecto, escribe tu primera petición real y mira qué hace. ¿Hace lo que esperabas? Si sí, ya tienes tu primer agente. Si no, vuelve al system prompt y aplica el truco del takeaway 03: copia el prompt en una conversación nueva con Claude y pregúntale qué partes son ambiguas. Reescribe lo que confunda y prueba otra vez. La regla: primero haz que funcione mal, luego haz que funcione bien. No intentes que sea perfecto a la primera. Itera.

El error que veo todo el rato: la gente quiere construir el agente perfecto el primer día. Setup complicado, 10 herramientas, sub-agentes desde el minuto uno. Y luego se frustran porque nada funciona. Empieza con UN agente, UNA tarea, UNA herramienta. Cuando eso funcione una semana sin que te dé problemas, entonces ya añades. Yo llevo meses construyendo así y es lo único que escala.

La fuente original: la charla completa de Barry Zhang

15 minutos donde explica los 3 takeaways, las slides y por qué la mayoría de agentes fallan. Si has llegado hasta aquí, esto cierra el círculo.

“How We Build Effective Agents” · AI Engineer Summit 2025 · Nueva York · Vídeo original

Preguntas frecuentes

¿Qué diferencia hay entre un agente de IA y un workflow?

En un workflow los pasos están predefinidos: tú diseñas el camino y el LLM lo ejecuta. En un agente, el LLM decide qué hacer, en qué orden y con qué herramientas. El workflow gasta menos tokens y es más predecible; el agente es más potente, pero más caro y más lento.

¿Cuándo necesito un agente y cuándo basta con un workflow?

Si puedes mapear los pasos con claridad, como mandar un reporte semanal cada lunes, monta un workflow. Si la tarea es abierta y necesita criterio, como investigar un tema con pasos desconocidos, usa un agente.

¿Qué necesita un agente de IA para funcionar?

Tres componentes: un entorno donde opera, unas herramientas que puede usar (buscar, leer un Drive, mandar un email…) y un system prompt con sus objetivos, restricciones y comportamiento ideal. Haz que esos tres funcionen antes de añadir nada más.

¿Puedo crear un agente de IA sin saber programar?

Sí. Pega el prompt de esta guía en Claude para diseñarlo, crea un proyecto en Claude.ai y pon el system prompt resultante en «Instrucciones del proyecto». Si necesitas apps externas como Google Drive o Gmail, conéctalas desde Customize → Connectors (piden un plan de pago).

¿Necesito pagar Claude para montar mi primer agente?

No. Para el primer experimento basta con la versión Gratis, que ya incluye proyectos (hasta 5) y memoria. Claude Pro te sirve si quieres más uso o conectar apps como Gmail o Google Drive.

¿Por qué mi agente de IA no hace lo que le pido?

Normalmente no falla el modelo, sino las instrucciones: el agente solo sabe lo que hay en su ventana de contexto. Copia tu system prompt en una conversación nueva con Claude, pregúntale qué partes son ambiguas y reescríbelas.

Tu voto cuenta

¿Sobre qué quieres el próximo recurso?

Preparo los recursos nuevos según lo que más interesa a quien me sigue. Elige el tema que más te gustaría aprender a hacer con IA:

Un clic y listo. No te apunta a nada nuevo.

Hecho

¿Te ha servido?

Cuéntamelo en redes, que me hace ilusión.

Publico un recurso nuevo cada vez que pruebo algo que merece la pena.

Sigue con estos