Crear subagentes especializados

Un subagente es un asistente de IA especializado que recibe una tarea, la resuelve por su cuenta en su propio espacio de trabajo y te devuelve el resultado. En lugar de explicarle todo de cero cada vez, lo configurás una vez —rol, herramientas y reglas— y después se activa solo cuando aparece el tipo de trabajo para el que lo armaste. Es una de las formas más concretas de poner la IA a trabajar sin estar encima.

Qué es un subagente y por qué te sirve

Pensalo como contratar a un especialista en vez de pedirle todo a un generalista. Un subagente trabaja en una "ventana de contexto" aislada: tiene su propia memoria de la tarea, no se mezcla con la conversación principal y, cuando termina, te entrega solo la conclusión. Eso mantiene tu chat principal limpio y hace que cada tarea la haga alguien "enfocado" en eso.

La diferencia clave con un simple comando o atajo es quién decide usarlo. Un comando lo disparás vos a mano; un subagente se activa solo cuando la IA detecta, por la descripción que le escribiste, que esta tarea es para él. Por eso la descripción no es un detalle: es lo que determina si se usa en el momento correcto.

Te conviene crear un subagente cuando:

• Repetís el mismo tipo de tarea seguido (revisar textos, clasificar mensajes, generar reportes).
• Querés un criterio consistente, no que cada vez salga distinto.
• La tarea tiene un rol claro y un formato de salida fijo.

Si es algo que hacés una sola vez, no vale la pena: armá el subagente cuando el patrón se repite.

La estructura de un subagente

Un subagente se define en un archivo con dos partes: un encabezado de configuración (los datos clave) y el cuerpo, que es el prompt de sistema donde le explicás cómo trabajar. Estos son los campos que importan:

• Nombre (name): identificador corto, en minúsculas y con guiones. Que diga qué hace: revisor-de-textos, no ayudante.
• Descripción (description): cuándo activarlo. El campo más importante. Acá le marcás los disparadores.
• Modelo (model): qué motor usa. Lo normal es heredar el de la conversación; subí de nivel solo si la tarea pide razonamiento pesado.
• Herramientas (tools): qué puede hacer (leer archivos, escribir, buscar). Dale solo lo necesario.
• Prompt de sistema (el cuerpo): el rol, los pasos, los estándares de calidad y el formato de salida.

Esta es la plantilla base, lista para copiar y completar:

---
name: nombre-del-subagente
description: Usá este agente cuando [condiciones que lo disparan].

<example>
Contexto: [qué situación lleva a usarlo]
usuario: "[lo que pide el usuario]"
asistente: "[cómo responde y por qué activa este agente]"
<commentary>
[por qué corresponde usar este agente acá]
</commentary>
</example>

model: inherit
color: blue
tools: ["Read", "Grep", "Glob"]
---

Sos [rol] especializado en [dominio].

**Tus responsabilidades principales:**
1. [Lo que el agente SÍ o SÍ debe hacer]
2. [Responsabilidad secundaria]

**Proceso de trabajo:**
1. [Paso uno, bien concreto]
2. [Paso dos]
3. [Paso tres]

**Estándares de calidad:**
- [Criterio medible, no vago]

**Formato de salida:**
- [Qué incluir y cómo estructurarlo]

**Qué NO hacer:**
- [Límite o anti-patrón a evitar]

La descripción: lo que decide cuándo se activa

Acá se gana o se pierde. Si la descripción es genérica ("revisa cosas"), la IA nunca sabe cuándo usarlo. La clave es escribir condiciones claras y sumar ejemplos concretos que muestren el patrón. Un buen ejemplo incluye el contexto, el pedido del usuario, cómo responde el asistente y un comentario que explique por qué corresponde activarlo.

Cubrí distintas formas de disparar el subagente:

• Pedido explícito: el usuario pide directamente la función ("revisame este texto").
• Necesidad implícita: el usuario no lo pide con esas palabras, pero el contexto lo amerita ("este mail quedó confuso").
• Disparo proactivo: el subagente se activa solo después de cierto trabajo, sin que se lo pidan.

<example>
Contexto: El usuario terminó de redactar un correo importante
usuario: "Ya está el mail para el cliente"
asistente: "Buenísimo. Lo paso por el revisor antes de enviarlo."
<commentary>
Texto terminado y de alto impacto. Conviene activar el revisor-de-textos
de forma proactiva para chequear claridad y tono.
</commentary>
asistente: "Voy a usar el agente revisor-de-textos para revisarlo."
</example>

