Wink Pings

Tobi 说 Pi Durable 是 agent 编程的 POSIX,Cloudflare 把它塞进了 Durable Object

Cloudflare 文档显示,PiHarness 能把 Pi Durable 跑在 Durable Object 里,transcript、重试、工具调用和崩溃恢复都进 SQLite。Tobi Lutke 把它比作 agent 编程的 POSIX,真正值得看的是崩溃后的恢复语义和账单。

Cloudflare 的 Agents SDK 多了一个 PiHarness。它把 Pi Durable 跑在 Durable Object 里,Pi 负责 agent loop,Cloudflare 负责存储、唤醒和崩溃后的重启。文档在 Agents SDK 的 Pi 页面。

Pi 本身是个最小、可扩展的 agent harness。它管 transcript、follow-up 和 steer 的 inbox、模型调用、工具执行、重试,以及崩溃恢复。PiHarness 做两件具体事:把 Pi 的 transcript、inbox、任务写进 Durable Object 的 SQLite,表名以 pi_ 开头;再通过 Lifecycle 调度一个 job,用 Pi 的 wake() 保持心跳。对象被驱逐后,job 的 alarm 会叫醒它,Pi 重开存储,继续跑。

这听着像底层设施,确实也是。Tobi Lutke 在 X 上说“pi-durable is the posix of agent programming”。POSIX 的分量在于开发者不用关心底层是哪种 Unix。PiHarness 要配得上这个比喻,关键不在 API 名字,在工具调用中途崩溃后的处理:文档说,标记 replay 为 safe 的工具会重跑,其他工具不重跑,模型拿到 interrupted 结果自己决定下一步。重放语义写清楚了,durable 才不会变成盲重试。

有网友在回复里说,线上把重试压进 durable 层,胶水代码直接少一半。也有人用 Pi Durable 在 Durable Object 上跑 PR review agent。另一个使用场景更日常:重启 IDE 升级时,正在干活的 agent 还能活下来。这个体验比“支持崩溃恢复”四个字更有说服力。

安装入口是 npm i agents @earendil-works/pi-durable @earendil-works/pi-ai @earendil-works/pi-schema @earendil-works/chord。版本细节比 API 更容易踩坑:Pi 包是 agents 的可选 peer deps,版本约 1.5.0;Pi Durable 还是实验性,minor 版本可能改 API;Agents SDK 0.33.0 以后才支持 Pi 1.5。文档还提醒,对话在 Pi 1.5 上跑过以后,把 Worker 回滚到 Pi 1.4 会让这段对话读不出来,坏部署只能向前修。

恢复行为值得单独看。对象被驱逐、崩溃、超过内存或 CPU 限制,下一次 alarm 会重启对象,Pi 从上一个 checkpoint 继续。部署发生在运行中途,运行时给在途工作 30 秒,然后 alarm 重启。模型当时在流式输出,Pi 保留已经存下的部分答案,这次请求按 settings.retry 算一次失败尝试,有重试就再调模型,没重试就以 interrupted 结束。工具在跑,标记 replay 为 safe 的重跑,其他不重跑。任务连续把对象搞崩,restartLimit 默认 5 次后会停掉,避免无限重启。

限制也列得清楚:Pi Durable 还没有工具调用的审批或权限步骤;abort() 要等会话空闲,忽略 abort signal 的工具会把会话拖住;单次模型请求流式超过 15 分钟可能被切断,虽然 harness 每 10 分钟交接新 alarm;后台任务靠心跳检查,最多晚 30 秒发现完成;运行中的会话不会优雅驱逐;会话还不能删除。

账单是另一面。Durable 的 agent 会长时间跑,重试和崩溃恢复都会放大调用次数。有人在回复里担心账单失控,Allan Leinwand 指向 Cloudflare 的 Spend Management。这个功能同期上线,先支持 Workers 和 Durable Objects,可以设阈值、发邮件、到限额暂停会产生费用的调用。agent 可以 durable,账单也会。

Cloudflare Spend Management 的 Durable Objects 限额设置

Tobi 的 POSIX 比喻有分量,但 POSIX 赢在底层可替换,开发者可以停止关心 Unix 的差异。PiHarness 现在把 agent 的持久化、重试、恢复搬进平台,写胶水的人会少,平台限制也会变成你的限制。文档里那些限制比发布公告更值得读。

发布时间: 2026-11-16 03:28