Registro y gestión de subagentes
Descripción general
La página SubAgent (Settings → GWork Settings → SubAgent) se utiliza para registrar previamente subagentes con configuraciones específicas. Los subagentes registrados previamente se inyectan automáticamente en el prompt de sistema del Agent principal, y el Agent principal les delega tareas (mediante dispatch_sub_agent) cuando encuentra una tarea que encaja.
Hasta que crees uno, la página muestra «No sub-agents registered yet»: la herramienta
dispatch_sub_agentsolo se habilita para el Agent principal cuando existe al menos un subagente.
Configuración del subagente
Haz clic en + SubAgent para abrir el formulario Create sub-agent:
| Campo | Descripción | Obligatorio |
|---|---|---|
| ID | Identificador único, p. ej. code-reviewer |
Sí |
| Name | Nombre visible, p. ej. Code Reviewer |
Sí |
| Description | Qué hace el subagente. El Agent principal la lee para decidir cuándo delegarle tareas; mantenla precisa y concisa | Sí |
| System prompt | Se carga al delegar; se convierte en la identidad del subagente y afecta directamente a la calidad de la tarea | Sí |
| Max turns | Número máximo de turnos de bucle por delegación. Déjalo vacío para usar el valor predeterminado de la aplicación (50) | No |
| Can spawn sub-agents | Si este subagente puede crear a su vez más subagentes | No (activado por defecto) |
Haz clic en Save para registrarlo. Los subagentes heredan el modelo y las herramientas del Agent principal, salvo que el contexto de la tarea indique lo contrario.
Operaciones de gestión
| Operación | Descripción |
|---|---|
| + SubAgent | Crea un nuevo subagente registrado previamente |
| Edit | Abre un subagente existente y modifica su configuración |
| Delete | Elimina un subagente registrado previamente |
Interacción con las conversaciones
- Inyección en el prompt de sistema: el Name y la Description de cada subagente se incluyen en el prompt de sistema del Agent principal
- Coincidencia automática: el Agent principal selecciona el subagente adecuado según la semántica de la tarea
- Invocación manual: puedes nombrar un subagente en tu mensaje para solicitarlo explícitamente
Las ejecuciones de subagentes están limitadas por Max turns aquí y por el Sub-agent timeout (minutes) en Settings → Task Control (30 minutos por defecto; el trabajo completado se conserva cuando se cancela un subagente).
Ejemplos de casos de uso
| Subagente | Descripción | Herramientas típicas |
|---|---|---|
| Code Reviewer | Revisa el código en cuanto a corrección, rendimiento y seguridad | Read file, Search in files, Find files |
| Document Writer | Redacta y da formato a documentos | Write file, habilidades docx / pptx |
| Research Assistant | Busca y recopila información | Browser, habilidad web-search |
| Data Analyst | Procesa y analiza datos | Run command, Read file, Write file |
Guía práctica: crear un subagente registrado previamente
- Abre App → ⚙ Settings → SubAgent
- Haz clic en + SubAgent
- Rellena:
- ID:
code-reviewer - Name:
Code Reviewer - Description: «Revisa el código en cuanto a corrección, rendimiento y seguridad. Experto en análisis de código en varios lenguajes.»
- System prompt: «Eres un revisor de código sénior. Analiza el código en cuanto a corrección, rendimiento, seguridad y mantenibilidad. Para cada problema indica una gravedad (baja / media / alta) y una sugerencia de corrección.»
- ID:
- (Opcional) establece Max turns (p. ej. 30) y desactiva Can spawn sub-agents si no se necesita delegación adicional
- Haz clic en Save
Impacto práctico de la profundidad de delegación
| Ajuste | Significado | Impacto en el coste |
|---|---|---|
| Can spawn sub-agents: desactivado | El subagente no puede crear subagentes de nivel inferior | Bajo |
| Can spawn sub-agents: activado | El subagente puede delegar a su vez | Mayor — cada nivel ejecuta su propio Agent Loop y consume sus propios tokens / créditos |
Nota: cada nivel de subagente inicia un Agent Loop independiente (50 turnos por defecto). Una delegación profunda puede multiplicar el coste de una sola tarea; mantén la delegación desactivada para roles especializados sencillos.
Registro previo frente a creación automática: ¿cuál elegir?
| Comparación | Registro previo (dispatch_sub_agent) |
Creación automática (create_local_sub_agent) |
|---|---|---|
| Configuración | Configurado de antemano, de una vez para siempre | Creado temporalmente por el Agent bajo demanda en cada ocasión |
| Consistencia | Usa la misma configuración cada vez, con resultados estables | El Agent puede asignar identidades y herramientas distintas cada vez |
| Escenarios adecuados | Roles profesionales usados con frecuencia y de forma repetida | Descomposición puntual de tareas temporales |
| Prompt de sistema | Inyectado automáticamente en el Agent principal, de modo que el Agent sabe que puede usarlo | El Agent decide por sí mismo si crear uno |
Recomendación: si necesitas con frecuencia cierto tipo de tarea (como revisión de código, redacción de documentos o análisis de datos), crea un subagente registrado previamente. Para la descomposición ocasional de tareas temporales, simplemente deja que el Agent cree uno automáticamente.
Documentación relacionada
- Sistema de subagentes — Uso de subagentes en las conversaciones
- Gestión de herramientas — Herramientas disponibles para los subagentes
- Motor Agent Loop — El Agent Loop utilizado por los subagentes