Recordatorios

Un recordatorio vuelve a activar una sesión más tarde, una vez o de forma periódica, hasta que lo elimines.

Un recordatorio envía una indicación a una sesión existente en el momento que elijas. Se activa una vez o se repite hasta que alguien lo elimine. Un agente usa un recordatorio para retomar su propio trabajo: «dentro de 24 horas, comprueba si respondió el proveedor», «cada hora, comprueba si la implementación está en verde».

Un recordatorio es un activador limitado a una sesión. Estas son las diferencias:

Usa un activador para el trabajo del proyecto que todos deban ver, como un resumen diario. Usa un recordatorio para el seguimiento de una tarea específica.

Activar los recordatorios

Los recordatorios son una marca de función por proyecto, reminders, desactivada de forma predeterminada. Actívala en Settings → Feature flags o ejecuta:

beeuni projects features enable reminders

Mientras la marca esté desactivada, todas las rutas de recordatorios responden 403 con code: "feature_disabled", la página Reminders muestra cómo activarla y los recordatorios existentes no se ejecutan. Si vuelves a activarla, se ejecuta una vez el intervalo que se perdió mientras estaba desactivada y, después, se reanuda la programación.

Crear un recordatorio

Dentro de una sesión, la CLI usa la sesión actual. Fuera de una, pasa --session <id>.

# Fire once, 24 hours from now.
beeuni remind "Check whether the vendor replied to the contract email." --in 24h

# First fire in 24 hours, then every hour until removed.
beeuni remind "Did the vendor reply? If yes, summarize it and remove this reminder." --in 24h --every 1h

# Fire at an exact instant.
beeuni remind "Post the launch checklist to #launch." --at 2026-10-01T09:00:00Z

# Repeat on a cron expression in a time zone.
beeuni reminders add "Post the standup summary." --cron "0 0 9 * * 1-5" --timezone Europe/Berlin

El comando muestra el ID del recordatorio, por ejemplo reminder.3f9a1c2e7b04, y la hora de la próxima activación.

Reglas de programación

• --in <duration> o --at <ISO-8601> establece la primera activación. Si se usa sin otro parámetro, el recordatorio se activa una vez.
• --every <duration> establece la repetición. El periodo mínimo es 5m. Cada periodo empieza cuando se reclama la activación anterior.
• --cron "<expr>" establece la repetición mediante una expresión cron de 6 campos (primero los segundos). --timezone establece la zona horaria; el valor predeterminado es UTC. Un recordatorio cron debe activarse como máximo una vez cada 5 minutos. No acepta --in ni --at.
• Las duraciones se expresan como 30m, 24h, 2d o segundos enteros.
• --in, --at y --every aceptan un máximo de 366 días.
• Una sesión puede tener hasta 20 recordatorios activos. Un proyecto puede tener hasta 200. Si se supera cualquiera de estos límites, se devuelve 409.

Qué ocurre cuando se activa un recordatorio

Cada activación pone el texto del recordatorio en la cola de la sesión como una indicación que empieza con este encabezado:

[REMINDER reminder.3f9a1c2e7b04 — recurring scheduled check-in on this session, not a new user message. When it is no longer needed, run `beeuni reminders rm reminder.3f9a1c2e7b04`.]

Did the vendor reply? If yes, summarize it and remove this reminder.

• Una sesión en pausa se reactiva. El agente tiene acceso a toda la conversación y al espacio de trabajo de la sesión.
• Una activación nunca inicia una sesión nueva. Si se elimina la sesión o esta falla, se pausa el recordatorio y se registra el motivo en last_error.
• Una activación conserva las conexiones personales de la sesión, como la cuenta de Gmail propia de un miembro. Si creas un recordatorio para una sesión en nombre de otra persona, esas conexiones se borran, igual que cuando envías una indicación a esa sesión.
• La pausa de activadores para todo el proyecto (beeuni triggers pause) también detiene los recordatorios.

Cada activación genera un turno del modelo. Elimina los recordatorios recurrentes en cuanto se cumpla su condición.

Administrar recordatorios

Un recordatorio puede estar active (programado), paused (desactivado) o done (un recordatorio de una sola vez que ya se activó).

API y SDK

Las rutas están asociadas a una sesión:

Una programación no válida devuelve 400 con el motivo. Si la sesión se eliminó, devuelve 409. Si una credencial de agente especifica otra sesión, devuelve 403.

const reminders = beeuni.session(projectId, sessionId).reminders;
const reminder = await reminders.create({ prompt: 'Did the vendor reply?', in: '24h', every: '1h' });
await reminders.update(reminder.id, { enabled: false });
await reminders.remove(reminder.id);