Sistema de subagentes

Descripción general

El subagente (Subagent) es el mecanismo de descomposición y delegación de tareas del espacio de trabajo. El Agent principal puede dividir tareas paralelas complejas en subtareas, crear subagentes especializados para ejecutarlas de forma independiente y, una vez que el subagente termina, este devuelve el resultado al Agent principal para que continúe su procesamiento.

El sistema admite tres tipos de subagentes, con una profundidad máxima de anidamiento de 3 niveles.

Tres tipos de subagentes

Subagente de creación automática (create_local_sub_agent)

Cuando el Agent determina durante el razonamiento que la tarea actual necesita descomponerse, invoca de forma autónoma la herramienta create_local_sub_agent para crear un subagente temporal. El usuario también puede solicitar al Agent que cree un subagente mediante indicaciones en la conversación, por ejemplo:

"Crea un subagente que se encargue de buscar información relevante y luego crea otro subagente que redacte la documentación"

Parámetros de creación:

Flujo de ejecución:

1. El Agent principal decide crear un subagente y especifica la tarea
2. El sistema inicia un Agent Loop independiente (máximo 50 rondas por defecto)
3. El subagente dispone de su propio bucle de herramientas y su proceso de ejecución es visible en la ventana de conversación principal
4. Una vez completado, el subagente devuelve el resultado final al Agent principal
5. El Agent principal continúa el trabajo posterior basándose en el resultado

Subagente de distribución preregistrada (dispatch_sub_agent)

El usuario puede preregistrar en la configuración de la APP subagentes con una configuración específica, que el Agent invoca cuando lo necesita mediante la herramienta dispatch_sub_agent.

La descripción del subagente preregistrado se inyecta automáticamente en el system prompt del Agent principal, de modo que, cuando el LLM detecta una tarea coincidente, selecciona automáticamente el subagente adecuado.

Elementos de configuración:

Consulta los detalles de la interfaz de administración en Registro y gestión de subagentes.

Distribución entre nodos (dispatch_multi_node_agent)

Cuando una tarea requiere recursos o capacidades de un dispositivo remoto, el Agent puede distribuir la tarea a otros nodos para su ejecución mediante la herramienta dispatch_multi_node_agent.

Flujo de trabajo:

1. El Agent principal consulta la lista de nodos en línea (inyectada en el system prompt)
2. Selecciona el nodo objetivo según la declaración de capacidades de cada nodo
3. Envía node.invoke.request a través del WebSocket del Gateway
4. El nodo remoto inicia un Agent Loop independiente para ejecutar la tarea
5. Una vez completada, devuelve el resultado mediante node.invoke.result

Ejemplo de escenario:

• Se inicia una conversación en el cliente web del ordenador A
• La tarea necesita acceder a archivos locales del ordenador B
• El Agent distribuye la subtarea de operación de archivos al nodo APP del ordenador B a través del Gateway
• El nodo B ejecuta la tarea y devuelve el resultado, y la conversación continúa mostrándose en el ordenador A

Control de la profundidad de anidamiento

Los subagentes admiten creación anidada, con una profundidad máxima de 3 niveles:

                      
                      深度 0: 主 Agent（用户对话）
  └── 深度 1: 子代理 A
        └── 深度 2: 子子代理 A-1
              └── 深度 3: 最深层代理（不可再委派）

                    

Cuanto mayor sea la profundidad, mayor será la autonomía, pero también aumentarán en consecuencia el consumo de Tokens y el tiempo de ejecución.

Mecanismo de herencia de herramientas

Presentación en la interfaz

Los subagentes se muestran con marcas especiales en la ventana de conversación de Work:

El usuario puede ver con claridad qué operaciones ejecuta el Agent principal y cuáles ejecuta el subagente.

Cómo crear subagentes mediante la conversación

Puedes solicitar al Agent que cree subagentes usando lenguaje natural en la conversación. A continuación se muestran algunas indicaciones de ejemplo:

Interpretación de la interfaz durante la ejecución del subagente

Impacto en los costes

El consumo de tokens de los subagentes se calcula de forma independiente:

Recomendación: los subagentes son adecuados para tareas complejas que realmente necesitan descomponerse. Para tareas sencillas, deja que el Agent principal las gestione directamente; no es necesario crear subagentes.

Cuándo usar / no usar subagentes

No se recomienda asignar a los SubAgent distintos roles para que colaboren dividiéndose el trabajo; en la era de la IA, la colaboración tiende a reducir la eficiencia y la calidad. Resultan más adecuados para escenarios de ejecución de tareas en paralelo con el fin de ahorrar tiempo y mejorar la eficiencia.

Documentos relacionados

• Registro y gestión de subagentes — Configuración de subagentes preregistrados
• Arquitectura multinodo — Mecanismo subyacente de la distribución entre nodos
• Motor de bucle del Agent — El Agent Loop que utilizan los subagentes