リマインダー

リマインダーを設定すると、1つのセッション後に一度、または繰り返し再通知され、削除するまで続きます。

リマインダーは、設定した時刻に既存のセッションへプロンプトを送信します。1回だけ実行することも、誰かが削除するまで繰り返すこともできます。エージェントは、自分の作業を再確認するためにリマインダーを使用します。「24時間後に、ベンダーから返信があったか確認する」「1時間ごとに、デプロイが成功しているか確認する」といった用途です。

リマインダーは、1つのセッションを対象とするトリガーです。違いは次のとおりです。

プロジェクト全体で確認すべき作業（毎日のダイジェストなど）にはトリガーを使用します。1つのタスクに属するフォローアップにはリマインダーを使用します。

リマインダーを有効にする

リマインダーはプロジェクト単位の機能フラグで、reminders、デフォルトでは無効です。Settings → Feature flagsで有効にするか、次のコマンドを実行します。

beeuni projects features enable reminders

フラグが無効な間は、すべてのリマインダールートが403をcode: "feature_disabled"で返し、Remindersページには有効化方法が表示され、既存のリマインダーは実行されません。フラグを再び有効にすると、無効な間に missed になったスロットが1回実行され、その後スケジュールが継続します。

リマインダーを設定する

セッション内では、CLIは現在のセッションを対象にします。セッション外では、--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

コマンドはリマインダーID（例：reminder.3f9a1c2e7b04）と、次回の実行時刻を表示します。

スケジュールのルール

• --in <duration>または--at <ISO-8601>で初回実行を設定します。単独で指定した場合、リマインダーは1回だけ実行されます。
• --every <duration>で繰り返します。最短の間隔は5mです。各間隔は、前回の実行が処理された時点から始まります。
• --cron "<expr>"では6フィールドのcron式（秒が先頭）で繰り返します。--timezoneでタイムゾーンを設定します。デフォルトはUTCです。cronリマインダーの実行間隔は5分以上でなければなりません。--inや--atは使用できません。
• 期間には30m、24h、2d、または整数秒を指定します。
• --in、--at、--everyには最大366日まで指定できます。
• 1つのセッションで有効にできるリマインダーは最大20件、1つのプロジェクトでは最大200件です。いずれかの上限を超えると409を返します。

実行時の動作

実行されるたびに、リマインダーのテキストが次のヘッダーで始まるプロンプトとしてセッションにキュー登録されます。

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

• 待機中のセッションが再開します。エージェントはセッションの完全な会話とワークスペースを利用できます。
• 実行によって新しいセッションが開始されることはありません。セッションが削除または失敗した場合、実行はリマインダーを一時停止し、理由をlast_errorに記録します。
• 実行時には、メンバー自身のGmailなど、セッション固有の個人用接続が保持されます。自分が代理していないセッションにリマインダーを設定すると、そのセッションにプロンプトを送信した場合と同様に、これらの接続がクリアされます。
• プロジェクト全体のトリガー一時停止（beeuni triggers pause）によって、リマインダーも停止します。

実行されるたびにモデルターンが1回消費されます。条件を満たしたら、繰り返しリマインダーをすぐに削除してください。

リマインダーを管理する

リマインダーの状態は、active（スケジュール済み）、paused（無効）、またはdone（実行済みの1回限りのリマインダー）です。

APIとSDK

ルートはセッション単位です。

無効なスケジュールの場合は、理由とともに400を返します。削除されたセッションの場合は409を返します。別のセッションを指定するエージェント認証情報の場合は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);