Promemoria

Un promemoria invia un nuovo prompt a una sessione successiva, una volta o ripetutamente, finché non lo rimuovi.

Un promemoria invia un prompt a una sessione esistente, all’ora che imposti. Si attiva una volta oppure si ripete finché qualcuno non lo rimuove. Un agente usa un promemoria per ricontrollare il proprio lavoro: «tra 24 ore, verifica se il fornitore ha risposto», «ogni ora, verifica se il deploy è andato a buon fine».

Un promemoria è un trigger associato a una sola sessione. Ecco le differenze:

Usa un trigger per le attività di progetto che tutti dovrebbero vedere, come un riepilogo giornaliero. Usa un promemoria per un controllo successivo relativo a una singola attività.

Attivare i promemoria

I promemoria sono un flag di funzionalità per progetto, reminders, disattivato per impostazione predefinita. Attivalo in Settings → Feature flags, oppure:

beeuni projects features enable reminders

Quando il flag è disattivato, ogni route dei promemoria risponde 403 con code: "feature_disabled", la pagina Promemoria mostra come attivarlo e i promemoria esistenti non si attivano. Riattivando il flag, l’attivazione prevista durante il periodo in cui era disattivato avviene una sola volta, poi la pianificazione riprende.

Impostare un promemoria

All’interno di una sessione, la CLI usa la sessione corrente. Al di fuori di una sessione, passa --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

Il comando mostra l’ID del promemoria, ad esempio reminder.3f9a1c2e7b04, e l’ora della prossima attivazione.

Regole di pianificazione

• --in <duration> o --at <ISO-8601> impostano la prima attivazione. Se usato da solo, il promemoria si attiva una sola volta.
• --every <duration> imposta la ripetizione. Il periodo minimo è 5m. Ogni periodo inizia quando viene presa in carico l’attivazione precedente.
• --cron "<expr>" ripete in base a un’espressione cron a 6 campi (prima i secondi). --timezone imposta il fuso orario; il valore predefinito è UTC. Un promemoria cron può attivarsi al massimo una volta ogni 5 minuti. Non accetta --in né --at.
• Le durate sono espresse in 30m, 24h, 2d o in secondi interi.
• --in, --at e --every accettano al massimo 366 giorni.
• Una sessione può contenere al massimo 20 promemoria attivi. Un progetto può contenerne al massimo 200. Il superamento di uno dei due limiti restituisce 409.

Cosa succede all’attivazione

A ogni attivazione, il testo del promemoria viene inserito nella sessione come prompt preceduto da un’intestazione:

[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 sessione in pausa si riattiva. L’agente dispone dell’intera conversazione e dell’area di lavoro della sessione.
• Un’attivazione non avvia mai una nuova sessione. Se la sessione viene eliminata o non va a buon fine, il promemoria viene sospeso e il motivo viene registrato in last_error.
• Un’attivazione mantiene le connessioni personali della sessione, ad esempio l’account Gmail personale di un membro. Se imposti un promemoria in una sessione per conto della quale non stai agendo, le connessioni vengono rimosse, come quando invii un prompt a quella sessione.
• La pausa dei trigger a livello di progetto (beeuni triggers pause) interrompe anche i promemoria.

Ogni attivazione comporta un turno del modello. Rimuovi un promemoria ricorrente non appena la condizione è soddisfatta.

Gestire i promemoria

Un promemoria è active (pianificato), paused (disattivato) oppure done (un promemoria una tantum che si è attivato).

API e SDK

Le route sono associate a una sessione:

Una pianificazione non valida restituisce 400 con il motivo. Una sessione eliminata restituisce 409. Una credenziale dell’agente che indica un’altra sessione restituisce 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);