Formar un equipo de agentes

Esta guía explica 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 en los miembros; cuando termina la ejecución de un miembro, el líder se despierta de nuevo para decidir qué viene después.

Los equipos se crean, se renombran y se dotan de personal en Ajustes → Espacio de trabajo → Agentes → Teams. Hay dos formas de dirigir trabajo a un equipo: un agente llama a assign_ticket con el team_id de ese equipo, o un nodo de pipeline Team dispatch despacha el 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 Teams en la cabecera de la página.
Haz clic en Add team.
Introduce un nombre (por ejemplo, «backend» o «review squad») y una descripción opcional, y 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.»
Opcionalmente, rellena 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 no lo era ya. Un equipo que se deja 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.

Añadir miembros

En el mismo editor, usa la tarjeta de miembros para añadir agentes del espacio de trabajo y quitarlos. Los miembros son la lista de la que el líder toma a quién delegar.

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

Dar un espacio al equipo

No hay ningún espacio de equipo automático. Si quieres uno, crea un espacio normal desde Espacios y añade 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 otra cosa

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. El líder elige a quién delegar de la lista de miembros del equipo según sus skills y su rol, no siguiendo 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 agrega por equipo ni por jerarquía. Las protecciones 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 asignado un 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 en 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 protección 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, suspendiendo hasta que termina cada ejecución, con la salida de cada miembro recogida bajo la clave de salida del nodo
manager: despacha solo al líder, que coordina en la conversación