Subagentes
Agentes expertos especializados que el agente principal puede invocar cuando los necesite
Un subagente es un "experto" especializado al que el agente principal (Worker) puede recurrir en cualquier momento durante la ejecución de una tarea. Cada subagente tiene su propia especialidad, su prompt dedicado e incluso puede ejecutarse en un modelo diferente. En el chat, basta con escribir @SubagentName y se suma para ayudar, igual que cuando etiquetas a un colega en un chat grupal.
Subagentes integrados
Verdent incluye 6 subagentes listos para usar, que cubren las necesidades más comunes en el desarrollo de software:
| Nombre | Modelo predeterminado | En qué destaca |
|---|---|---|
| General | Sigue al agente principal | Un agente de investigación de propósito general para problemas complejos, búsqueda de código y tareas de varios pasos; puede ayudar con casi cualquier cosa |
| Fast Context | Gemini 3 Flash | Localiza código rápidamente y reúne evidencia contextual; se especializa en la indexación de bases de código y es extremadamente rápido |
| Verifier | Sonnet 4.6 | Revisión de código rápida: después de hacer cambios, etiquétalo para detectar problemas evidentes |
| Verdent Helper | Haiku 4.5 | Un asistente de uso de Verdent; pregúntale cualquier cosa sobre cómo funciona Verdent |
| Multi-Model Planner | Gemini 3.1 Pro; Opus 4.6; GPT-5.4 | Genera planes usando varios modelos (Claude, GPT, Gemini) y combina sus resultados |
| Reviewer | Gemini 3.1 Pro; Opus 4.6; GPT-5.4 | Revisión de código completa: errores de lógica, casos límite y riesgos ocultos |
Dos subagentes son especiales: Multi-Model Planner y Reviewer ejecutan de 2 a 3 modelos en paralelo. Cada modelo piensa de forma independiente, produce su propio resultado y luego los resultados se combinan. Todos los demás subagentes son de un solo modelo.
Cómo usar los subagentes
En cualquier conversación, escribe @ para abrir el menú de selección de subagentes (admite búsqueda difusa). Selecciona el subagente que quieras y tomará el control del contexto actual.
Ejemplos:
- Después de escribir lógica de autenticación compleja:
@Reviewer please review this→ Reviewer la analiza desde la perspectiva de la seguridad, la lógica y los casos límite. - Para una decisión de arquitectura difícil:
@Multi-Model Planner→ varios modelos proponen soluciones y eliges la mejor. - Después de programar, ejecuta rápidamente
@Verifier→ más rápido que ejecutar suites de pruebas completas para una validación básica.
Subagentes personalizados
Los subagentes integrados cubren la mayoría de las necesidades, pero a veces conviene tener un especialista adaptado a tu proyecto. Puedes crear el tuyo propio.
Dónde almacenarlos
Los subagentes personalizados se guardan como archivos Markdown en:
~/.verdent/subagents/Se admiten hasta 5 niveles de subdirectorios para organizarlos.
Formato de archivo
Cada subagente es un archivo Markdown con frontmatter en YAML:
---
name: SQL-Expert
description: Specializes in SQL optimization and database design, good at analyzing slow queries and indexing strategies
color: blue
model: claude-sonnet-4-6
---
You are a senior database expert focused on PostgreSQL performance optimization.
When users provide SQL queries, you should:
1. Analyze the query execution plan
2. Identify performance bottlenecks (full table scans, missing indexes, etc.)
3. Provide concrete optimization suggestions and rewritten SQL
...Detalles clave
- Nombre: solo puede incluir letras, números y guiones (por ejemplo,
SQL-Expert,MyAgent123). Sin espacios ni caracteres no ASCII. - Color: uno de
dark-green,light-green,red-orange,amber,cyan,blue,pink,purple,verdent, para un reconocimiento visual más fácil. - Recarga en caliente: al guardar el archivo
.mdsurte efecto de inmediato; no es necesario reiniciar Verdent.
Gestión de subagentes en la configuración
Toda la gestión de subagentes se realiza en Settings → Subagents.
| Acción | Descripción |
|---|---|
| Ver lista | Todos los subagentes se muestran como tarjetas. Los integrados están etiquetados como "Built-in"; los basados en plugins muestran los nombres de los plugins. |
| Habilitar / Deshabilitar | Activa o desactiva cada subagente sin afectar a los demás. |
| Crear nuevo | Selecciona Add Subagent y completa Identifier (nombre único), Model, Description y Prompt. |
| Editar | Pasa el cursor sobre una tarjeta para editarla. Los subagentes integrados solo permiten cambiar Model y Description. |
| Duplicar | Copia cualquier subagente personalizado (los duplicados están deshabilitados de forma predeterminada hasta que los habilites). |
| Eliminar | Los subagentes personalizados se pueden eliminar (con confirmación). Los integrados no se pueden eliminar. |
Diferencias en la selección de modelo
- Multi-Model Planner y Reviewer admiten la selección de varios modelos (de 2 a 3 a la vez).
- Los demás subagentes usan la selección de un solo modelo.
- General tiene una opción especial: puede seguir automáticamente el modelo del agente principal, lo que evita mantener una configuración separada.
Casos de uso
Revisión de código
Después de implementar lógica compleja, etiqueta @Reviewer. Comprueba la corrección, los casos límite y los posibles errores, lo que te ahorra una inspección manual línea por línea.
Diseño de arquitectura desde múltiples perspectivas
Para decisiones importantes (por ejemplo, adoptar microservicios o elegir una base de datos), usa @Multi-Model Planner para obtener propuestas independientes de varios modelos de primer nivel y reducir el riesgo de la decisión.
Validación rápida
Después de cambiar el código, @Verifier comprueba rápidamente la sintaxis, los tipos y los problemas básicos: más rápido que las suites de pruebas completas y más fiable que no hacer ninguna comprobación.
Expertos de dominio personalizados
Crea subagentes adaptados a tu proyecto:
- Un experto en optimización de SQL que conozca tu esquema y tus patrones de consulta
- Un guardián de los estándares de código frontend que aplique tus reglas de ESLint y de tu sistema de diseño
- Un asistente de documentación que adapte el contenido técnico a una redacción clara y fácil de leer
Notas
- Los subagentes personalizados deben configurarse con un modelo válido para poder habilitarse. Si usas BYOK y la clave caduca o el modelo se retira, el subagente se deshabilitará automáticamente.
- Los modelos de los subagentes integrados se pueden cambiar, pero los valores predeterminados están ajustados; modificarlos puede reducir el rendimiento.
- La descripción importa: se inyecta en el contexto del agente principal e influye en cuándo se invocan los subagentes. Mejores descripciones conducen a un enrutamiento más inteligente.
- Los subagentes no pueden invocarse entre sí. Solo pueden ser invocados por el agente principal (Worker); no se permite un anidamiento más profundo.