👷 Qué es un agente
Un agente es un trabajador de Jarvis: una pieza que recibe una tarea, la ejecuta y devuelve un resultado. Piensa en una empresa real: no contratas a una persona para que «haga todo». Contratas a alguien para atender, a alguien para vender y a alguien para organizar documentos. En Jarvis es igual: cada agente es como un empleado con una función clara. El servicio dice qué debe hacerse; el agente es quién hace.
🧩 Agente = empleado, no todo el sistema
El sistema (Jarvis) es la empresa. El servicio es el departamento. El agente es la persona que se sienta en la silla y hace el trabajo. Cuando separas estas tres cosas, es fácil diseñar la solución: primero el departamento (servicio), luego quién trabaja en él (agentes) y después qué necesita cada uno para trabajar bien.
✓ Un agente es
- ✓Un trabajador con una función
- ✓Quién ejecuta el "cómo" del servicio
- ✓Algo que recibe una entrada y devuelve una salida
- ✓Una pieza del sistema, no el sistema
✗ Un agente no es
- ✗Todo Jarvis en una sola caja
- ✗Alguien que hace de todo sin enfocarse
- ✗Solo «un prompt ingenioso»
- ✗Algo que decide la estrategia por su cuenta
🎯 Especializado: un trabajo cada uno
La regla de oro de los agentes: un agente, un trabajo. Un agente que intenta hacerlo todo lo hace todo mal: pierde el enfoque, las instrucciones se convierten en un revoltijo y nadie puede decir si acertó. En cambio, un agente especializado es fácil de instruir, de probar y de mejorar. En lugar de un «superagente», Jarvis usa varios agentes pequeños, cada uno enfocado en su tarea.
✗ Un todoterreno
- ✗Instrucciones enormes y confusas
- ✗Falla un poco en todo
- ✗Es difícil saber dónde falló
- ✗Imposible medir el éxito
✓ Varios especializados
- ✓Instrucción breve y clara por agente
- ✓Cada uno acierta en lo que hace
- ✓Es fácil ver quién falló
- ✓Se puede medir y mejorar uno por uno
💡 Consejo práctico
Si no puedes describir el trabajo de un agente en una frase ("clasifica los correos como urgentes o normales"), está haciendo demasiado. Divídelo en dos. Cuanto más breve sea la descripción, mejor será el agente.
📝 Instrucción y contexto
Un trabajador nuevo necesita dos cosas el primer día: la instrucción (qué hacer y cómo) y el contexto (información sobre la empresa, el cliente, la situación). Con el agente es igual. La instrucción indica el trabajo; el contexto aporta el terreno. Una instrucción sin contexto se convierte en una respuesta genérica; el contexto sin instrucción se convierte en información suelta. Juntos hacen que el agente trabaje como alguien de la casa.
La instrucción
"Respondes consultas de clientes sobre entregas. Sé directo, amable y nunca prometas un plazo que no esté en la tabla."
El contexto
La tabla de plazos, las políticas de cambio, el nombre de la tienda, el tono de la marca: el terreno sobre el que el agente se mueve para decidir.
La tarea
La pregunta concreta que llega en el momento: "¿cuándo llega mi pedido 1042?". Instrucción + contexto + tarea = respuesta correcta.
💡 Consejo práctico
Cuando un agente responde "mal", casi siempre no es por la instrucción, sino por falta de contexto. Antes de reescribir la instrucción, pregunta: ¿tenía a mano la información necesaria para acertar?
🧠 Memoria y reglas del agente
Además de instrucciones y contexto, un buen agente tiene memoria (lo que recuerda de la conversación o del historial) y reglas y límites (lo que puede y lo que nunca debe hacer). La memoria evita que el cliente repita todo en cada mensaje. Las reglas protegen a la empresa: un agente sin límites es un riesgo. Aquí se escribe la "ficha" del agente — y cabe en pocas líneas de clave:valor.
Ficha de un agente (clave:valor)
Ficha ilustrativa — cada pieza del agente cabe en una línea. La memoria y el contexto se profundizan en el Módulo 2.5.
🧠 La memoria
Lo que el agente mantiene entre un mensaje y otro: el nombre del cliente, el pedido en cuestión, lo que ya se dijo. Sin eso, "olvida" y el cliente tiene que repetirlo todo.
⛔ Las reglas y los límites
Los límites que el agente nunca cruza: no inventar datos, no prometer lo que no puede cumplir, no actuar fuera de sus atribuciones. El «no» protege tanto como el «sí».
✅ Criterios de éxito
¿Cómo sabes si un agente está haciendo un buen trabajo? Necesitas un criterio de éxito: una frase clara que dice qué significa «tener éxito» para ese agente. Sin un criterio, cualquier respuesta parece aceptable y nunca sabes si vale la pena mejorarla. Con un criterio, puedes probar, comparar y hacer evolucionar al agente, y decir con seguridad si está listo o no.
✗ Criterio vago
- ✗"El agente responde bien"
- ✗"El cliente queda satisfecho"
- ✗No se puede medir
- ✗Cada persona evalúa de manera diferente
✓ Criterio claro
- ✓"Responde el estado correcto del pedido"
- ✓"Sin abrir un ticket para que lo atienda una persona"
- ✓Se puede verificar caso por caso
- ✓Todos están de acuerdo en qué significa «salió bien»
🎯 El criterio viene antes de medir
En el Día 3 medimos resultados reales. Pero la medición solo funciona si el criterio se escribió antes. Definir "qué es el éxito para este agente" forma parte del diseño; no es algo que se descubre después.
🧭 Qué intención realiza el agente
Aquí termina el módulo con la pregunta que va antes que todo: ¿qué intención cumple este agente? No empieces creando el agente; empieza por la intención a la que sirve. La intención del sistema (el alma, de 2.1) se despliega en servicios, y cada servicio, en agentes. Cada agente es la punta fina de una intención mayor. Si no puedes decir qué intención realiza un agente, probablemente ese agente no debería existir.
💡 La pregunta antes de la herramienta
La tentación es empezar preguntando «¿qué agente creo?». El arquitecto de intención empieza por «¿qué intención necesito cumplir?» y solo entonces el agente aparece como consecuencia natural. La intención es la causa; el agente, el efecto.
La intención
"Quiero que ningún cliente se quede sin respuesta sobre su entrega." Es el problema que justifica el sistema.
El servicio
Atención sobre entregas: el departamento que atiende esa intención.
El agente
O agente_de_entregas — la punta fina que lleva a la práctica esa intención, con su ficha completa.
🧾 La lista de verificación de un agente saludable
- Tiene una intención clara que justifica su existencia.
- Tiene un solo trabajo — se describe en una frase.
- Tiene instrucciones, contexto, memoria, reglas y límites — la ficha completa.
- Tiene un criterio de éxito verificable, escrito de antemano.
Autoevaluación (opcional): ¿cuál es la pregunta que va ANTES de crear un agente?
🎯 Resumen del módulo
Siguiente módulo:
2.4 — Habilidades: lo que cada agente sabe hacer en la práctica.