Heartbeat Config • AI Agent SDK

HeartbeatConfig: Configuration for Heartbeat scheduler.

HeartbeatConfig

Defined in the heartbeat module.

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