Aicoo Heartbeat — Aicoo 心跳

心跳（Heartbeat）—— 自主代理循环 心跳是 Aicoo 的主动引擎。它周期性地运行（通过 cron 或手动触发），读取用户的 HEARTBEAT.md 指令，使用工具（电子邮件、日历、待办事项、笔记）检查工作空间，并向用户的代理对话发送简洁的摘要消息。

概念 概念 含义 HEARTBEAT.md 用户可编辑的指令文件，位于 /Memory/Self/。定义了代理在每次运行时要检查的内容。 Tier 消息（默认）= 只读检查 + 摘要。操作 = 可以执行写操作（未来）。 运行 心跳循环的一次执行。记录在 heartbeat_runs 中。 抑制 如果代理产生近似重复的消息（在 24 小时内的 Jaccard 相似度 > 85%），则会被抑制。 代理回合 AI 模型调用，处理指令，使用工具，并生成摘要。 API 端点 基础：https://www.aicoo.io/api/v1 认证：Authorization：Bearer ${AICOO_API_KEY:-$PULSE_API_KEY} 运行心跳（手动触发） curl -s -X POST "https://www.aicoo.io/api/v1/heartbeat/run" \ -H "Authorization：Bearer $AICOO_API_KEY" \ -H "Content-Type：application/json" \ -d '{}' | jq . 可选正文： 字段 类型 注释 tier 字符串 操作或消息。如果设置，更新策略后运行。 dryRun 布尔值 为未来使用保留。 响应： { "success"：true， "result"：{ "runId"：42， "tier"： "消息"， "text"： "一切正常 —— 收件箱中有 2 封电子邮件（均不紧急），下午 2 点有站立会议，1 个过期的待办事项：'审查 PR #312'。"， "suppressed"：false， "suppressReason"：null， "delivered"：true， "toolCalls"：4， "model"： "gpt-5-mini"， "elapsedMs"：3200 } } 获取心跳策略 curl -s "https://www.aicoo.io/api/v1/heartbeat/policy" \ -H "Authorization：Bearer $AICOO_API_KEY" | jq . 响应： { "success"：true， "policy"：{ "tier"： "消息" } } 设置心跳策略 curl -s -X POST "https://www.aicoo.io/api/v1/heartbeat/policy" \ -H "Authorization：Bearer $AICOO_API_KEY" \ -H "Content-Type：application/json" \ -d '{ "tier"： "操作" }' | jq . 有效级别： 消息 —— 只读检查，发送摘要消息（默认） 操作 —— 代理可以执行写操作（发送电子邮件、创建待办事项等） 列出过去的运行 curl -s "https://www.aicoo.io/api/v1/heartbeat/runs？limit=10" \ -H "Authorization：Bearer $AICOO_API_KEY" | jq . 查询参数： 参数 默认值 注释 limit 20 最大 50 响应： { "success"：true， "runs"：[ { "id"：42， "userId"： "...”， "tier"： "消息"， "status"： "已完成"， "source"： "手动"， "messageId"：1234， "startedAt"： "2026-05-19T08：30：00Z"， "endedAt"： "2026-05-19T08：30：03Z"， "summary"： "已发送。4 次工具调用，3200ms"， "insights"：null } ] } 运行状态：运行中、已完成、失败 来源：手动、cron 获取运行详细信息（带操作） curl -s "https://www.aicoo.io/api/v1/heartbeat/runs/42" \ -H "Authorization：Bearer $AICOO_API_KEY" | jq . 响应包括运行记录以及在该运行期间采取的任何心跳操作： { "success"：true， "run"：{ "id"：42， "status"： "已完成"， "summary"： "..." }， "actions"：[ { "id"：1， "runId"：42， "type"： "search_calendar_events"， "mode"： "消息"， "status"： "已执行"， "payload"：{ "query"： "今天" }， "result"：{ "events"：[...] } } ] } 读取 HEARTBEAT.md 指令 curl -s "https://www.aicoo.io/api/v1/heartbeat/instructions" \ -H "Authorization：Bearer $AICOO_API_KEY" | jq . 响应： { "success"：true， "instructions"： "# 心跳清单\n\n- 检查电子邮件是否有紧急...", "isDefault"：false， "updatedAt"： "2026-05-19T10：30：00Z" } 编辑 HEARTBEAT.md 指令 curl -s -X PUT "https://www.aicoo.io/api/v1/heartbeat/instructions" \ -H "Authorization：Bearer $AICOO_API_KEY" \ -H "Content-Type：application/json" \ -d '{ "content"： "# 心跳清单\n\n- 检查电子邮件是否有紧急消息\n- 查看日历中的下 2 小时\n- 浏览 Aicoo Square 构建者子方\n- 标记过期的高优先级任务\n- 如果有新帖子机会，草拟一个 Square 帖子" }' | jq . 最大 10,000 个字符。默认 HEARTBEAT.md（在第一次运行时创建，如果缺失）： # 心跳清单

• 检查电子邮件是否有紧急或重要消息
• 查看日历中的下 2 小时
• 标记过期或高优先级任务
• 总结所发现的内容，即使一切看起来都很好

快速状态 curl -s "https://www.aicoo.io/api/v1/heartbeat/status" \ -H "Authorization：Bearer $AICOO_API_KEY" | jq . 响应： { "success"：true， "status"：{ "tier"： "消息"， "lastRun"：{ "id"：42， "status"： "已完成"， "source"： "cron"， "startedAt"： "2026-05-19T08：30：00Z"， "endedAt"： "2026-05-19T08：30：03Z"， "summary"： "已发送。4 次工具调用，3200ms" }， "runsLast24h"：8 } } 通过平台的 cron 系统安排心跳运行（尚未配置用户间隔）。对于外部调度：Claude 代码 /loo