Supervisor Agent
Supervisor Agent coordina a un equipo de agentes. Recibe la petición, decide qué agente especializado debe atenderla, se la pasa y, cuando ese agente termina, decide si hace falta otro o si ya puede dar la respuesta final. Cada agente del equipo puede tener sus propias instrucciones y herramientas.
Úsalo cuando una sola petición pueda requerir conocimientos distintos (ventas, soporte técnico, facturación…) y prefieras tener un agente experto para cada área en lugar de uno solo que lo haga todo.
Cuándo usarlo
- Un asistente de empresa que reparte las consultas entre un agente de ventas, uno de soporte y uno de facturación.
- Un proceso en el que un agente investiga y otro redacta el resultado.
- Peticiones que mezclan varios temas y necesitan la ayuda de más de un especialista.
- Organizar un equipo de agentes que ya tienes construidos con Agent.
Configuración
| Conexión | Qué conectar |
|---|---|
| Model (obligatorio) | El modelo de IA con el que el supervisor decide a quién delegar. |
| Worker Agents | Los agentes especializados del equipo. Conecta aquí la salida Agent de cada uno. El supervisor los distingue por su nombre y su descripción, así que rellena bien Agent Name y Agent Description en cada uno. |
| Tools | Herramientas que el propio supervisor puede usar, además de delegar. |
| Campo | Qué hace |
|---|---|
| Agent Name | Nombre del supervisor. Por defecto: SupervisorAgent. |
| Agent Description | Qué hace el supervisor. Se usa cuando es a su vez herramienta o miembro del equipo de otro supervisor. |
| Input | El mensaje inicial, normalmente desde Chat Input. |
| System Prompt | Las instrucciones del supervisor: cómo debe repartir el trabajo y qué debe entregar. Por defecto: You are a helpful assistant. |
| User Prompt | La plantilla del mensaje que recibe el supervisor. Por defecto: {input}. Cada variable entre llaves se convierte en un campo con ese nombre. |
| Output Mode | Qué recibe el supervisor de cada agente del equipo: last_message (por defecto) solo su respuesta final; full_history, toda su conversación de trabajo. |
Opciones avanzadas
| Campo | Qué hace |
|---|---|
| Use as Router | El supervisor solo elige qué agente responde y no redacta una respuesta propia: la respuesta es la del agente elegido. Por defecto: desactivado. |
| Add Handoff Messages | Deja constancia en la conversación de cada vez que el supervisor pasa el trabajo a un agente. Por defecto: desactivado. |
| Add Handoff Back Messages | Deja constancia en la conversación de cada vez que un agente devuelve el trabajo al supervisor. Por defecto: desactivado. |
| Max Iterations | Número máximo de pasos que puede dar el equipo en una respuesta. Por defecto: 50. |
| Memory top message | Cuántos mensajes anteriores de la conversación recibe el supervisor como contexto. Por defecto: -1, todos. |
| Use short term memory | El supervisor recuerda la conversación entre mensajes. Por defecto: activado. |
| Stream | La respuesta aparece en el chat a medida que se genera. |
| Verbose | Registra la ejecución con más detalle, útil para revisar cómo se repartió el trabajo. |
| Tool Schema | Los datos que recibe el supervisor cuando otro agente lo usa como herramienta (nombre, tipo, si es obligatorio y descripción de cada uno). Cada dato rellena la variable de User Prompt con el mismo nombre, así que incluye al menos uno llamado input si mantienes la plantilla por defecto. |
Resultado
- Response: la respuesta final como mensaje. Conéctala a Chat Output.
- Agent: el supervisor configurado, para usarlo como miembro del equipo de otro supervisor.
- Tool: el supervisor convertido en herramienta, para la entrada Tools de otro agente. Necesita Tool Schema.
Ejemplo
La tienda online Casa Verde atiende por chat. Crea tres componentes Agent: “Ventas” (con su catálogo como herramienta), “Envíos” (con la herramienta de seguimiento de pedidos) y “Devoluciones”. Rellena el nombre y la descripción de cada uno y conecta su salida Agent a Worker Agents del Supervisor Agent. En System Prompt del supervisor escribe: “Eres el coordinador de atención al cliente de Casa Verde. Pasa cada consulta al agente adecuado y responde al cliente con su información.” Cuando un cliente pregunta dónde está su pedido, el supervisor lo deriva a “Envíos” y devuelve su respuesta.
Componentes relacionados
- Agent: para crear cada agente del equipo.
- Router Agent: envía cada mensaje a una rama distinta del flujo según su intención.
- Deep Agent: también puede delegar en subagentes, pensado para tareas largas.