Subagentes: delegar tareas especializadas
En esta página
Lección actualizada el 2 de noviembre de 2026. Los archivos de ejemplo de agentes usan ahora las claves documentadas por Vibe:
instructions(en lugar desystem_prompt),active_model(en lugar demodel), bloques[tools.<tool>]para aprobaciones (la claveauto_approveno existe en un archivo de agente) y nombres reales de herramientas (edit, noedit_file; sin herramientalist_dir). Recordatorio de la Lección 3:safetyes un indicador visual, no un permiso. Fuente: Referencia de configuración.
El principio de delegación
En proyectos complejos, ciertas tareas son independientes entre sí: analizar la seguridad de un archivo mientras otro proceso genera pruebas. En lugar de gestionar todo secuencialmente, Mistral Vibe te permite delegar tareas a subagentes. Un subagente es un agente que se ejecuta de forma independiente, completa su misión y devuelve un resultado en texto al agente principal. No puede hacer preguntas al usuario: debe ser totalmente autónomo.
Esta restricción es la clave de todo lo que sigue y merece un detalle exhaustivo. Un subagente se ejecuta en su propio contexto, sin acceso a la conversación actual; no sabe nada de lo que le has explicado al agente principal hace cinco minutos. No puede usar ask_user_question y debe resolver la ambigüedad por sí mismo. Devuelve un texto que el agente principal integra luego en su respuesta. Al estar aislado del intercambio, solo tiene sentido cuando se diseña para una tarea específica y bien definida.
Configuración de un subagente
Para convertir un agente en subagente, añade el campo agent_type = "subagent" al archivo .toml. El resto de la configuración sigue las reglas habituales para agentes personalizados.
# ~/.vibe/agents/test-generator.toml
display_name = "Generador de pruebas"
description = "Genera pruebas unitarias para funciones dadas."
agent_type = "subagent"
safety = "neutral"
active_model = "codestral" # alias declarado en config.toml (Lección 2)
instructions = """
Recibes código fuente. Genera pruebas unitarias exhaustivas:
- Pruebas de caso nominal
- Pruebas de casos límite (null, undefined, cadenas vacías)
- Pruebas de errores esperados
Marco de trabajo: usa el framework de pruebas del proyecto (Jest, Vitest, Pytest...).
Devuelve solo el código de prueba, listo para copiar.
"""
enabled_tools = [
"read_file",
"grep",
]
Observa la ausencia de ask_user_question en las herramientas: no es un olvido. Un subagente no puede pedir aclaraciones, y el prompt del sistema compensa esta imposibilidad especificando de antemano el framework de pruebas a usar y el formato exacto de la respuesta.
Casos de uso concretos
El primer beneficio es el trabajo en paralelo. El agente principal puede asignar múltiples tareas simultáneamente a diferentes subagentes, cada uno trabajando por su cuenta antes de devolver su resultado.
Agente principal
├── Subagente "test-generator" → genera pruebas
├── Subagente "doc-writer" → genera documentación
└── Subagente "security-checker" → analiza vulnerabilidades
El segundo beneficio afecta a tareas altamente especializadas. Algunas requieren un prompt del sistema radicalmente diferente al del agente principal; en lugar de sobrecargar un único agente con instrucciones contradictorias, se delega. El optimizador de SQL siguiente es un buen ejemplo: su prompt solo habla de índices, planes de ejecución y consultas N+1, lo cual no tendría sentido en un agente generalista.
# ~/.vibe/agents/sql-optimizer.toml
display_name = "Optimizador de SQL"
description = "Analiza y optimiza consultas SQL."
agent_type = "subagent"
safety = "safe"
active_model = "mistral-medium-3.5" # modelo integrado en Vibe
instructions = """
Analiza las consultas SQL proporcionadas:
1. Identifica problemas de rendimiento (N+1, escaneo completo, índice faltante)
2. Propone consultas optimizadas
3. Sugiere índices a crear
Devuelve un informe estructurado con antes/después para cada consulta.
"""
enabled_tools = ["read_file", "grep"]
El tercer beneficio, menos obvio, es el aislamiento de seguridad. Un subagente con safety = "safe" no puede modificar archivos, incluso si el agente principal se ejecuta en modo destructive: los permisos no se heredan hacia abajo. Por tanto, puedes trabajar en un modo permisivo mientras confías análisis a subagentes restringidos que no tienen forma de actuar sobre el repositorio.
# Subagente que SOLO puede leer
agent_type = "subagent"
safety = "safe"
enabled_tools = ["read_file", "grep"]
[tools.read_file]
permission = "always"
[tools.grep]
permission = "always"
Vibe también proporciona un subagente integrado llamado explore, que utiliza automáticamente cuando necesita recorrer tu base de código para responder a una pregunta. Opera en modo de solo lectura y devuelve un resumen de lo encontrado: exactamente el patrón que replicarás con tus propios subagentes.
Diseño de un buen subagente
Todo depende de la autonomía del prompt del sistema: debe contener todas las instrucciones necesarias para que el subagente llegue al final sin hacer nunca una pregunta. Esto requiere anticipar los casos en que las cosas salen mal y escribir exactamente qué debe hacer el agente en esas situaciones, como en el siguiente ejemplo.
instructions = """
Analiza TODOS los archivos TypeScript del proyecto.
Si no se encuentra un archivo, pasa al siguiente.
Si no se puede identificar el framework de pruebas, usa Vitest por defecto.
Devuelve siempre un resultado, aunque sea parcial.
"""
Dos reflejos completan este trabajo. Proporciona al subagente estrictamente las herramientas que necesita: un subagente de análisis no necesita write_file. Especifica también el formato de salida esperado en el prompt del sistema. El agente principal debe poder explotar el resultado sin ambigüedad: será él, no tú, quien lea primero ese texto.
Reglas establecidas por Vibe
La documentación de Vibe especifica varias reglas que conviene conocer antes de diseñar tus subagentes:
- un subagente devuelve solo texto al agente principal y no puede hacer preguntas al usuario;
- solo puede usar las herramientas integradas que autoriza su archivo, nunca herramientas MCP, conectores ni plugins, y nunca con permisos más amplios que los del agente padre: sus bloques
[tools.<tool>]pueden restringirlo más, no ampliarlo; - su
descriptiones obligatoria: esto indica al agente cuándo debe usarlo; un archivo sin descripción se marca como problemático en lugar de cargarse; - se ejecuta en su
active_model, o en el modelo de sesión si no se establece ninguno; - el agente principal lo lanza mediante delegación, usando la herramienta
task; no se selecciona con--agent; - por defecto, pueden existir y ejecutarse simultáneamente hasta 32 subagentes (
max_subagents,max_concurrent_subagents), yenable_subagents = falseenconfig.tomlprohíbe toda delegación.
Sin un subagente personalizado, el agente puede seguir lanzando un subagente genérico equipado con sus propias instrucciones y herramientas.
Puntos clave
- Un subagente es un agente independiente que no puede interactuar con el usuario
- Configúralo con
agent_type = "subagent"en el archivo.toml - Los subagentes son ideales para trabajo en paralelo y tareas especializadas
- Ofrecen un aislamiento de seguridad natural
- Las
instructionsdeben ser totalmente autónomas: prohibido hacer preguntas - Especifica siempre un formato de salida claro en el prompt