​

HeartbeatConfig

Defined in the heartbeat module.

AI Agent Configuration for Heartbeat scheduler. Attributes: schedule: Human-friendly schedule expression. Supports:

• Keywords: “hourly”, “daily”, “weekly”
• Intervals: “every 30m”, “every 6h”, “/30m”, “/10s”
• Cron: “cron:0 7 * * *”
• One-shot: “at:2026-03-01T09:00:00” prompt: Override prompt sent to agent each tick. None = use agent’s default. on_result: Callback receiving (result_text: str). Default: log to stdout. on_error: “retry” | “skip” | callable(error). Default: “retry”. max_retries: Max consecutive retries before skipping. Default: 3.

​

Properties

​

Source

---

​

Related Documentation