> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whaapy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configurar Subagents

> Cómo dividir responsabilidades del agente en especialistas de ventas, soporte, agenda y seguimiento

# 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.

<Tip>
  Si puedes describir la tarea en una frase, probablemente no necesitas subagent. Si necesitas un flujo de varios pasos, sí puede valer la pena.
</Tip>

***

## Subagents comunes

<CardGroup cols={2}>
  <Card title="Ventas" icon="cart-shopping">
    Califica intención, recomienda productos o servicios y guía hacia compra, cotización o agenda.
  </Card>

  <Card title="Soporte" icon="headset">
    Pide datos mínimos, clasifica problema, consulta información y decide si escala.
  </Card>

  <Card title="Agenda" icon="calendar-days">
    Coordina fecha, hora, servicio, confirmación y cambios de cita.
  </Card>

  <Card title="Calificación" icon="clipboard-check">
    Evalúa si un lead cumple requisitos antes de pasarlo a ventas.
  </Card>

  <Card title="Seguimiento" icon="rotate-right">
    Retoma conversaciones abiertas o abandonadas con un objetivo específico.
  </Card>

  <Card title="Cobranza" icon="file-invoice-dollar">
    Explica saldos, próximos pasos y límites antes de escalar a humano.
  </Card>
</CardGroup>

***

## Anatomía de un buen subagent

| Campo             | Qué define                                                    |
| ----------------- | ------------------------------------------------------------- |
| Nombre            | Identidad clara: `Ventas`, `Soporte`, `Agenda`, `Seguimiento` |
| Objetivo          | Resultado que debe buscar                                     |
| Alcance           | Qué puede y no puede resolver                                 |
| Trigger           | Cuándo se activa                                              |
| Instrucciones     | Cómo debe comportarse                                         |
| Tools permitidas  | Acciones que puede usar                                       |
| Handoff           | Cuándo devuelve o escala a humano                             |
| Criterio de éxito | Cómo saber que terminó bien                                   |

***

## Cómo configurarlo

<Steps>
  <Step title="Define el objetivo">
    Escribe una meta concreta: "calificar leads para una cita", "resolver dudas de envíos" o "agendar servicios".
  </Step>

  <Step title="Define activadores">
    Agrega frases, intenciones o condiciones que deberían activar el subagent.
  </Step>

  <Step title="Limita el alcance">
    Di explícitamente qué no debe resolver. Esto evita que invada otros flujos.
  </Step>

  <Step title="Asigna knowledge y tools">
    Conecta solo la información y acciones necesarias para esa tarea.
  </Step>

  <Step title="Define handoff">
    Decide cuándo debe pasar a humano o devolver el control al agente principal.
  </Step>

  <Step title="Prueba conversaciones">
    Usa ejemplos reales: casos fáciles, ambiguos, incompletos y casos que deben escalar.
  </Step>
</Steps>

***

## Ejemplo: subagent de ventas

```text theme={null}
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

```text theme={null}
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

```text theme={null}
quiero cotizar
quiero agendar
tengo un problema con mi pedido
quiero hablar con soporte
cuanto cuesta
```

### Triggers riesgosos

```text theme={null}
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

<Warning>
  Un subagent sin reglas de salida puede quedarse intentando resolver casos que deberían pasar a humano.
</Warning>

***

## Errores comunes

| Error                     | Resultado                       | Mejor enfoque             |
| ------------------------- | ------------------------------- | ------------------------- |
| Subagent demasiado amplio | Se vuelve otro agente principal | Dale un objetivo estrecho |
| Triggers genéricos        | Se activa cuando no debe        | Usa intención concreta    |
| Sin handoff               | Se atasca en casos complejos    | Define salida clara       |
| Demasiadas tools          | Acciones impredecibles          | Permite solo lo necesario |
| Duplicar knowledge        | Mantenimiento difícil           | Usa Knowledge compartida  |

***

## Siguiente paso

<CardGroup cols={2}>
  <Card title="Tools" icon="wrench" href="/guides/agent-tools">
    Asigna acciones concretas a cada especialista.
  </Card>

  <Card title="MCPs" icon="plug" href="/guides/agent-mcps">
    Conecta sistemas externos cuando el subagent necesite datos o acciones fuera de Whaapy.
  </Card>
</CardGroup>