Pi Durable
Pi框架的持久化工作流模块,支持长时运行Agent任务的状态保存与恢复,内置检查点机制,使AI多步骤工作流在中断后可续跑而非从头执行
核心事实
时间轴 (近 90 天)
Pi Durable 在 Pi 生态架构中替代的是 Pi Harness 层,它同样建立在 Pi AI 之上,但提供了另一套可替换的 Harness 实现。
Pi Durable 提供了管理对话的 API,但它不是完整的 CRUD 接口,不会替开发者处理所有用户和对话管理逻辑。
SQLite 的事务特性保证了 Pi Durable 检查点写入的原子性,即使写入过程中崩溃也不会留下半写状态。
对于需要无人值守长时间运行、且需要跨进程崩溃恢复的智能体场景,Pi Durable 值得关注;如果只是构建普通 Coding Agent,常规 Pi Harness SDK 可能就够用了。
在 Pi Durable 中,提交查询后返回 Submission ID,开发者可以选择等待最终结果,也可以订阅事件流实时读取模型生成内容和工具调用。
Pi Durable 的交付核心是一个 Harness 类,供开发者导入自己的程序;从应用开发者角度看,模型调用方式保持不变,只替换负责长期运行的 Harness。
Pi Durable 的检查点机制会周期性将任务执行状态(如工具调用开始/完成情况)写入存储系统,并关联外部副作用,从而避免恢复时重复执行已完成的外部操作。
在演示中,UP主使用 Ollama 加载 Qwen 3.5 0.8B 模型,通过 Pi Durable Harness 调用 Read 工具读取 README 文件并找出秘密短语。
Pi Durable 目前处于早期开发阶段,接口今后很可能发生变化。
初始化 Pi Durable Harness 分为六步:配置模型Provider、打开工具注册表、设置存储、打开Harness、创建或取回对话、提交查询。
还有 22 条时间轴事件
全部知识事实 (20)
Pi Durable 是一个全新运行时,让智能体能够连续运行数天,通过检查点实现崩溃恢复,支持并发对话和多界面访问
65%待验证Pi Durable 提供了管理对话的 API,但它不是完整的 CRUD 接口,不会替开发者处理所有用户和对话管理逻辑。
50%待验证SQLite 的事务特性保证了 Pi Durable 检查点写入的原子性,即使写入过程中崩溃也不会留下半写状态。
50%待验证对于需要无人值守长时间运行、且需要跨进程崩溃恢复的智能体场景,Pi Durable 值得关注;如果只是构建普通 Coding Agent,常规 Pi Harness SDK 可能就够用了。
50%待验证在 Pi Durable 中,提交查询后返回 Submission ID,开发者可以选择等待最终结果,也可以订阅事件流实时读取模型生成内容和工具调用。
50%待验证Pi Durable 的交付核心是一个 Harness 类,供开发者导入自己的程序;从应用开发者角度看,模型调用方式保持不变,只替换负责长期运行的 Harness。
50%待验证Pi Durable 的检查点机制会周期性将任务执行状态(如工具调用开始/完成情况)写入存储系统,并关联外部副作用,从而避免恢复时重复执行已完成的外部操作。
50%待验证初始化 Pi Durable Harness 分为六步:配置模型Provider、打开工具注册表、设置存储、打开Harness、创建或取回对话、提交查询。
50%待验证Pi Durable 不会自动读取工作目录中的 PI 文件夹或 agents.md 等配置文件,所有配置必须在初始化对话时显式加载。
50%待验证Pi Durable 中的 Conversation 大致相当于 Pi Coding Agent 中的 Session,每个对话有独立的系统提示词、工作目录、工具和技能。
50%待验证Pi Durable 不是像 Pi Coding Agent 那样开箱即用的成品应用,它不提供现成的 CLI 界面,需要开发者自行实现交互界面。
50%待验证Pi Durable 在 Pi 生态架构中替代的是 Pi Harness 层,它同样建立在 Pi AI 之上,但提供了另一套可替换的 Harness 实现。
50%待验证Pi Durable 目前支持 SQLite、JSONL 文件存储和内存存储三种存储后端,其中内存存储关闭进程后数据即丢失。
50%待验证Durable News Agent系统采用分层架构:最底层是SQLite数据库,之上是Pi Durable提供的持久化任务能力,再往上封装为API,最外层是浏览器、终端TUI、CLI和Cron等瘦客户端。
50%待验证持久化任务框架(如Temporal、Restate、Pi Durable)的核心思路是把任务的每一步执行状态写入持久化存储,使任务在故障后能从断点恢复,并保证同一任务不会被重复触发。
50%待验证Pi Durable 的源材料未讨论检查点的清理策略或压缩机制。
50%待验证Pi Durable 对每次工具调用都写入持久化存储,会带来额外 I/O 开销和存储增长;对于高频调用的 Agent,JSONL 文件会快速膨胀,SQLite 也会面临写入压力。
50%待验证在 Pi Durable 中,SQLite 适合需要按条件查询状态和保证事务原子性的场景,JSONL 适合日志式追加、事后审计和快速人工检查。
50%待验证Pi Durable 将检查点粒度设为单个 task 和单次 tool call,使 Agent 执行流被切分为可独立恢复的离散片段。
50%待验证Pi Durable 的目标场景是通过 Slack、邮件或 Telegram 触达的 always-on(常驻)Agent,而非在终端中交互式运行的 CLI 工具。
50%