智能体
developers.cloudflare.com ·
@Cloudflare Developers
Cloudflare Agents SDK 支持 Pi 1.4，增强任务恢复能力
Cloudflare Agents SDK v0.30.0 在 Pi 1.4 上运行 PiHarness，新增任务休眠时 Durable Object 可休眠、持续崩溃任务被 parked 并可 session.retry() 重试、存储错误后重开 Pi、模型流中断按瞬时错误重试等恢复机制。Pi 1.4 迁移了对象 SQLite 中的会话存储 schema，升级后无法回滚到 Pi 1.3。
AI推荐理由 Cloudflare 官方 changelog 明确列出 Agents SDK v0.30.0 对 Pi 1.4 的适配细节：任务休眠时 Durable Object 可休眠、崩溃任务被 parked 而非无限重启、存储错误后可重开 Pi、模型流中断按瞬时错误重试。对使用 Cloudflare Agents 的开发者有直接升级价值；局限是仅面向该 SDK 用户，且 Pi 1.4 迁移 SQLite 会话存储后无法回滚到 1.3，属需注意的破坏性变更。
72
正文
Agents SDK v0.30.0 runs [`PiHarness`](https://developers.cloudflare.com/agents/harnesses/pi/) on [Pi 1.4 ↗︎](https://github.com/earendil-works/pi/blob/v1.4.0/packages/durable/CHANGELOG.md#140---2026-10-21), and makes it recover more reliably from evictions, crashes, and storage errors.
* **Hibernation while Pi's tasks sleep.** `PiHarness` passes Pi's new `onWake` callback to your harness factory. While a task sleeps, such as during a model retry backoff, the Durable Object can hibernate until the task is due instead of staying in memory.
* **Parked tasks.** Pi 1.4 parks a task that keeps crashing the object instead of restarting it forever. Parked operations show as `parked` in `pending()`, and `session.retry()` runs them again.
* **Recovery from storage errors.** `PiHarness` reopens Pi after a storage error instead of failing every call until the object restarts. Its wake-up job retries failed steps with a backoff instead of being dropped.
* **Retried model streams.** `agents/models/pi-ai` reports a cut-off or idle model stream as a transient error, so Pi retries the turn instead of failing it.
#### Upgrade
The [Agents SDK v0.30.0 changelog ↗︎](https://github.com/cloudflare/agents/blob/main/packages/agents/CHANGELOG.md#0300) has step-by-step upgrade instructions. Point your coding agent at them and upgrade today:
Copy promptPrompt copied!
Pi 1.4 migrates the session storage in the object's SQLite database to a schema that Pi 1.3 cannot open, so a deployment cannot roll back past this upgrade. Refer to the [Pi Durable 1.4.0 changelog ↗︎](https://github.com/earendil-works/pi/blob/v1.4.0/packages/durable/CHANGELOG.md#140---2026-10-21) for Pi's own breaking changes.