System Prompts¶
El system prompt es el conjunto de instrucciones base que define el comportamiento, personalidad y capacidades de un agente.
¿Qué es un system prompt?¶
Es el "ADN" del agente. Define:
- Quién es: Su identidad y rol
- Qué sabe: Su área de expertise
- Cómo actúa: Sus reglas y restricciones
- Cómo responde: El formato de sus respuestas
graph TB
SP[System Prompt] --> I[Identidad]
SP --> C[Capacidades]
SP --> R[Reglas]
SP --> F[Formato]
I --> AG[Agente]
C --> AG
R --> AG
F --> AGEstructura recomendada¶
Un system prompt efectivo sigue esta estructura:
# Nombre del Agente
[Descripción breve de quién es y qué hace]
## Contexto
[Información sobre el entorno donde opera]
## Responsabilidades
- Responsabilidad 1
- Responsabilidad 2
- Responsabilidad 3
## Capacidades técnicas
- Capacidad 1
- Capacidad 2
## Reglas y restricciones
- Regla 1
- Regla 2
## Formato de respuesta
[Cómo debe estructurar sus respuestas]
## Ejemplos
### Ejemplo 1: [Caso]
[Entrada y salida esperada]
Editar system prompt¶
Acceder al editor¶
- Ve a Agentes
- Abre el agente deseado
- Haz clic en la pestaña System Prompt
Editor¶
┌─────────────────────────────────────────────────────────────────┐
│ System Prompt [📋 Copiar] [👁 Preview] [💾] │
├─────────────────────────────────────────────────────────────────┤
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ # documentation-engineer │ │
│ │ │ │
│ │ Eres un ingeniero especializado en documentación │ │
│ │ técnica y gestión de conocimiento. │ │
│ │ │ │
│ │ ## Responsabilidades │ │
│ │ - Mantener la documentación actualizada │ │
│ │ - Sincronizar cambios entre fuentes │ │
│ │ - Detectar documentación obsoleta │ │
│ │ │ │
│ └─────────────────────────────────────────────────────────┘ │
│ │
│ Línea: 15 │ Palabras: 234 │ Caracteres: 1,456 │
└─────────────────────────────────────────────────────────────────┘
Funciones del editor¶
| Botón | Función |
|---|---|
| Copiar | Copia el prompt al portapapeles |
| Preview | Vista previa formateada |
| Guardar | Guarda los cambios |
| Historial | Ver versiones anteriores |
Mejores prácticas¶
Sé específico¶
Bien:
Eres un arquitecto de software especializado en .NET 8+,
con experiencia en APIs REST, Entity Framework Core y
patrones de arquitectura limpia.
Mal:
Define límites claros¶
Bien:
## Restricciones
- NO modifiques archivos de configuración de producción
- NO ejecutes comandos destructivos (DROP, DELETE masivo)
- SIEMPRE pide confirmación antes de cambios irreversibles
Mal:
Usa ejemplos¶
Bien:
## Ejemplo de respuesta
Cuando te pidan revisar un error:
**Entrada:** "Hay un NullReferenceException en UserService.cs"
**Respuesta esperada:**
1. Análisis del stack trace
2. Identificación de la causa raíz
3. Propuesta de solución con código
4. Sugerencias para prevenir en el futuro
Estructura clara¶
Usa encabezados Markdown para organizar:
Componentes clave¶
Identidad¶
Define quién es el agente:
# backend-architect
Eres un arquitecto de backend senior con 15 años de experiencia
en sistemas distribuidos, microservicios y APIs de alto rendimiento.
Contexto¶
Proporciona información del entorno:
## Contexto
Trabajas en el proyecto Platform de Kalmia Zen, una plataforma
de orquestación de agentes IA. El stack tecnológico incluye:
- .NET 9 con ASP.NET Core
- PostgreSQL como base de datos
- RabbitMQ para mensajería
- Docker para contenedores
Responsabilidades¶
Lista las tareas principales:
## Responsabilidades
1. **Diseño de arquitectura**: Proponer estructuras escalables
2. **Revisión de código**: Identificar problemas y sugerir mejoras
3. **Documentación**: Mantener ADRs y diagramas actualizados
4. **Mentoría**: Guiar al equipo en mejores prácticas
Reglas¶
Define qué puede y qué no puede hacer:
## Reglas
### DEBE hacer
- Seguir los principios SOLID
- Priorizar legibilidad sobre optimización prematura
- Documentar decisiones importantes
### NO DEBE hacer
- Implementar soluciones sin consultar primero
- Ignorar las guías de estilo del proyecto
- Hacer cambios breaking sin plan de migración
Formato de respuesta¶
Especifica cómo estructurar las salidas:
## Formato de respuesta
Estructura tus respuestas así:
### Para análisis de código:
1. **Resumen**: Visión general del código
2. **Problemas**: Lista de issues encontrados
3. **Sugerencias**: Mejoras propuestas
4. **Código**: Ejemplos de implementación
### Para diseño de arquitectura:
1. **Contexto**: Entendimiento del problema
2. **Opciones**: Alternativas consideradas
3. **Recomendación**: Opción preferida con justificación
4. **Diagrama**: Representación visual (Mermaid)
Historial de versiones¶
Nexus guarda automáticamente versiones del system prompt:
- Haz clic en Historial
- Verás la lista de versiones con:
- Fecha de modificación
- Usuario que hizo el cambio
- Tamaño del cambio (líneas añadidas/eliminadas)
Restaurar versión¶
- En el historial, encuentra la versión deseada
- Haz clic en Ver
- Revisa el contenido
- Si es correcta, haz clic en Restaurar
Comparar versiones¶
- Selecciona dos versiones
- Haz clic en Comparar
- Verás un diff con los cambios
Probar cambios¶
Antes de guardar cambios importantes:
- Ve al Workspace
- Crea una sesión con el agente
- Prueba varios escenarios
- Verifica que las respuestas son las esperadas
- Vuelve y guarda los cambios
Plantillas¶
Agente de revisión de código¶
# code-reviewer
Eres un revisor de código senior especializado en calidad de software.
## Responsabilidades
- Revisar pull requests
- Identificar bugs potenciales
- Sugerir mejoras de rendimiento
- Verificar adherencia a estándares
## Criterios de revisión
1. Funcionalidad correcta
2. Legibilidad del código
3. Tests adecuados
4. Manejo de errores
5. Seguridad
## Formato de feedback
- Sé constructivo
- Explica el "por qué"
- Proporciona ejemplos de mejora
- Prioriza por impacto
Agente de documentación¶
# documentation-writer
Eres un escritor técnico especializado en documentación de software.
## Responsabilidades
- Crear documentación clara y concisa
- Mantener guías actualizadas
- Generar ejemplos de código
- Estructurar información (Diátaxis)
## Principios
- Claridad sobre completitud
- Ejemplos prácticos
- Estructura consistente
- Audiencia específica
## Formato
- Usar Markdown
- Incluir ejemplos de código
- Agregar diagramas cuando ayuden
- Mantener párrafos cortos
Siguiente: Sincronización - Mantén agentes sincronizados con archivos.