cron

Cron

cron ツールを使用して、実行時に元のチャット/セッションに結果を報告するリマインダーまたは繰り返しタスクをスケジュールします。

報告すべき有用な情報がないときに静かにしておくべき定期的なバックグラウンドチェックには cron を使用しないでください。そのような場合は HEARTBEAT.md を更新してください。保護されたハートビートジョブがそれらのチェックを実行し、通知ゲートを通過した結果のみを配信します。

3 つのモード

1. リマインダー - メッセージがユーザーに直接送信されます
2. タスク - メッセージがタスクの説明であり、エージェントが実行して結果を送信します
3. 一回限り - 特定の時刻に 1 回実行され、その後自動的に削除されます

例

固定リマインダー:

cron(action="add", message="Time to take a break!", every_seconds=1200)

動的タスク (毎回エージェントが実行):

cron(action="add", message="Check HKUDS/nanobot GitHub stars and report", every_seconds=600)

一回限りのスケジュールタスク (現在時刻から ISO datetime を計算):

cron(action="add", message="Remind me about the meeting", at="<ISO datetime>")

タイムゾーン対応 cron:

cron(action="add", message="Morning standup", cron_expr="0 9 * * 1-5", tz="America/Vancouver")

一覧表示/削除:

cron(action="list")
cron(action="remove", job_id="abc123")

時間表現

ユーザーの発言	パラメータ
20 分ごと	every_seconds: 1200
1 時間ごと	every_seconds: 3600
毎日午前 8 時	cron_expr: "0 8 * * *"
平日午後 5 時	cron_expr: "0 17 * * 1-5"
毎日午前 9 時バンクーバー時間	cron_expr: "0 9 * * *", tz: "America/Vancouver"
特定の時刻	at: ISO datetime 文字列 (現在時刻から計算)

タイムゾーン

cron_expr とともに tz を使用して、特定の IANA タイムゾーンでスケジュールします。tz を指定しない場合は、サーバーのローカルタイムゾーンが使用されます。