Skip to content

Heartbeat

Sidebar → Heartbeats → New

Heartbeat lets an agent wake itself up on a fixed interval and run a prompt without any user message — useful for monitoring, daily summaries, scheduled outreach, or any "check in periodically and do X" workflow.

When to Use Heartbeat vs Scheduler

NeedUse
Run a fixed prompt every N seconds/minutesHeartbeat
Run on cron (e.g. weekdays at 9am)Scheduler tool
One-off reminderScheduler tool

Heartbeat is a higher-level loop attached to an agent + target; the Scheduler tool is a lower-level cron primitive the agent can call itself.

Configuration

FieldDescription
NameDisplay name
AgentWhich agent should run on each tick
TargetA specific channel user, web session, or working directory
IntervalTick period (seconds/minutes/hours)
PromptPrompt template the agent receives on each tick
EnabledToggle without deleting

Examples

  • Status digest — every 1h, summarize new messages in a busy Lark group and drop the digest in a "summary" thread
  • Watchdog — every 5min, query a health endpoint via the Web tool; ping you only on failure
  • Standup buddy — every weekday morning, ask the user how yesterday went and write a note

Notes

  • Each heartbeat target gets its own conversation thread (isolated history)
  • Combine with Memory so the agent learns from each tick
  • For stateful reminders/schedules driven by conversation content, use Agenda instead
  • Disable a heartbeat to pause without losing its config

Released under the MIT License.