---
title: "Promemoria"
description: "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](/docs/it/work/sessions) 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](/docs/it/connect/triggers) associato a una sola sessione. Ecco le differenze:

| | Trigger | Promemoria |
| --- | --- | --- |
| Dove viene archiviato | `beeuni.yaml`, salvato nel branch predefinito | Nel database. Nesbeeuni modifica al manifest, nessun commit. |
| Cosa succede all’attivazione | Di solito avvia una nuova sessione | Invia un prompt alla sua sessione. Non avvia mai una sessione. |
| Durata | Finché qualcuno non lo rimuove dal manifest | Finché qualcuno non lo rimuove. Si sospende quando la sua sessione viene eliminata o non va a buon fine. |
| Chi può crearlo | Responsabili di progetto (`project.trigger.create`) | Chiunque possa inviare un prompt alla sessione. Un agente può crearne uno solo per la propria sessione. |
| Dove viene elencato | `beeuni triggers ls`, la pagina Triggers | `beeuni reminders ls`, per sessione |

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à.

<a id="turn-reminders-on"></a>

## Attivare i promemoria

I promemoria sono un [flag di funzionalità](/docs/it/feature-flags) per progetto, `reminders`, disattivato per impostazione predefinita. Attivalo in **Settings → Feature flags**, oppure:

```sh
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.

<a id="set-a-reminder"></a>

## Impostare un promemoria

All’interno di una sessione, la CLI usa la sessione corrente. Al di fuori di una sessione, passa `--session <id>`.

```sh
# 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.

<a id="schedule-rules"></a>

## 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`.

<a id="what-a-fire-does"></a>

## Cosa succede all’attivazione

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

```text
[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.

<a id="manage-reminders"></a>

## Gestire i promemoria

| Comando | Effetto |
| --- | --- |
| `beeuni reminders ls [--json]` | Elenca i promemoria della sessione: ID, stato, pianificazione, prossima attivazione e testo. |
| `beeuni reminders pause <id>` | Interrompe le attivazioni. Mantiene il promemoria. |
| `beeuni reminders resume <id>` | Attiva di nuovo il promemoria, ripianificandolo a partire da ora. Un promemoria una tantum già attivato rimane `done`. |
| `beeuni reminders rm <id>` | Elimina il promemoria. Alias: `stop`, `delete`. |

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

<a id="api-and-sdk"></a>

## API e SDK

Le route sono associate a una sessione:

| Route | Effetto |
| --- | --- |
| `GET /v1/projects/:projectId/sessions/:sessionId/reminders` | Elenca i promemoria. |
| `POST /v1/projects/:projectId/sessions/:sessionId/reminders` | Ne crea uno. Corpo: `prompt`, `name` facoltativo e `every`, `cron` + `timezone`, `at` oppure `in`. Restituisce `201`. |
| `PATCH /v1/projects/:projectId/sessions/:sessionId/reminders/:reminderId` | Il corpo `{ "enabled": false }` sospende, `{ "enabled": true }` riprende. |
| `DELETE /v1/projects/:projectId/sessions/:sessionId/reminders/:reminderId` | Elimina un promemoria. |

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`.

```ts
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);
```