Formar un equipo de agentes

Esta guía te muestra cómo crear un equipo, darle un líder y dirigirle trabajo.

Un equipo es un grupo con nombre de agentes dentro de un espacio de trabajo, con un agente designado como su líder. Asignar un ticket al equipo despierta al líder, que descompone el trabajo y lo delega a los miembros; cuando termina la ejecución de un miembro, el líder se despierta de nuevo para decidir qué sigue.

Los equipos se crean, se renombran y se dotan de miembros en Ajustes → Espacio de trabajo → Agentes → Equipos. Diriges trabajo a un equipo de dos maneras: un agente llama a assign_ticket con el team_id de ese equipo, o un nodo de pipeline Team dispatch despacha al equipo (sin asignarle un ticket). El selector de asignados de un ticket te incluye a ti y a los agentes individuales.

Crear un equipo

Abre Ajustes → Espacio de trabajo → Agentes (/settings/workspace/agents).
Haz clic en Equipos en el encabezado de la página.
Haz clic en Add team.
Escribe un nombre (por ejemplo, «backend» o «equipo de revisión») y una descripción opcional, y luego haz clic en Crear.

El equipo se crea y queda seleccionado, y su editor se abre en el panel derecho.

Definir el líder

Este es el paso del que depende toda la función. En el editor del equipo:

En Líder, elige un agente. El texto de ayuda lo describe con exactitud: «El coordinador que recibe el trabajo asignado al equipo y lo delega al miembro más adecuado.»
De manera opcional, llena Instrucciones de operación: texto libre que se entrega al líder con cada ticket dirigido al equipo.

Ascender a un agente a líder también lo convierte en miembro si aún no lo era. Un equipo que se queda en Sin líder es inerte: no se despacha nada cuando se le dirige trabajo, y quitar al líder actual de la lista de miembros vuelve a dejar al equipo sin líder.

Agregar miembros

En el mismo editor, usa la tarjeta de miembros para agregar agentes del espacio de trabajo y quitarlos. Los miembros son la lista entre la que el líder delega.

Los equipos pertenecen a un espacio de trabajo: solo pueden unirse agentes de este espacio de trabajo.

Darle un espacio al equipo

No existe un espacio de equipo automático. Si quieres uno, crea un espacio normal desde Espacios y agrega a él los agentes del equipo. Un Team contiene un nombre, una descripción, un líder, instrucciones y miembros, pero ninguna asociación con un espacio.

Las líneas de reporte son algo aparte

Cada agente tiene además un campo Reporta a, que se define en Ajustes → Espacio de trabajo → Agentes. Eso construye el árbol de reporte del espacio de trabajo, que puedes ver con el botón Organigrama de la página de agentes.

No rige el enrutamiento de equipos. Un líder elige a quién delegar de la lista de miembros del equipo según sus skills y su rol, no según la cadena de reporte. Los permisos de acceso a la memoria dependen del rol de un agente, no de la cadena de reporte, y ninguna superficie de analítica agrupa por equipo ni por jerarquía. Las salvaguardas de delegación limitan la profundidad y detectan ciclos, pero nunca exigen que el destino sea un subordinado.

Qué ocurre con un ticket dirigido a un equipo

Cuando un ticket sí lleva una asignación de equipo:

Se despacha al líder del equipo con el ticket, sus instrucciones de operación y la lista de miembros.
El líder delega a los miembros y registra su evaluación con la herramienta record_team_activity: action (delegado), no_action (no hay nada más que hacer, lo que detiene nuevas reactivaciones) o failed.
Cada ejecución de un miembro que termina vuelve a despertar al líder, con el límite de la salvaguarda de no-acción.

El nodo de pipeline Team dispatch es el otro punto de entrada. Recibe un id de equipo, un prompt y un modo de despacho:

allParallel — una tarea por miembro en una conversación oculta compartida, que se suspende hasta que termina cada ejecución, con la salida de cada miembro recopilada bajo la clave de salida del nodo
manager — despacha solo al líder, que coordina en la conversación