给客户部署私有 AI 助手时，最让人头疼的往往不是框架本身，而是那些「出厂默认值」—— 它们是为个人开发者设计的，而不是为团队在企业内网中重度使用设计的。
最近我们把 Pi Agent 部署进一家制造企业的内网，客户一句「它只能开 8 个窗口」，让我们挖出了一个由 8 行常量、一个没人看的告警和一个重启了 28000 次的服务组成的连环事故。以下是 8 条必须改的默认值，每一条都来自真实的生产教训。
Pi Agent 是什么
Pi Agent 是一个「跑在自己机器上的 AI 编程助手」框架。它和网页版 AI 聊天助手不同：
| 网页版 AI 助手 | Pi Agent | |
|---|---|---|
| 跑在哪 | 厂商服务器 | 你自己的机器（内网、私有部署） |
| 能干什么 | 只能聊天、只能读你贴给它的东西 | 能读写本机文件、执行命令、调内网系统 |
| 数据去向 | 上传给厂商 | 留在你自己的机器上 |
| 形态 | 一个网页 | 带网页界面的 Agent 运行时（带终端、带工具、能长时间干活） |
核心优势：给每个员工开一个能真正动手干活的 AI 助手，而且这个助手住在公司内网里。对数据不能出厂的制造企业来说，「私有部署的 Agent」几乎是唯一解—— 能力接进来，数据不出门。
三类出厂配置问题
① 硬编码限制，没有出口。最典型的是「一个项目最多同时开 8 个窗口」，写在编译产物里，没有环境变量、没有配置文件、没有命令行参数—— 想调只能改源码。对要在客户现场跑十几个业务线的团队来说，这个 8 是荒谬的。
② 改了也留不住。改的是 dist/ 里的代码，任何人跑一次依赖安装或升级版本，改动就无声无息地变回去。没有报错、没有告警，这种回退最难查。
③ 默认「一个人用」。8 个窗口这个数字本身说明了问题—— 框架没有考虑「多人多线」的场景，告警机制也没有针对生产环境设计。
必须改的 8 个默认值
1. 最大并发窗口数
默认值 8，硬编码在编译产物中。修改方式：直接编辑 dist/ 目录下对应的 JS 文件，找到常量赋值处改为更大的数字（如 50 或 100）。
2. 会话超时时间
默认超时过短，长时间操作会被中断。建议根据业务场景调整到 30 分钟以上。
3. 日志保留策略
默认不保留历史会话日志，建议配置日志输出路径和保留天数，方便排查问题。
4. 工具调用权限
默认开启所有工具调用权限，生产环境建议按需关闭，特别是文件系统写入和命令执行。
5. 告警阈值
默认的告警阈值过于宽松，建议设置合理的 CPU、内存和重启次数告警。
6. 自动重启策略
默认情况下服务崩溃会自动重启，但不会保留状态。生产环境建议配置状态持久化。
7. 网络代理配置
内网环境通常需要配置代理才能访问外部 API，默认没有代理设置。
8. 数据保留期限
默认的本地数据不会自动清理，长时间运行会占满磁盘。建议配置定时清理策略。
总结
Pi Agent 是一个优秀的私有部署 AI 助手框架，但它的默认配置是为个人开发者设计的。在交付给企业客户之前，必须针对「多人多线」「内网环境」「数据安全」这三个维度进行调整。8 个默认值的修改工作量不大，但能避免大量生产事故。
