👋
01 - Hello Agent
创建最简 Agent —— 一个提示，一个回复，退出。
⚡
02 - 流式输出
实时打字机效果，基于事件订阅模型。
🛠️
03 - 自定义工具
使用 TypeBox 参数 Schema 定义你自己的工具。
💾
04 - 会话持久化
使用 JSONL 会话文件保存和恢复对话。
✅
05 - 确认模式
阻塞工具执行，直到用户明确确认。
🧠
06 - 系统提示词与技能
使用系统提示词和技能文件控制 Agent 行为。
📂
07 - 多会话管理
管理多个对话会话 —— 列表、创建、切换。
🚀
08 - 完整 CLI Agent
终章 —— 一个完整的、生产级 CLI Agent。
📖
8
章节
📄
15+
源文件
🧩
5
核心模式
🤖
4
AI 提供商
框架对比
pi-coding-agent 与其他主流 AI Agent 框架的功能对比。
| 功能 | pi-coding-agent | Vercel AI SDK | LangChain | CrewAI | OpenAI Agents SDK | Mastra |
|---|---|---|---|---|---|---|
| TypeScript 优先 | ✅ | ✅ | 🟡 | — | ✅ | ✅ |
| 流式事件 | ✅ | ✅ | ✅ | — | ✅ | ✅ |
| 工具 / 函数调用 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| 会话持久化 | ✅ | — | ✅ | — | — | — |
| 多模型供应商 | ✅ | ✅ | ✅ | ✅ | — | ✅ |
| 内置编码工具 | ✅ | — | — | — | — | — |
| 技能 / 插件系统 | ✅ | — | ✅ | ✅ | — | ✅ |
| 人机协作 | ✅ | — | ✅ | ✅ | ✅ | — |
| 多 Agent | — | — | ✅ | ✅ | ✅ | ✅ |
| GUI / Studio | — | — | ✅ | ✅ | — | — |
✅ 支持 🟡 部分支持 — 未内置
概念覆盖矩阵
每章逐步引入新模式，第 08 章整合所有概念。
| 概念 | Ch01 | Ch02 | Ch03 | Ch04 | Ch05 | Ch06 | Ch07 | Ch08 |
|---|---|---|---|---|---|---|---|---|
createAgentSession | ● | ● | ● | ● | ● | ● | ● | ● |
Streaming / Events | · | ● | ● | · | · | ● | · | ● |
Custom Tools | · | · | ● | · | ● | ● | · | ● |
Session Persistence | · | · | · | ● | · | · | ● | ● |
Confirmation Pattern | · | · | · | · | ● | · | · | ● |
System Prompt | · | · | · | · | · | ● | · | ● |
Skills Loading | · | · | · | · | · | ● | · | ● |
Multi-Session | · | · | · | · | · | · | ● | ● |
Coding Tools | · | · | · | · | · | · | · | ● |
Abort / DeltaBatcher | · | · | · | · | · | · | · | ● |
技术栈
本教程使用的工具和库。
核心
pi-coding-agent
Agent 框架 — 会话、工具、资源、流式输出
AI
pi-ai
模型抽象层 — Anthropic、OpenAI、Google、DeepSeek
Schema
TypeBox
用于工具参数定义的 JSON Schema 构建器
语言
TypeScript
严格模式、ESM、顶层 await
运行时
Bun + tsx
高性能运行时和 TypeScript 执行器
存储
JSONL Sessions
行分隔 JSON 格式的持久化对话存储