Subagentes
Un subagente es una segunda persona dentro del mismo agente: con su propio prompt, voz, modelo, herramientas y conocimiento, que se hace cargo de parte de una llamada y la devuelve cuando termina. Un agente puede tener un pequeño flujo de subagentes -- una recepción que deriva a facturación, un especialista de ventas, una persona que habla español -- sin que quien llama note nada más que un cambio de voz.
El agente asignado al número de teléfono sigue siendo el agente principal durante toda la llamada. Conserva el registro de llamada, la grabación, la transcripción, el webhook y la facturación. Un subagente solo cambia cómo suena y razona el asistente mientras está activo.
Los subagentes están disponibles en agentes que usan el flujo estándar de voz a texto -> modelo de lenguaje -> texto a voz. Un agente con un proveedor de voz a voz no muestra la sección en absoluto: una sesión en vivo fija sus instrucciones, su voz y sus herramientas en cuanto se conecta, así que no hay nada que traspasar. Los subagentes existentes se conservan si cambias un agente a voz a voz y vuelves atrás.
Dónde encontrarlo
Abre Agentes, haz clic en el agente y baja hasta Subagentes y transiciones. Guarda el agente una vez antes de configurar subagentes: la sección aparece en un agente que ya existe, no en el formulario de creación.
La sección muestra todo el flujo en un mismo sitio:
- Nodos: primero el agente principal y después cada subagente. Cada fila indica con qué proveedor de voz habla ese nodo y qué ajustes sobrescribe.
- Transiciones: cada movimiento entre dos nodos, qué lo dispara y cuántas veces se ha disparado.
Qué puede cambiar un subagente
Todo lo del editor de un subagente es opcional. Si dejas un campo con su valor heredado, el subagente se comporta exactamente como el agente principal en ese ajuste, de modo que un subagente que solo cambia el prompt conserva la voz, el modelo y las herramientas del agente principal.
Un subagente puede sobrescribir:
- Prompt del sistema: cómo se comporta mientras atiende.
- Modelo de lenguaje y proveedor de voz, además de la voz en sí.
- Frase de entrada: se dice la primera vez que quien llama llega a este subagente en una llamada, y no se repite si vuelve a él.
- Interrumpibilidad, sensibilidad de interrupción y la señal de pensamiento.
- Transferencia a una persona, con sus propios destinos.
- Qué integraciones, endpoints personalizados y entradas de la base de conocimiento del agente puede usar. "Heredar todo" le da todo lo que tiene el agente principal; desactívalo para elegir un subconjunto.
- Una comprobación de entrada: ver más abajo.
Qué queda bloqueado en el agente principal
Estos ajustes pertenecen a la llamada en su conjunto y no se pueden sobrescribir. El editor los lista bajo un candado para que quede claro de dónde vienen:
números de teléfono, voz a texto, idioma de la llamada, velocidad de respuesta, límites de llamada y silencio, detección de contestador, grabación de llamadas, análisis automático, el webhook y las variables personalizadas declaradas.
Un subagente no tiene ningún campo para ninguno de ellos, así que ninguna configuración puede cambiar uno por accidente a mitad de llamada.
Añadir un subagente
- Haz clic en Añadir subagente.
- Ponle un nombre. Ese nombre es el que usa la IA al ceder la conversación, así que hazlo descriptivo: "Facturación", "Español", "Reservas". Debe ser distinto del nombre del agente principal y del de cualquier otro subagente del mismo agente.
- Sobrescribe lo que deba cambiar y deja el resto heredado.
- Haz clic en Guardar.
Un agente admite hasta 20 subagentes.
Transiciones
Una transición es un movimiento en un solo sentido de un nodo a otro. Ambos extremos deben pertenecer al mismo agente, y una transición puede apuntar de vuelta al agente principal o a un nodo que la llamada ya haya visitado, de modo que quien llama puede moverse entre personas más de una vez.
Haz clic en Añadir transición, elige un nodo Desde y uno Hasta, y después qué la dispara:
| Disparador | Se dispara cuando |
|---|---|
| Coincidencia de variable | Una variable de la llamada es igual al valor que indiques. Se comprueba antes de preguntar nada a la IA, así que es exacto y predecible. |
| Resultado de la comprobación de entrada | El resultado de la comprobación de entrada del nodo de origen coincide, por código de estado o por cuerpo de la respuesta. |
| Criterio del modelo | La IA decide, a partir de la conversación, que se cumple tu condición en lenguaje natural. |
Escribe una condición de criterio del modelo tal como aparecería en la transcripción, igual que escribirías una condición de transferencia a una persona: "El llamante pregunta por una factura, un pago o su recibo."
Los disparadores deterministas se comprueban primero; el criterio del modelo es el recurso cuando ninguno se dispara. Cada nodo admite hasta 20 transiciones de salida, y una misma llamada puede tomar como máximo 10 transiciones en total: a partir de ahí la llamada simplemente continúa con el nodo activo, nunca termina por ello.
Comprobaciones de entrada
Una comprobación de entrada es uno de los endpoints personalizados del agente, llamado automáticamente en cuanto un subagente se activa, antes de que quien llama diga nada. Su resultado puede disparar una transición por sí solo, y así el flujo puede enrutar por un hecho -- "este cliente tiene una factura vencida" -- en lugar de por lo que la persona mencione.
Elige el endpoint en el editor del subagente y añade los argumentos que necesite. Una transición de tipo Resultado de la comprobación de entrada exige que su nodo de origen tenga una configurada.
El aviso de voces de distinto proveedor
Si dos nodos unidos por una transición usan proveedores de voz distintos, la fila de la transición muestra un aviso. El traspaso funciona igualmente, pero la nueva voz tiene que conectarse antes de poder hablar, así que quien llama puede oír una pausa breve en ese punto. Dos nodos con el mismo proveedor de voz se traspasan sin ningún hueco perceptible. Mantener un flujo en un solo proveedor de voz es la forma más sencilla de evitarlo.
Recuento de disparos
Cada transición muestra cuántas veces se ha disparado, o Nunca se ha disparado. Es la forma más rápida de detectar una condición que la IA nunca considera cierta, o una variable que nunca toma el valor que esperabas.
Agentes compartidos
El acceso a los subagentes de un agente sigue el mismo permiso ya configurado sobre el agente. Quien tiene el agente compartido en modo lectura ve todo el flujo pero ningún control de edición, y la sección aparece marcada como Solo lectura. Un permiso de escritura puede cambiarlo todo.
Revisar una llamada
Abre una llamada en Llamadas y la vista de detalle muestra qué nodos la atendieron:
- Nodos de esta llamada los lista en orden, con la hora en que se entró en cada uno y qué disparó el cambio. Si no se pudo entrar en un subagente -- porque se eliminó después de iniciarse la llamada, por ejemplo -- la entrada se marca como vuelta al agente principal, y la llamada continuó en lugar de terminar.
- Cada turno de la transcripción lleva la etiqueta del nodo que lo produjo, así se ve qué persona dijo cada cosa.
Ambas aparecen solo en llamadas que realmente usaron subagentes. Todo lo demás sigue igual: un registro, una grabación, una transcripción y un webhook.
API
Todo lo de esta página está disponible por API: consulta Subagentes en la referencia de la API.