Skip to content

从一个 while 循环开始,一步步搭出完整的 Agent

不堆概念,不讲花活。每一章一个最小闭环——文档讲清楚为什么,代码让你跑一遍,流程图帮你把东西串起来。

Course Positioning

一门按层次递进的 Agent 课,不是零散知识点的合集

从最简单的 Agent 循环出发,一步步加上工具、待办、子 Agent、技能、上下文压缩…… 每一章只解决一个问题,按模块递进,最终搭出完整的 Agent 系统。

How To Read

  1. 顺着来最省力s01-s06 每章都建立在前一章之上,按顺序走不容易卡住。
  2. 每章三件套学习内容、代码示例、流程图示,三个 Tab 切着看。先看哪个都行。
  3. 代码都能跑每章都附带完整 Python 代码,复制到本地就能运行。

看它活着的样子——
先别读代码,先看它怎么转。

Agent 的核心只有三件事:思考 → 行动 → 观察。下面这台"钟表"每秒都在走—— 它是贯穿整门课的主隐喻,无论后面加多少层(工具、记忆、子 Agent、技能),本质都是这个循环。

cycle00
stateTHINKING
tok/s12.4
  1. 接到任务:查北京今天天气
  2. 思考:我需要一个天气工具
  3. 行动:get_weather(city="北京")
  4. 观察:{ temp: 14, cond: "light_rain" }
  5. 思考:14° 有小雨,建议带伞
  6. 回答:北京 14°C 小雨,记得带伞。

Part 1 — 核心闭环

先把 Agent 的骨架搭起来

第一部分从最基础的循环开始,每章加一层能力。学完这六章,你就有了一个能工作的 Agent 系统骨架。

Primitives · 零件

把 Agent 拆开看,
只需要五块积木

点一块看它是什么、为什么需要、以及少了它会怎样。顺序不重要——先拆开,再组合

模型/ Model01 05

一个接受文字输入、产出文字输出的函数。在这本教程里,它几乎总是 Claude。你可以把它想成一个没有短期记忆、也没有手的聪明实习生——本身啥也干不了,但配上其他四块积木,它就能跑起来。

缺了它会怎样没有模型,整个 Agent 就只剩一堆工具函数,谁都不会说要调哪个

Code Evolution · 代码进化

六个章节,六种形态——
同一个 Agent,一层层长出来。

每一步只加一块积木。切换编号看代码怎么长出来、输出怎么变复杂。中间没有任何魔法。

code/py/01_agent_loop.py · 01 / 04# code/py/01_agent_loop.py — Agent 循环闭环@dataclassclass LoopState:    messages: list    turn_count: int = 1    transition_reason: str | None = None def run_turn(state: LoopState) -> bool:    response = client.chat.completions.create(        model=model,        messages=[{"role": "system", "content": SYSTEM_PROMPT},                  *state.messages],        tools=TOOLS,        max_completion_tokens=8000,    )    choice = response.choices[0]    message = choice.message    state.messages.append({        "role": "assistant",        "content": message.content or "",        "tool_calls": serialize_tool_calls(message.tool_calls),    })    if choice.finish_reason != "tool_calls":        return False                       # ← 模型说完了,退出    state.messages.extend(execute_tool_calls(message.tool_calls))    state.turn_count += 1    return True                            # ← 还有工具要跑,继续 def agent_loop(state: LoopState) -> None:    while run_turn(state):        pass

核心闭环只是开始

全套课程按 Part 组织,从骨架到平台一路打上去。Part 1 的六章是地基,往后每个 Part 都在它之上加一层能力。

Part 1连载中

核心闭环

从 while 循环、工具、待办、子 Agent、技能、到上下文压缩——搭出一个能工作的 Agent 骨架。

  • s01Agent 循环
  • s02工具使用
  • s03待办写入
  • s04子 Agent
  • s05技能系统
  • s06上下文压缩
Part 2筹备中

系统加固

让 Agent 跑得稳——权限、Hook、记忆、系统提示词、错误恢复,一套生产级的护栏。

  • s07权限系统
  • s08Hook 系统
  • s09记忆系统
  • s10系统提示词
  • s11错误恢复
Part 3筹备中

任务运行时

让 Agent 异步跑、定时跑、长时间跑——从一次性对话进化成持续工作的"工人"。

  • s12任务系统
  • s13后台任务
  • s14定时调度
Part 4筹备中

多 Agent 平台

多个 Agent 协作、自主运行、隔离工作、接入外部能力——从单机走到平台。

  • s15Agent 团队
  • s16团队协议
  • s17自主代理
  • s18Worktree 隔离
  • s19MCP 与插件

Reading Modes

三种读法,选适合你的

默认按章节顺序走,但你也可以根据自己的情况换个切入方式。

01

按章节顺序读

零基础首选。从 s01 开始,每章加一层,六章建立完整认知。最省脑子的读法。

02

先跑代码再看文档

有编程基础的直接点代码示例 Tab,跑通了再回头看原理。适合动手派。

03

只看流程图

赶时间的话,每章的流程图示 Tab 一张图概括核心逻辑。先有个印象再说。

What You'll Learn

核心闭环学完之后

  • 理解 Agent 循环的本质——不是调一次 API,而是一个持续的决策循环
  • 掌握工具调用的完整链路——定义、意图、执行、回流
  • 学会用待办系统让 Agent 管理自己的工作状态
  • 理解子 Agent 的价值——上下文隔离比多模型更重要
  • 搭建技能系统——按需加载,不是全部塞进 prompt
  • 处理上下文压缩——保住连续性,腾出工作空间

Design Principles

设计原则

  • 每章只讲一个概念,不贪多
  • 先建立心智模型,再看代码实现
  • 代码能跑比代码漂亮更重要
  • 流程图不是装饰,是理解工具

AI Agent Zero to Hero — 持续更新中