从零实现一个 AI Agent

Agent 是现在 AI 领域最热的话题之一，但大部分教程只教你怎么调 API，不教底层原理。How Pi Agent Works 是一份中文教程，带你从零到一实现一个 AI Agent，理解它的核心机制。

使用 VitePress 构建教程站点，包含 TypeScript 渐进式 Demo 和一个完整的教学 Agent（React + Node.js）。

📖 在线学习：how-pi-agent-works.vercel.app

教程内容

覆盖 AI Agent 的核心概念：

• Agent Loop——Agent 的主循环是如何运转的
• 消息系统——消息如何在 Agent 内部流转
• 流式事件——流式响应的处理机制
• 工具调用——Agent 如何调用外部工具
• 会话树——多轮对话的状态管理
• 上下文压缩——长会话中的 token 优化

渐进式学习

教程包含 4 个核心 TypeScript Demo，从简单到复杂逐步深入：

1. 基础 Agent 循环
2. 消息和流式处理
3. 工具调用集成
4. 完整 Agent 实现

第 5 个 Demo 可选接入真实模型进行烟雾测试。

教学 Agent

教程最后附带一个可运行的完整教学 Agent，基于 React + Node.js + Express，前端运行在 5174 端口，API 在 4317 端口。可以直接部署到 Vercel。

快速开始

git clone https://github.com/cellinlab/how-pi-agent-works.git
cd how-pi-agent-works
npm run docs:dev

总结

How Pi Agent Works 是一份质量不错的中文 Agent 教程。它不浮于表面调 API，而是深入 Agent 的内部机制。对于想理解 Agent 原理而不是只会套框架的开发者来说，值得一看。

▶ 前往 GitHub 仓库 · 261 ★