Heartbeat 检查

Heartbeat 可以定期让 Agent 检查一小份清单，并报告值得关注的变化。它适合轻量提醒，不适合严格定时任务或关键监控。

Heartbeat 还是 Automation？

• 周期性“查看并在必要时报告”使用 Heartbeat。
• 时间、重试、运行历史和确定动作很重要时，使用 Automation。

设置 Heartbeat

1. 打开 设置 → Heartbeat。
2. 为目标 Agent 启用 Heartbeat。
3. 选择相对保守的间隔。
4. 添加简短清单，并写明什么情况下需要报告。
5. 保存并检查第一次结果。

示例：

- 检查进行中的 Task 是否阻塞或过期。
- 只报告新的阻塞或需要我决定的事项。
- 如果没有需要关注的内容，不要发送消息。

清单应保持简短。范围过宽会增加模型用量，并产生重复通知。

通知控制

决定结果发送到哪里，以及无事项时是否静默。依赖通知前，先在目标 Session 或消息通道测试一次。

安全使用

• 清单中不要放敏感信息。
• 避免要求无需确认就修改外部状态。
• 适合时使用低成本模型。
• Agent 的数据源或凭据不可用时暂停 Heartbeat。
• 在线率、安全或紧急告警使用专用监控系统。

故障排查

检查未运行时，确认 Gateway 服务持续运行、Heartbeat 已启用、Agent 有有效模型，并且等待时间已经超过间隔。从 设置 → 日志 查找第一个 Heartbeat 错误。