Sumá 2 a 4 ejemplos con frases distintas para la misma intención. Cuantas más variantes le muestres, mejor reconoce el momento de usarlo.

Elegir las herramientas: solo lo necesario

A un subagente le das únicamente las herramientas que la tarea requiere. Esto es el "principio de menor privilegio": menos permisos, menos chance de que haga algo que no querías. Si el agente solo analiza y reporta, no le des permiso de escritura.

Solo lectura (análisis):     ["Read", "Grep", "Glob"]
Lectura + escritura:         ["Read", "Write", "Grep", "Glob"]
Operaciones de sistema:      ["Read", "Bash", "Grep"]

La regla mental: ¿este agente necesita modificar archivos para hacer su trabajo? Si la respuesta es no, no le des esa herramienta.

El prompt de sistema: cómo trabaja

El cuerpo del archivo es donde le das identidad y método. La diferencia entre un subagente que sirve y uno que decepciona está casi siempre acá. Apuntá a instrucciones específicas y accionables, no a frases vagas.

Compará cómo cambia la calidad cuando sos preciso:

• En vez de "buscá problemas", escribí "revisá ortografía, tono y que cada frase tenga una sola idea".
• En vez de "usá buen formato", mostrá el formato exacto que querés.
• En vez de dejarlo sin límites, aclará "no reescribas todo, solo señalá y sugerí".
• En vez de que asuma cuando duda, decile "si algo no está claro, pedí aclaración".

Un detalle importante para tareas de varios pasos: la autocrítica va al final. Que primero produzca la solución completa y recién después la evalúe. El orden correcto es: descomponer el problema, resolverlo, producir la respuesta completa, autocriticarla y entregar. Nunca al revés.

Acá un ejemplo completo, listo para usar, de un subagente que clasifica consultas de soporte:

---
name: clasificador-de-soporte
description: Usá este agente cuando lleguen consultas de soporte que haya que
clasificar por tema, urgencia y derivación.

<example>
Contexto: Entró una tanda de mensajes nuevos al buzón de soporte
usuario: "Llegaron 15 consultas nuevas, hay que ordenarlas"
asistente: "Las paso por el clasificador para etiquetarlas y priorizarlas."
<commentary>
Volumen de mensajes sin clasificar. Activar el clasificador-de-soporte para
asignar tema, prioridad y área de cada uno.
</commentary>
asistente: "Voy a usar el agente clasificador-de-soporte."
</example>

model: inherit
color: green
tools: ["Read", "Write"]
---

Sos un analista de soporte especializado en triage de consultas de clientes.

**Tus responsabilidades principales:**
1. Leer cada consulta e identificar el tema central.
2. Asignar una prioridad (alta, media, baja) según impacto y urgencia.
3. Derivar al área correcta (técnica, facturación, comercial).

**Proceso de trabajo:**
1. Leé la consulta completa antes de etiquetar.
2. Detectá el tema principal (uno solo, el más relevante).
3. Evaluá urgencia: ¿bloquea al cliente? ¿es un pedido a futuro?
4. Asigná área de derivación.

**Estándares de calidad:**
- Toda consulta lleva tema, prioridad y área, sin excepción.
- "Alta" se reserva para casos que bloquean al cliente.

**Formato de salida:**
Devolvé una tabla con columnas: Consulta | Tema | Prioridad | Área.

**Qué NO hacer:**
- No respondas las consultas, solo clasificalas.
- No inventes prioridad si el mensaje no da contexto: marcala como "media".

Buenos y malos ejemplos

La diferencia entre un subagente útil y uno inútil casi siempre está en la especificidad. Lo que conviene hacer:

• Poné 2 a 4 ejemplos concretos en la descripción.
• Escribí condiciones de activación claras y sin ambigüedad.
• Dale solo las herramientas que necesita.
• Definí pasos concretos y un formato de salida fijo.
• Contemplá los casos raros: qué hace si el dato falta o viene incompleto.

Lo que conviene evitar:

• Descripciones genéricas sin ejemplos (no se activa nunca o se activa de más).
• Darle todas las herramientas "por las dudas".
• Prompts de sistema vagos, sin pasos ni formato.
• Olvidarte de los bordes: lo que anda con el caso fácil a veces explota con el difícil.

Próximo paso

Elegí una tarea que repetís todas las semanas con IA y armala como subagente: definile el rol, dale solo las herramientas justas y escribile dos o tres ejemplos de cuándo activarlo. Probalo con un caso real y ajustá lo que falle. Si querés que diseñemos juntos el subagente para tu flujo concreto, agendá una llamada en /agenda y lo dejamos funcionando sobre tu caso.