Toolsaction
Set Beat
Schedule a reminder or a background "beat" with a 5-field cron expression.
tool name: set_beat
Saves a reminder (a scheduled nudge to the user) or a scheduled_beat (an automated background agent run) with a standard 5-field cron expression.
Default behavior is a one-time beat — every field is pinned; wildcards are used only when you explicitly ask for a recurring pattern ("every day", "every Monday").
Not available to the heartbeat sub-agent itself, so a beat cannot recursively schedule more beats.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| beat | string | yes | What the user wants to be reminded about, or the beat to schedule. |
| type | stringreminder, scheduled_beat | — | Defaults to "reminder". "scheduled_beat" runs the agent in the background. |
| cron_expression | string | yes | 5-field cron: "minute hour day-of-month month day-of-week". |
| channel | stringtelegram, whatsapp | — | Channel to use instead of the current chat, if this beat should notify a different chat. Must be provided together with target. |
| target | string | — | Recipient address (Telegram chat id or WhatsApp JID) to use instead of the current chat. Must be provided together with channel. |