想搞懂 Agent 内部运作原理？推荐一份学习资料《Pi-Agent SDK 源码深度解析》。

笔记分 10 章，逐层递进，把 Agent 的关键模块都捋了一遍：

1. Agent Loop（主循环）：Agent 的"心脏"，从接收输入到决策再到执行的完整回路；
2. 工具系统（Tool Pipeline）：工具怎么注册、怎么调用、怎么把结果喂回去；
3. 消息系统：不同格式的消息如何翻译、流转、对齐；
4. 事件驱动机制：事件总线怎么解耦各模块，让系统可扩展；
5. 会话管理（Session Tree）：多轮对话、上下文分支、状态恢复是怎么做的。

它采用双语言对照设计：TypeScript 和 Python 两条路径并行，不管你主用哪门语言，都可以跟着跑通。

阅读方式方面也给了三种选择：在线三栏 Web 版（方便跳转对照）、Markdown 下载、本地 PDF 离线版。

项目还附赠了一个 Agent Loop 可执行 Notebook，用户可以单步运行、改参数实验，不是干巴巴地"读代码"，而是动手"玩代码"。

反正，会用 Agent 框架是起点，读懂它为什么这么设计，才是真正能改造和优化的开始。

🔗 GitHub地址：github点com/buchidonggua/dg-ai-notes

🌐 在线阅读：dg-ai-notes点pages点dev/