系列概览:从零搭一个 AI Agent 框架

00. 系列概览:从零搭一个 AI Agent 框架

这是一个教学系列,基于 Axon 项目,带你从零理解 AI Agent 框架的核心设计。


为什么要写这个系列?

我一直在学习和研究 AI Agent 的工程实现。市面上讲解 Agent 概念的文章很多,但能深入到代码层面、讲清楚每个设计决策的并不多。

这个系列是我的学习笔记,也是写给想深入 Agent 工程的人看的。


系列文章一览

#模块标题核心内容
01Agent LoopAgent 大脑:主循环是怎么转起来的思考→行动→观察的闭环,循环边界,上下文管理
02工具系统让 Agent 有手有脚工具注册、Schema 生成、参数校验、MCP 集成
03权限/安全别让 Agent 乱跑权限检查链、敏感信息保护、用户确认机制
04任务规划拆解复杂目标DAG 任务模型、依赖解析、状态管理
05Skill 系统注入专业能力技能定义、条件匹配、加载执行
06记忆系统让 Agent 记住你记忆类型、存储检索、持久化
07多 Agent 协作从独奏到交响通信协议、任务分发、子 Agent 生命周期
09流式输出让 Agent 边想边说Streaming chunk、工具调用拼接、重试、AbortSignal

模块关系图

flowchart TB
    USER[用户输入] --> LOOP[Agent Loop<br>主循环]

    LOOP --> TOOLS[工具系统<br>注册 · 校验 · 分发]
    LOOP --> SKILLS[Skill 系统<br>专业能力注入]
    LOOP --> MEM[记忆系统<br>结构化存储]
    LOOP --> STREAM[流式输出<br>chunk · retry · abort]

    TOOLS --> PERM[权限/安全<br>检查 · 保护 · 确认]
    TOOLS --> TASK[任务规划<br>DAG 依赖编排]

    MEM --> COLLAB[多 Agent 协作<br>通信 · 分发 · 聚合]

    style LOOP fill:#4A90D9,color:#fff
    style TOOLS fill:#7B68EE,color:#fff
    style PERM fill:#E74C3C,color:#fff
    style TASK fill:#2ECC71,color:#fff
    style SKILLS fill:#F39C12,color:#fff
    style MEM fill:#1ABC9C,color:#fff
    style COLLAB fill:#E91E63,color:#fff
    style STREAM fill:#3498DB,color:#fff

阅读顺序

建议按编号顺序阅读。每篇文章都从最朴素的问题出发,逐步推导 Axon 的设计方案。

第一篇不依赖任何前置知识。后续文章会假设你已经理解了 Agent Loop 的基本概念。


关于 Axon

Axon 是一个 TypeScript 实现的 AI Agent 框架,代码量适中(核心约 2000 行),适合作为学习 Agent 工程的教学案例。

系列中所有代码分析都基于 Axon 的真实实现,但我会做简化处理,让你能抓住主线逻辑,不被细节淹没。

读完整个系列,你不仅能理解 Axon 的设计,也能自己动手搭建一个 Agent 框架的核心组件。