logo
Desarrollo
ResumenEspacioDesarrolloEspacioTrabajoReferenciaAPIMejoresPrácticasRegistroCambios
Buscar
Español
EspacioTrabajo / ConfiguraciónApp / GestiónSubagentes
Registro y gestión de subagentes
Última actualización：hace 9 días

Registro y gestión de subagentes

Descripción general

La página de gestión de subagentes se utiliza para prerregistrar subagentes con configuraciones específicas. Los subagentes prerregistrados se inyectan automáticamente en el prompt del sistema del Agent principal, y el Agent los selecciona y ejecuta de forma automática cuando encuentra una tarea que coincide.

Página de gestión de subagentes-CN

Configuración de subagentes prerregistrados

Configuración básica

Parámetro Descripción Obligatorio
name Nombre del subagente Sí
description Descripción de capacidades (se inyecta en el prompt del sistema del Agent padre) Sí
systemPrompt Definición de identidad/rol Sí

Configuración de herramientas

Parámetro Descripción
tools Lista blanca de herramientas (si se omite, hereda todas las herramientas del padre)
disallowedTools Lista negra de herramientas (excluye a partir de las heredadas)
skills Lista de ID de habilidades disponibles
mcpServers Lista de nombres de servidores MCP disponibles

Configuración de ejecución

Parámetro Descripción Valor predeterminado
model Sobrescribe el modelo LLM del padre Hereda del padre
maxTurns Número máximo de rondas del bucle 50
canSpawn Si puede crear subagentes de nivel inferior false
maxSpawnDepth Profundidad máxima de anidamiento (1-3) 1

Operaciones de gestión

Operación Descripción
Añadir Crear un nuevo subagente prerregistrado
Editar Modificar la configuración de un subagente existente
Eliminar Quitar un subagente prerregistrado
Ordenar Ajustar el orden de los subagentes en la lista

Interacción con la conversación de Work

Los subagentes prerregistrados interactúan con la conversación de Work de las siguientes maneras:

  1. Inyección en el prompt del sistema: el name y la description del subagente se incluyen en el prompt del sistema del Agent principal
  2. Coincidencia automática: el LLM selecciona automáticamente el subagente adecuado según la semántica del mensaje del usuario
  3. Llamada manual: el usuario puede indicar en la conversación que se utilice un subagente concreto

Ejemplos de casos de uso

Nombre del subagente Descripción Herramientas especializadas
Revisor de código Encargado de la revisión de código y el análisis de calidad Read File, Search Files, Glob
Redactor de documentación Encargado de redactar y dar formato a la documentación Write File, Edit, Web Fetch
Asistente de investigación Encargado de la búsqueda de información y la recopilación de datos Web Fetch, Search Files
Analista de datos Encargado del procesamiento y análisis de datos Bash, Read File, Write File

Guía de operación: crear un subagente prerregistrado

Pasos

  1. Abre la APP → Configuración → Subagentes
  2. Haz clic en Añadir subagente
  3. Rellena la información básica:
    • Nombre: por ejemplo, "Revisor de código"
    • Descripción: por ejemplo, "Encargado de revisar la calidad del código, detectar posibles bugs y ofrecer sugerencias de optimización" (esta descripción se inyecta en el prompt del sistema del Agent principal y ayuda al Agent a decidir cuándo llamarlo)
    • Prompt del sistema: por ejemplo, "Eres un experto sénior en revisión de código, enfocado en la calidad, el rendimiento, la seguridad y la mantenibilidad del código..."
  4. (Opcional) Configura la lista blanca/negra de herramientas
  5. (Opcional) Sobrescribe el modelo o ajusta maxTurns
  6. Guarda

Ejemplo de configuración: subagente "Revisor de código"

名称: 代码审查员 描述: 负责审查代码质量、发现潜在 bug、提供优化建议。擅长多语言代码分析。 系统提示: 你是一位资深代码审查专家。你的职责是： 1. 分析代码质量和可维护性 2. 发现潜在的 bug 和安全漏洞 3. 提供具体的优化建议 请对每个问题给出严重等级（低/中/高）和修复建议。 工具白名单: Read File, Search Files, Glob Files（只需要读取能力，不需要修改） 模型: Claude Sonnet 4（推理能力强） maxTurns: 30 canSpawn: false（不需要再委派）
                      
                      名称: 代码审查员
描述: 负责审查代码质量、发现潜在 bug、提供优化建议。擅长多语言代码分析。
系统提示: 你是一位资深代码审查专家。你的职责是：
  1. 分析代码质量和可维护性
  2. 发现潜在的 bug 和安全漏洞
  3. 提供具体的优化建议
  请对每个问题给出严重等级（低/中/高）和修复建议。
工具白名单: Read File, Search Files, Glob Files（只需要读取能力，不需要修改）
模型: Claude Sonnet 4（推理能力强）
maxTurns: 30
canSpawn: false（不需要再委派）
Este bloque de código en una ventana flotante

Impacto real de maxSpawnDepth

Ajuste Significado Caso de uso Impacto en el coste
1 (predeterminado) El subagente no puede crear subagentes de nivel inferior Tareas especializadas sencillas Bajo
2 El subagente puede crear un nivel más de subagentes Tareas de complejidad media que requieren una segunda descomposición Medio
3 Profundidad máxima de anidamiento, permite delegación de tres niveles Tareas altamente complejas de múltiples pasos Alto (cada nivel de subagente consume tokens de forma independiente)

Nota: cada nivel de subagente inicia un Agent Loop independiente (50 rondas de forma predeterminada) y consume tokens de LLM independientes. Una profundidad de 3 significa que puede haber hasta 4 Agents ejecutándose simultáneamente (el principal + 3 niveles de subagentes), y el coste puede ser varias veces el de un único Agent.

Prerregistro vs. creación automática: ¿cómo elegir?

Comparación Prerregistro (dispatch_sub_agent) Creación automática (create_local_sub_agent)
Configuración Configurado de antemano, de una vez por todas El Agent lo crea temporalmente según la necesidad de cada vez
Consistencia Usa la misma configuración cada vez, resultados estables El Agent puede asignar una identidad y herramientas diferentes cada vez
Escenario adecuado Roles profesionales de uso frecuente y repetido Descomposición temporal de tareas puntuales
Prompt del sistema Se inyecta automáticamente en el Agent principal, que sabe que puede usarlo El Agent decide de forma autónoma si crearlo

Recomendación: si necesitas cierto tipo de tarea con frecuencia (como revisión de código, redacción de documentación o análisis de datos), crea un subagente prerregistrado. Para descomposiciones temporales de tareas ocasionales, deja que el Agent lo cree automáticamente.

Documentos relacionados