从零构建 AI Agent

大白话教程 · 12课渐进式 · 完整可运行代码

模型是 Agent,代码是 Harness。
从一个 while 循环开始,一步步搭出能协作、能自治、能并行的 AI Agent 系统。

开始之前

bash
pip install -r requirements.txt cp .env.example .env # 在 .env 里设置: # ANTHROPIC_API_KEY=sk-ant-xxx # MODEL_ID=claude-sonnet-4-6
第一阶段 打地基
01
Agent 循环
整个 Agent 就是一个 while 循环
02
工具使用
加工具 = 加函数 + 加配置
第二阶段 单兵作战
03
待办计划
让 Agent 自己管理任务清单
04
子 Agent
派实习生去干子任务
05
技能加载
知识按需加载,不塞满提示词
06
上下文压缩
三层压缩,让 Agent 永远聊下去
第三阶段 持久化
07
任务系统
JSON 持久化,压缩也不丢
08
后台任务
慢命令扔后台,不傻等
第四阶段 团队协作
09
Agent 团队
多 Agent 各有角色,信箱通信
10
团队协议
关闭审批 + 方案审批
11
自治 Agent
自己扫描任务板找活干
12
工作树隔离
git worktree 并行不冲突

能力进化路线

第1课  [循环]      ─→ Agent 能执行命令了
第2课  [工具]      ─→ Agent 能读写文件了
第3课  [计划]      ─→ Agent 会做计划了
第4课  [子Agent]   ─→ Agent 会分配任务了
第5课  [技能]      ─→ Agent 会按需学习了
第6课  [压缩]      ─→ Agent 能无限对话了
第7课  [持久任务]  ─→ Agent 的目标不会丢了
第8课  [后台]      ─→ Agent 能边想边干了
第9课  [团队]      ─→ 多个 Agent 协作了
第10课 [协议]      ─→ 团队有规矩了
第11课 [自治]      ─→ Agent 自己找活干了
第12课 [隔离]      ─→ 团队能并行不冲突了