第六部分,安全与自动化
自动化可靠性与生产可观察性
为无人值守 Pi 任务设计超时、重试、幂等、事件日志、成本观测和恢复。
把 Session 事件变成运行状态
自动化应记录 agent_start、turn、message、tool execution、compaction 和 retry 事件,并关联任务 ID、模型、版本和工作目录。
日志中保留足够诊断信息,但对代码、个人数据、终端输出和凭据脱敏。
- 任务设置总超时和最大 turn 数。
- 重试只用于可恢复错误。
- 外部写入使用幂等键。
- 监控 token、缓存、成本和工具延迟。
- 保留中止、回滚和人工接管。
可恢复运行
Sessions 可以保存上下文,但生产状态应写入业务数据库。进程重启后通过明确任务状态恢复,而不是只依赖最后一条模型消息。
升级模型、Pi 或扩展前使用固定任务集回归,并保留上一版本。
官方资料
本页由 xueai 根据 Pi 官方资料用中文重新组织和讲解。Pi 更新频繁,命令、包名和接口以官方最新文档为准。
Pi 源代码和官方文档采用 MIT License。Copyright (c) 2025 Mario Zechner。本站保留原版权与许可声明,完整文本见 MIT License。