📚 Pi Agent 原理与实现
从零到一实现一个 AI Agent 的中文渐进式教程 · 共 39 个页面
来源：
cellinlab/how-pi-agent-works
（MIT，842 ⭐）
← 返回 doc 首页
开始
课程首页
home.html
运行与学习路线
quick-start.html
联系与赞助
contact.html
第一部分：核心概念
(6 篇)
上下文、技能与压缩
concepts/context.html
消息、流式事件与状态
concepts/message-and-stream.html
Pi 的总体架构
concepts/pi-architecture.html
会话、树与分支
concepts/sessions.html
工具调用机制
concepts/tools.html
Agent 到底是什么
concepts/what-is-agent.html
第二部分：源码拆解
(7 篇)
进阶：真实 Pi 为什么压缩更复杂
source/advanced-compaction.html
Agent Loop 主循环
source/agent-loop.html
AgentSession 运行层
source/agent-session.html
pi-ai：模型协议层
source/model-protocol.html
会话格式、分支与压缩链路
source/session-compaction.html
源码阅读地图
source/source-map.html
工具、扩展与资源加载
source/tools-extensions.html
第三部分：渐进式 Demo
(5 篇)
Demo 1：最小 Agent 循环
demos/01-loop.html
Demo 2：工具定义与执行
demos/02-tools.html
Demo 3：JSONL 会话树
demos/03-session-tree.html
Demo 4：上下文压缩
demos/04-compaction.html
Demo 5：OpenAI-compatible 真模型烟测
demos/05-real-model.html
第四部分：教学版目标项目
(16 篇)
后端实现
project/backend.html
从零实现路线
project/build-00-roadmap.html
Step 1：共享协议
project/build-01-protocol.html
Step 2：Loop 与 MockModel
project/build-02-loop-model.html
Step 3：工具系统
project/build-03-tools.html
Step 4：JSONL 会话
project/build-04-session-store.html
Step 5：Express API
project/build-05-api.html
Step 6：React 前端
project/build-06-frontend.html
Step 7：调试与验收
project/build-07-debug.html
可选：接入 OpenAI-compatible 模型
project/build-08-real-model.html
Demo 到项目的映射
project/code-map.html
扩展方向
project/extend.html
前端实现
project/frontend.html
教学版目标项目总览
project/overview.html
运行与调试
project/run.html
测试：把 Agent 当工程系统保护起来
project/testing.html
参考
(2 篇)
常见错误
reference/pitfalls.html
资料来源
reference/sources.html