Tareas programadas

4 min de lectura

Las tareas programadas permiten que un agente ejecute trabajo en una fecha concreta o de forma recurrente. Úsalas para revisiones, recordatorios, monitorización e informes que no requieran iniciarse manualmente.

Elegir el tipo de tarea

Tipo	Uso
Mensaje	Envía una instrucción al agente para que la interprete y actúe. Puede utilizar un modelo distinto al habitual.
Script	Ejecuta un comando sin invocar un modelo. Solo puede crearla el propio agente desde su entorno; también puede usar kj-ask puntualmente para razonar durante la ejecución.

Una tarea puede ejecutarse una única vez o repetirse según un calendario. Las tareas de una sola ejecución conservan su historial al terminar; si amplías su fecha o número de ejecuciones, pueden volver a activarse.

Los scripts los crea el agente

Desde el panel puedes consultar, ejecutar, pausar, editar o archivar una tarea de script existente, pero su creación corresponde al agente. Esto evita programar comandos sin que el agente haya definido el entorno y los accesos que necesita.

Un script puro ejecuta su comando sin despertar un modelo de razonamiento, por lo que no añade consumo de modelo. Solo las llamadas a kj-ask de un script híbrido consumen modelo.

Script con razonamiento

Una tarea híbrida no es un tercer selector en el panel: es una tarea de tipo Script que llama a kj-ask solo cuando necesita el criterio del agente. El script se encarga de las operaciones mecánicas —consultar una API, transformar datos o actualizar un sistema— y el agente interviene únicamente para interpretar o decidir.

incidencias=$(consultar_incidencias_abiertas)

if [ -n "$incidencias" ]; then
  prioritarias=$(kj-ask "Prioriza estas incidencias: $incidencias. Devuelve solo los IDs urgentes.")
  marcar_como_urgentes "$prioritarias"
fi

kj-ask plantea la pregunta al propio agente dentro del hilo dedicado de esa tarea. La respuesta se devuelve por la salida estándar para que el script pueda utilizarla. El agente conserva su contexto de trabajo habitual, incluidas las memorias y los accesos que tenga asignados.

Usa el modelo solo donde aporta valor

Elige esta variante cuando la mayor parte del trabajo sea repetible y solo haya uno o varios puntos de decisión. Así evitas ejecutar un turno completo de agente en cada recurrencia y consumes modelo únicamente en las llamadas a kj-ask.

Monitores temporales

Un monitor es una tarea programada interna que el propio agente crea para no perder de vista algo mientras trabaja. No es un tercer tipo de ejecución: puede usar una instrucción o un script, pero queda identificado como trabajo de seguimiento del agente.

Comprobar más tarde

El agente puede volver a revisar una condición después de un plazo: por ejemplo, si un despliegue ha terminado o si llegó una respuesta esperada.

Sondear un estado

Puede repetir una comprobación durante un tiempo limitado y avisar solo cuando encuentre un cambio o un problema.

Retirarse solo

Los monitores llevan una fecha de caducidad obligatoria. Así no quedan comprobaciones activas cuando el asunto ya ha terminado.

Por defecto, un monitor dura como máximo un día si el agente no indica otro plazo; nunca puede prolongarse más de siete días. Al caducar deja de ejecutarse y se limpia automáticamente después de conservar un breve margen para revisar su resultado.

Los monitores no aparecen en la lista ordinaria de tareas para no ocultar las automatizaciones que gestiona el equipo. Puedes incluir las tareas internas al revisar el agente si necesitas comprobar qué está siguiendo o detener un monitor concreto.

Limitar una recurrencia

Define una fecha de finalización, un número máximo de ejecuciones o ambos. Cuando se cumple cualquiera de los límites, la tarea deja de programarse.

La zona horaria puede configurarse por tarea. Si no la indicas, hereda la del agente y, en última instancia, la de la organización.

Frecuencia mínima

La frecuencia mínima depende del plan contratado. Consulta Planes y límites antes de diseñar tareas de alta frecuencia.

Notificar el resultado

Una tarea puede publicar su resultado en una conversación concreta cuando termina. En tareas de script también puedes decidir si avisa siempre, solo cuando cambia la salida, cuando se cumple un patrón o nunca. Los errores se notifican salvo que hayas elegido no enviar avisos.

Compartir y supervisar

Una tarea es privada para quien la crea hasta que se comparte con otros miembros. Administradores y propietarios pueden consultar todas las tareas de la organización.

Desde la lista puedes lanzarla manualmente, pausarla, editarla, eliminarla y consultar el historial de ejecuciones. El historial indica si finalizó correctamente, falló, agotó el tiempo o fue omitida.

Permisos

Las tareas pueden ser privadas para quien las creó o compartirse con otros miembros. El permiso de consulta general permite ver las propias y las compartidas; la supervisión completa de la organización requiere un permiso adicional.

Acción	Permiso
Consultar tareas propias, compartidas e internas	cronjob.view
Consultar todas las tareas de la organización	cronjob.view.all
Crear una tarea de mensaje	cronjob.create
Editar o pausar una tarea	cronjob.edit
Ejecutar una tarea manualmente	cronjob.execute
Archivar o eliminar una tarea	cronjob.delete

Automatiza después de validar

Prueba una tarea manualmente o con una ejecución única antes de convertirla en recurrente. Así validas la instrucción, el canal de aviso y los permisos del agente.

Secretos en scripts

Una tarea de script puede recibir credenciales como variables de entorno durante su ejecución. No incluyas secretos directamente en el comando ni en la descripción de la tarea.