Crear agente¶
Esta guía te muestra cómo crear un nuevo agente personalizado en Nexus.
Requisitos previos¶
Antes de crear un agente, define:
- Propósito: ¿Qué problema resolverá?
- Especialización: ¿En qué área será experto?
- Skills necesarias: ¿Qué capacidades necesita?
Acceder al formulario¶
- Ve a Agentes en el menú lateral
- Haz clic en + Crear
- Se abrirá el formulario de creación
Formulario de creación¶
Información básica¶
┌─────────────────────────────────────────────────────────────────┐
│ Crear Agente │
├─────────────────────────────────────────────────────────────────┤
│ │
│ Nombre * │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ Mi Agente Personalizado │ │
│ └─────────────────────────────────────────────────────────┘ │
│ │
│ Slug * │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ mi-agente-personalizado │ │
│ └─────────────────────────────────────────────────────────┘ │
│ ℹ️ Identificador único, sin espacios, en minúsculas │
│ │
│ Descripción │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ Describe brevemente qué hace este agente... │ │
│ │ │ │
│ └─────────────────────────────────────────────────────────┘ │
│ │
│ Estado │
│ [✓] Activo │
│ │
└─────────────────────────────────────────────────────────────────┘
| Campo | Descripción | Requerido |
|---|---|---|
| Nombre | Nombre descriptivo del agente | Sí |
| Slug | Identificador único (URL-friendly) | Sí |
| Descripción | Explicación de qué hace el agente | No |
| Estado | Activo/Inactivo | Sí |
Reglas para el slug¶
- Solo letras minúsculas, números y guiones
- Sin espacios ni caracteres especiales
- Debe ser único en el sistema
- Ejemplos válidos:
mi-agente,agente-docs-v2,qa-tester
System Prompt¶
El system prompt define el comportamiento del agente:
┌─────────────────────────────────────────────────────────────────┐
│ System Prompt │
├─────────────────────────────────────────────────────────────────┤
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ Eres un agente especializado en... │ │
│ │ │ │
│ │ ## Responsabilidades │ │
│ │ - Tarea 1 │ │
│ │ - Tarea 2 │ │
│ │ │ │
│ │ ## Reglas │ │
│ │ - Siempre responde en español │ │
│ │ - Sé conciso y preciso │ │
│ │ │ │
│ └─────────────────────────────────────────────────────────┘ │
│ │
│ [Markdown soportado] │
└─────────────────────────────────────────────────────────────────┘
Estructura recomendada del prompt¶
# Nombre del Agente
Eres un agente especializado en [área de especialización].
## Contexto
[Descripción del contexto en el que opera]
## Responsabilidades
- Responsabilidad 1
- Responsabilidad 2
- Responsabilidad 3
## Capacidades
- Capacidad técnica 1
- Capacidad técnica 2
## Reglas y restricciones
- Regla 1
- Regla 2
## Formato de respuesta
[Cómo debe estructurar sus respuestas]
Asignar Skills¶
Después de crear el agente, asigna skills:
- En la página de detalles del agente
- Haz clic en la pestaña Skills
- Usa + Añadir Skill
- Selecciona las skills relevantes
Consejo
Asigna solo las skills necesarias. Un agente con muchas skills puede ser menos efectivo.
Paso a paso completo¶
1. Definir el propósito¶
Ejemplo: Crear un agente para revisar pull requests.
2. Completar información básica¶
| Campo | Valor de ejemplo |
|---|---|
| Nombre | PR Reviewer |
| Slug | pr-reviewer |
| Descripción | Revisa pull requests y sugiere mejoras |
| Estado | Activo |
3. Escribir el system prompt¶
# PR Reviewer
Eres un agente especializado en revisión de código y pull requests.
## Responsabilidades
- Revisar cambios de código en PRs
- Identificar problemas de calidad
- Sugerir mejoras y best practices
- Verificar que se sigan los estándares del proyecto
## Reglas
- Sé constructivo en los comentarios
- Prioriza seguridad y rendimiento
- Sugiere, no ordenes
- Explica el "por qué" de cada sugerencia
## Formato de respuesta
Estructura tu revisión en secciones:
1. Resumen general
2. Problemas críticos (si los hay)
3. Sugerencias de mejora
4. Puntos positivos
4. Guardar¶
- Revisa toda la información
- Haz clic en Crear
- El agente aparecerá en la lista
5. Asignar skills¶
- Abre el agente recién creado
- Ve a la pestaña Skills
- Añade skills como:
code-reviewgit-operationsbest-practices
6. Probar¶
- Ve al Workspace
- Crea una nueva sesión con tu agente
- Envía un mensaje de prueba
- Verifica que responde según lo esperado
Errores comunes¶
Slug duplicado
Si recibes error de slug duplicado, elige un nombre diferente.
System prompt vacío
Aunque no es obligatorio, un agente sin system prompt usará comportamiento genérico.
Demasiadas skills
Evita asignar más de 5-7 skills por agente para mantener el foco.
Plantillas de agentes¶
Para casos comunes, puedes usar plantillas:
| Plantilla | Descripción |
|---|---|
| Code Reviewer | Revisión de código |
| Documentation Writer | Generación de documentación |
| Bug Investigator | Investigación de errores |
| API Designer | Diseño de APIs |
Acceder a plantillas
Las plantillas están disponibles en el menú del formulario de creación si tu organización las ha configurado.
Siguiente: Editar agente - Modifica agentes existentes.