正文预览
PRINCIPLE MAP · 完整运行链路
Pi 工作原理：从一条 Prompt 到一次完整 Agent Loop
前面的课程分别讲过 Session、Context、System Prompt、Tool、Skill、Compaction 和 Cache。单独看，每个词都不难；真正容易卡住的是：当你提交一条任务以后，它们究竟怎样连在一起？
这一篇只做一件事：把一次请求从输入到完成完整跑通。读完以后，你应该能看着 Pi 界面里的模型回复、工具调用和工具结果，说清它现在位于哪一步，以及下一步为什么还会再次调用模型。
先记住一句话
Pi 是组织运行过程的 Agent Harness。模型负责判断下一步，工具负责接触真实环境，Session 保存过程，Context 是某一次模型调用真正收到的输入。
先看完整运行链
图里最重要的不是箭头数量，而是中间那一圈：
模型 → Tool Call → 工具执行 → Tool Result → 模型再次推理
只要模型仍然需要外部信息或动作，这个循环就可以继续。模型可能先读取文件，再搜索内容，再修改文件，最后运行检查；每次工具返回的结果都会成为下一次模型判断的依据。模型不再请求工具、而是给出普通回复时，这一轮 Agent Loop 才结束。
图中的 Compaction 使用虚线，因为它不是每条 Prompt 都会经过的固定步骤。只有上下文接近限额、手动执行 /compact，或相应机制被触发时，Pi 才会把较早内容整理成摘要，再带着保留的近期消息继续。
不要把所有术语排成一条流水线
下面这条写法适合记忆大方向：
输入任务 → 读取 Session → 构建 Context → 调模型 → 调工具 → 返回结果
→ 再次推理 → 回复用户 → 写入 Session → 必要时 Compaction → 继续
但真实结构里有三个需要修正的地方。
1. System Prompt、Tool 和 Skill 共同参与 Context 组装
它们不是三个依次执行的站点。
- System Prompt 规定 Pi 以