Crear tarea¶
Guía completa para crear tareas en Nexus.
Acceder al formulario¶
- Ve a Tareas en el menú lateral
- Haz clic en + Crear
- Se abrirá el formulario de creación
Formulario de creación¶
┌─────────────────────────────────────────────────────────────────┐
│ Crear Tarea │
├─────────────────────────────────────────────────────────────────┤
│ │
│ Nombre * │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ │ │
│ └─────────────────────────────────────────────────────────┘ │
│ │
│ Proyecto * │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ Seleccionar proyecto... ▼ │ │
│ └─────────────────────────────────────────────────────────┘ │
│ │
│ Agente * │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ Seleccionar agente... ▼ │ │
│ └─────────────────────────────────────────────────────────┘ │
│ │
│ Tipo * │
│ ○ Programada (CRON) │
│ ○ Manual │
│ │
│ Descripción / Prompt │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ Instrucciones para el agente... │ │
│ │ │ │
│ │ │ │
│ └─────────────────────────────────────────────────────────┘ │
│ │
│ [Cancelar] [Crear] │
│ │
└─────────────────────────────────────────────────────────────────┘
Campos del formulario¶
Nombre (requerido)¶
Identificador descriptivo de la tarea.
| Recomendación | Ejemplo |
|---|---|
| Acción + Objeto | "Backup base de datos" |
| Verbo en infinitivo | "Sincronizar documentación" |
| Específico | "Revisar errores Sentry" |
Proyecto (requerido)¶
El proyecto al que pertenece la tarea.
- Filtra los agentes disponibles
- Asocia la tarea a un contexto
- Permite filtrar en listas
Agente (requerido)¶
El agente que ejecutará la tarea.
Elegir el agente correcto
Selecciona el agente más especializado para la tarea:
- Documentación →
documentation-engineer - Base de datos →
database-optimizer - Despliegues →
devops-troubleshooter
Tipo (requerido)¶
| Tipo | Cuándo usar |
|---|---|
| Programada | Tareas repetitivas con horario fijo |
| Manual | Tareas que requieren supervisión |
Descripción / Prompt¶
Instrucciones detalladas para el agente. Este texto se envía al agente cuando se ejecuta la tarea.
Estructura recomendada¶
## Objetivo
[Qué debe lograr la tarea]
## Contexto
[Información relevante]
## Pasos
1. Primer paso
2. Segundo paso
3. Tercer paso
## Resultado esperado
[Qué se espera al terminar]
Ejemplo completo¶
## Objetivo
Revisar los errores de Sentry de las últimas 24 horas y crear
un resumen con los más críticos.
## Contexto
- Proyecto: Platform API
- Ambiente: Producción
- Prioridad: Errores con más de 10 ocurrencias
## Pasos
1. Conectar a la API de Sentry
2. Obtener errores de las últimas 24h
3. Filtrar por ocurrencias > 10
4. Agrupar por tipo de error
5. Generar resumen en Markdown
## Resultado esperado
Un informe con:
- Total de errores únicos
- Top 5 errores más frecuentes
- Recomendaciones de acción
Configuración adicional para tareas programadas¶
Si seleccionas tipo Programada, aparecen campos adicionales:
Expresión CRON¶
┌─────────────────────────────────────────────────────────────────┐
│ Horario (CRON) * │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ 0 9 * * * │ │
│ └─────────────────────────────────────────────────────────┘ │
│ │
│ 📅 Próximas ejecuciones: │
│ • Mañana a las 09:00 │
│ • Pasado mañana a las 09:00 │
│ • En 3 días a las 09:00 │
│ │
│ [🔧 Usar constructor CRON] │
└─────────────────────────────────────────────────────────────────┘
Usa el Constructor CRON si no conoces la sintaxis.
Estado inicial¶
Si está marcado, la tarea comienza a ejecutarse según el horario. Si no, se crea en estado Pausada.
Paso a paso: Tarea programada¶
1. Definir el propósito¶
Ejemplo: Quiero que cada mañana se revisen los errores de Sentry.
2. Completar el formulario¶
| Campo | Valor |
|---|---|
| Nombre | Revisión diaria de errores |
| Proyecto | Platform |
| Agente | sentry-integration |
| Tipo | Programada |
| CRON | 0 9 * * 1-5 |
| Activar | ✓ |
3. Escribir el prompt¶
Revisa los errores de Sentry de las últimas 24 horas para el
proyecto Platform API en producción.
Genera un informe con:
1. Total de errores nuevos
2. Errores críticos (más de 50 ocurrencias)
3. Errores recurrentes (aparecen más de 3 días seguidos)
4. Recomendaciones de priorización
4. Crear y verificar¶
- Haz clic en Crear
- Verifica que aparece en la lista
- Comprueba la próxima ejecución
Paso a paso: Tarea manual¶
1. Definir el propósito¶
Ejemplo: Quiero poder generar reportes de métricas cuando lo necesite.
2. Completar el formulario¶
| Campo | Valor |
|---|---|
| Nombre | Generar reporte de métricas |
| Proyecto | Analytics |
| Agente | report-generator |
| Tipo | Manual |
3. Escribir el prompt¶
Genera un reporte de métricas del proyecto Analytics.
Incluye:
1. Métricas de uso de los últimos 30 días
2. Comparativa con el mes anterior
3. Tendencias identificadas
4. Gráficos de evolución
Formato: Markdown con tablas
4. Crear¶
- Haz clic en Crear
- La tarea está lista para ejecutarse manualmente
Validaciones¶
El formulario valida:
| Campo | Validación |
|---|---|
| Nombre | Requerido, único por proyecto |
| Proyecto | Debe existir |
| Agente | Debe estar activo |
| CRON | Sintaxis válida |
| Descripción | Recomendado (no requerido) |
Errores comunes¶
"El nombre ya existe"¶
El nombre debe ser único dentro del proyecto. Elige otro nombre o añade un sufijo.
"Agente no disponible"¶
El agente seleccionado puede estar:
- Inactivo
- No asociado al proyecto
- Eliminado
"CRON inválido"¶
La expresión CRON tiene errores de sintaxis. Usa el Constructor CRON.
Después de crear¶
Una vez creada la tarea:
- Programada: Espera a la próxima ejecución o ejecuta manualmente
- Manual: Ejecuta cuando lo necesites
- Monitorea los resultados en Ejecuciones
- Ajusta el prompt si los resultados no son los esperados
Siguiente: Constructor CRON - Aprende a definir horarios fácilmente.