Skip to main content

​
Configurar Subagents

La tab Subagents permite separar responsabilidades del agente principal en especialistas. Un subagent no es otro bot aislado. Es una forma de darle al agente principal una capacidad especializada con objetivo, reglas y límites propios.

​
Cuándo crear un subagent

Crea un subagent cuando un flujo:
  • tiene un objetivo claro y repetible
  • requiere instrucciones distintas al agente principal
  • usa herramientas específicas
  • tiene criterios propios de éxito
  • debe escalar a humano bajo reglas particulares
  • hace que el prompt principal crezca demasiado
No crees un subagent para una regla pequeña. Para eso usa Control, Knowledge o el prompt general.
Si puedes describir la tarea en una frase, probablemente no necesitas subagent. Si necesitas un flujo de varios pasos, sí puede valer la pena.

​
Subagents comunes

Ventas

Califica intención, recomienda productos o servicios y guía hacia compra, cotización o agenda.

Soporte

Pide datos mínimos, clasifica problema, consulta información y decide si escala.

Agenda

Coordina fecha, hora, servicio, confirmación y cambios de cita.

Calificación

Evalúa si un lead cumple requisitos antes de pasarlo a ventas.

Seguimiento

Retoma conversaciones abiertas o abandonadas con un objetivo específico.

Cobranza

Explica saldos, próximos pasos y límites antes de escalar a humano.

​
Anatomía de un buen subagent

CampoQué define
NombreIdentidad clara: Ventas, Soporte, Agenda, Seguimiento
ObjetivoResultado que debe buscar
AlcanceQué puede y no puede resolver
TriggerCuándo se activa
InstruccionesCómo debe comportarse
Tools permitidasAcciones que puede usar
HandoffCuándo devuelve o escala a humano
Criterio de éxitoCómo saber que terminó bien

​
Cómo configurarlo

1

Define el objetivo

Escribe una meta concreta: “calificar leads para una cita”, “resolver dudas de envíos” o “agendar servicios”.
2

Define activadores

Agrega frases, intenciones o condiciones que deberían activar el subagent.
3

Limita el alcance

Di explícitamente qué no debe resolver. Esto evita que invada otros flujos.
4

Asigna knowledge y tools

Conecta solo la información y acciones necesarias para esa tarea.
5

Define handoff

Decide cuándo debe pasar a humano o devolver el control al agente principal.
6

Prueba conversaciones

Usa ejemplos reales: casos fáciles, ambiguos, incompletos y casos que deben escalar.

​
Ejemplo: subagent de ventas

Nombre: Ventas

Objetivo:
Ayudar al cliente a elegir el servicio correcto y llevarlo a cotización o agenda.

Activadores:
- "quiero precio"
- "me interesa"
- "qué paquete me recomiendas"
- "quiero contratar"

Alcance:
Puede explicar servicios, hacer preguntas de calificación y recomendar siguientes pasos.
No puede prometer descuentos no documentados ni cerrar condiciones especiales.

Tools:
- buscar catálogo
- consultar disponibilidad
- transferir a humano

Handoff:
Transferir si el cliente pide descuento especial, contrato empresarial o negociación manual.

​
Ejemplo: subagent de soporte

Nombre: Soporte

Objetivo:
Entender el problema del cliente y resolver dudas frecuentes antes de escalar.

Activadores:
- "tengo un problema"
- "no funciona"
- "quiero reclamar"
- "necesito ayuda con mi pedido"

Alcance:
Puede pedir datos mínimos, consultar políticas y explicar siguientes pasos.
No debe inventar estados de pedido si no tiene una tool conectada.

Tools:
- consultar pedido
- crear ticket
- transferir a humano

Handoff:
Transferir si hay enojo, datos sensibles, reclamo legal o error repetido.

​
Triggers de activación

​
Buenos triggers

quiero cotizar
quiero agendar
tengo un problema con mi pedido
quiero hablar con soporte
cuanto cuesta

​
Triggers riesgosos

hola
ayuda
info
producto
Los triggers genéricos activan subagents en conversaciones donde no hacen falta.

​
Handoff entre subagents y humano

Define qué pasa cuando el subagent no puede completar la tarea. Opciones comunes:
  • devolver control al agente principal
  • pedir un dato faltante
  • activar una tool de handoff
  • pausar la IA
  • transferir a un equipo humano
Un subagent sin reglas de salida puede quedarse intentando resolver casos que deberían pasar a humano.

​
Errores comunes

ErrorResultadoMejor enfoque
Subagent demasiado amplioSe vuelve otro agente principalDale un objetivo estrecho
Triggers genéricosSe activa cuando no debeUsa intención concreta
Sin handoffSe atasca en casos complejosDefine salida clara
Demasiadas toolsAcciones impredeciblesPermite solo lo necesario
Duplicar knowledgeMantenimiento difícilUsa Knowledge compartida

​
Siguiente paso

Tools

Asigna acciones concretas a cada especialista.

MCPs

Conecta sistemas externos cuando el subagent necesite datos o acciones fuera de Whaapy.