理解原理
从先备概念、因果解释与反例开始，能够用自己的话讲清楚。
从模型调用开始 →知识目录选择核心方向与细分内容
SYSTEMATIC LEARNING / 系统学习
Agent 应用开发知识地图
以业务任务为起点，系统学习大模型应用的接口调用、工具集成、检索、记忆、可靠执行、评测与上线。沿实现、故障和工程取舍逐层深入，再用面试题与实验检查理解。
同一个知识点，逐步学到工程深处
刚接触 Agent 的开发者先补基础，有实现经验后继续研究故障和取舍。按这个知识点的熟悉程度选择起点。
当前有 8 个分层专题，各层提供独立讲解与任务。标为“核心讲解”的单元继续提供已有原理、追问和迁移案例，尚未全部扩写为分层课程。
核心方向 01
模型调用与上下文
从应用需要出发，理解接口返回、上下文容量与模型能力边界。预训练和微调只讲它们如何影响模型选型、知识更新及证据使用；本方向的任务围绕请求组装、响应处理和应用方案选择展开。
贯穿本方向的问题：模型从哪里获得信息，输出处在哪个阶段，程序据此能作出什么判断？
学完后，应该能够解释什么？
- 计算输入、输出与上下文余量并解释截断原因
- 根据知识更新、证据与行为需求选择检索、工具或微调方案
- 识别文本、工具请求、拒绝和不完整响应的不同处理路径
- 解释结构合法、事实正确和业务完成之间的关系
- 第一次模型调用与响应契约从普通 HTTP 接口走到生成接口：组装请求、分辨响应、关联工具结果，再用运行证据核对答案。
分层专题 · 入门、实现、排错与设计各有独立讲解及任务
知识练习 · 2 道关联题 · 开始作答 → - 提示、结构化输出与迭代验收用普通退货、商品例外和缺失政策三个问题，连接任务指令、结构约束、证据引用及版本比较。
分层专题 · 入门、实现、排错与设计各有独立讲解及任务
知识练习 · 3 道关联题 · 开始作答 → - 上下文与生成预算从完整请求的容量算例出发，理解输入、输出、下一轮增量与证据保留的关系。
分层专题 · 入门、实现、排错与设计各有独立讲解及任务
知识练习 · 3 道关联题 · 开始作答 →
核心方向 02
任务契约与执行编排
自主规划必须落在可控制的任务边界内。任务合同、状态、预算和交接决定系统如何前进、何时结束，以及多个分支怎样共同工作。
贯穿本方向的问题：怎样把模型的下一步建议组织成受约束、可验收的执行过程？
建议先理解：模型调用与上下文
学完后，应该能够解释什么？
- 用任务输入、约束和验收定义执行边界
- 比较状态图、自主循环与多 Agent 的适用条件
- 解释并发合并、重规划和上下文压缩中的不变量
- Agent 循环的控制权与完成判据从工具调用循环出发，设计终止条件、预算、取消与可验证的完成状态。
核心讲解 · 原理、追问与迁移案例
知识练习 · 1 道关联题 · 开始作答 → - 确定流程与局部探索的组合围绕确定流程、动态探索、检查点和人工审批，选择可恢复的编排结构。
核心讲解 · 原理、追问与迁移案例
知识练习 · 1 道关联题 · 开始作答 → - 并行状态合并的代数与业务语义考察状态建模、Reducer、并发合并与消息去重。
核心讲解 · 原理、追问与迁移案例
知识练习 · 1 道关联题 · 开始作答 → - 任务契约与独立验收把模型外围的执行环境、权限、状态、证据与完成判定做成工程契约。
核心讲解 · 原理、追问与迁移案例
知识练习 · 1 道关联题 · 开始作答 → - 多 Agent 的分工收益与协调成本考察任务可并行性、协调成本、证据合并和对照实验。
核心讲解 · 原理、追问与迁移案例
知识练习 · 1 道关联题 · 开始作答 → - 计划修订与外部事实的分离考察动态计划、已完成副作用、依赖关系和验收不变式。
核心讲解 · 原理、追问与迁移案例
知识练习 · 1 道关联题 · 开始作答 → - 任务交接的责任与权限传播考察 Handoff、身份传播、最小上下文与责任边界。
核心讲解 · 原理、追问与迁移案例
知识练习 · 1 道关联题 · 开始作答 →
核心方向 03
工具契约与外部动作
工具让模型影响真实系统。参数、身份、协议、版本和业务幂等性共同决定一个工具请求能否被安全理解、执行和核对。
贯穿本方向的问题：一个看起来合法的工具请求，怎样成为可核对的业务动作？
建议先理解：任务契约与执行编排
学完后，应该能够解释什么？
- 区分结构校验、业务校验与授权
- 解释超时、断线和重试为什么需要结果核验
- 设计工具集合、兼容版本和大结果交付方式
- 工具调用的结构、授权与业务契约从一个格式合法却跨租户的请求开始，逐层解释工具请求怎样成为可执行动作。
分层专题 · 入门、实现、排错与设计各有独立讲解及任务
知识练习 · 3 道关联题 · 开始作答 → - 大工具目录的发现与执行分层考察工具目录、动态发现、召回质量和服务端授权。
核心讲解 · 原理、追问与迁移案例
知识练习 · 1 道关联题 · 开始作答 → - 并行结果的交付条件与共享截止时间考察异步并发、截止时间、取消传播与部分结果。
核心讲解 · 原理、追问与迁移案例
知识练习 · 1 道关联题 · 开始作答 → - 大结果的计算、引用与快照一致性考察输出契约、分页、产物引用与确定性计算。
核心讲解 · 原理、追问与迁移案例
知识练习 · 1 道关联题 · 开始作答 → - 连接恢复、消息恢复与业务核验考察 stdio、Streamable HTTP、会话恢复与业务幂等的区别。
核心讲解 · 原理、追问与迁移案例
知识练习 · 1 道关联题 · 开始作答 →
核心方向 04
检索、证据与长期记忆
模型能否得到相关、可信、当前有权使用的信息，直接影响回答质量。检索和记忆共享来源、作用域、版本及撤销边界，也各有不同的读写与评估机制。
贯穿本方向的问题：怎样把正确且允许使用的信息送入上下文，并知道何时不能作答？
学完后，应该能够解释什么？
- 沿召回、排序、组装与生成定位错误
- 处理切块、查询改写、引用与证据冲突
- 管理记忆的写入、检索、作用域和撤销
RAG 与检索工程
- 从文档入库到有引用的 RAG 回答亲自运行 Markdown 解析、真实 Embedding 向量回放、SQL 权限过滤、BM25、向量检索、RRF 和候选验收。
分层专题 · 入门、实现、排错与设计各有独立讲解及任务
知识练习 · 5 道关联题 · 开始作答 → - RAG 的证据流与故障定位追踪同一条证据在召回、排序、上下文和回答中的变化，理解每一步为什么可能丢失答案。
分层专题 · 入门、实现、排错与设计各有独立讲解及任务
知识练习 · 4 道关联题 · 开始作答 → - RAG 中授权与派生数据的一致性把授权贯穿召回、重排、上下文、缓存和来源访问，而非只过滤最终答案。
核心讲解 · 原理、追问与迁移案例
知识练习 · 1 道关联题 · 开始作答 → - 自然语言查询的口径、粒度与执行边界考察语义层、受控 SQL、只读执行和结果复核。
核心讲解 · 原理、追问与迁移案例
知识练习 · 1 道关联题 · 开始作答 → - 查询改写中的实体消歧与约束保真考察多轮指代、实体链接、澄清与原始约束保留。
核心讲解 · 原理、追问与迁移案例
知识练习 · 1 道关联题 · 开始作答 →
记忆管理
- 记忆作用域与可信授权上下文把记忆作用域、真实性、权限与召回顺序设计成数据契约，向量相似度只负责排序。
核心讲解 · 原理、追问与迁移案例
知识练习 · 1 道关联题 · 开始作答 → - 长期记忆的准入、来源与事实修正考察记忆准入、来源、有效期与纠错。
核心讲解 · 原理、追问与迁移案例
知识练习 · 1 道关联题 · 开始作答 → - 记忆冲突中的对象、来源与双时间考察事实版本、有效时间、来源优先级与冲突呈现。
核心讲解 · 原理、追问与迁移案例
知识练习 · 1 道关联题 · 开始作答 → - 记忆召回中的硬过滤、价值排序与因果评估考察记忆检索分层、相关性、权限、时效和反事实评测。
核心讲解 · 原理、追问与迁移案例
知识练习 · 1 道关联题 · 开始作答 → - 记忆撤销、派生清理与防复活将删除与恢复连接起来，用撤销版本、来源校验、物理清理和故障测试处理旧状态。
核心讲解 · 原理、追问与迁移案例
知识练习 · 1 道关联题 · 开始作答 →
核心方向 05
可靠执行与任务恢复
长任务会遇到进程中断、重复消息、审批等待和状态升级。理解故障窗口与状态边界，才能把恢复过程与外部业务效果一起核对。
贯穿本方向的问题：任务被打断、重放或接管后，如何继续且不丢失业务事实？
学完后，应该能够解释什么？
- 区分检查点、幂等、租约和业务完成状态
- 处理未知结果、重复批准与补偿失败
- 设计状态迁移、消息交付与多租户排队策略
- 幂等、未知结果与任务恢复用调用方和服务方两份独立数据库模拟“提交成功但响应丢失”，看清检查点的保证边界。
分层专题 · 入门、实现、排错与设计各有独立讲解及任务
知识练习 · 5 道关联题 · 开始作答 → - Outbox 的原子意图与重复投递考察双写问题、事务 Outbox、重复投递和恢复扫描。
核心讲解 · 原理、追问与迁移案例
知识练习 · 1 道关联题 · 开始作答 → - 工作流升级的结构兼容与业务兼容考察工作流版本、持久化状态 Schema 和回放兼容。
核心讲解 · 原理、追问与迁移案例
知识练习 · 1 道关联题 · 开始作答 → - Saga 中已发生事实与条件补偿考察跨服务事务、补偿前提、不可逆动作和人工介入。
核心讲解 · 原理、追问与迁移案例
知识练习 · 1 道关联题 · 开始作答 → - 多租户公平调度、资源配额与背压考察多租户排队、公平调度、背压与多维配额。
核心讲解 · 原理、追问与迁移案例
知识练习 · 1 道关联题 · 开始作答 →
核心方向 06
评测、验收与迭代
一个演示成功不足以说明系统可靠。结果、过程、测试集、重复性和人工判断需要分别设计，才能发现变化带来的改善与退化。
贯穿本方向的问题：怎样用可解释的证据判断 Agent 做对了、做稳了、值得上线？
学完后，应该能够解释什么？
- 建立结果与过程的验收条件
- 识别数据泄漏、裁判偏差和统计口径问题
- 用故障测试与回归比较不同版本
- Agent 评测的结果、约束与证据从“报告写得很好却越权读取”的反例出发，设计可核对、可诊断的验收契约。
分层专题 · 入门、实现、排错与设计各有独立讲解及任务
知识练习 · 5 道关联题 · 开始作答 → - 故障窗口与恢复不变量考察故障点、业务不变式、确定性工具替身和恢复验收。
核心讲解 · 原理、追问与迁移案例
知识练习 · 1 道关联题 · 开始作答 → - 行为配置的发布与回滚考察行为版本、回归门槛、影子流量与线上归因。
核心讲解 · 原理、追问与迁移案例
知识练习 · 1 道关联题 · 开始作答 →
核心方向 07
安全边界与生产运行
系统上线后要同时维护权限、质量、费用和运行状态。安全控制与可观测性必须落在执行边界，缓存、备用模型和流式连接也要保持同一业务契约。
贯穿本方向的问题：怎样在真实用户、故障和不可信输入下保持系统可控？
建议先理解：工具契约与外部动作、可靠执行与任务恢复、评测、验收与迭代
学完后，应该能够解释什么？
- 将审批、沙箱与最小权限落实到动作执行
- 沿运行证据定位性能、费用与质量问题
- 保持缓存、降级、断线恢复和事故处理的一致性
- 任务因果链与资源归因把业务任务、模型请求与工具调用串成可查询的链路，并用质量回归补足运行指标。
核心讲解 · 原理、追问与迁移案例
知识练习 · 1 道关联题 · 开始作答 → - 批准对象与执行时授权在工具执行边界落实权限检查，把审批绑定到不可变参数及资源版本，拒绝提示词注入扩大授权。
核心讲解 · 原理、追问与迁移案例
知识练习 · 1 道关联题 · 开始作答 → - 外部数据与执行权限的边界考察间接提示注入、数据与指令分离、工具权限和出站控制。
核心讲解 · 原理、追问与迁移案例
知识练习 · 1 道关联题 · 开始作答 → - 代码执行的资源与能力隔离考察文件、网络、进程、凭证和资源限制。
核心讲解 · 原理、追问与迁移案例
知识练习 · 1 道关联题 · 开始作答 → - 备用模型的能力与状态契约考察多模型适配、能力矩阵、失败分类和降级。
核心讲解 · 原理、追问与迁移案例
知识练习 · 1 道关联题 · 开始作答 → - 缓存复用的语义与授权等价考察不同缓存层、权限版本、时效与真实节省。
核心讲解 · 原理、追问与迁移案例
知识练习 · 1 道关联题 · 开始作答 → - 连接重建与持久任务状态考察任务与连接解耦、事件序号、重连和明确终态。
核心讲解 · 原理、追问与迁移案例
知识练习 · 1 道关联题 · 开始作答 → - 事故止血、证据与因果定位考察止损、版本归因、分层指标、隐私和复盘。
核心讲解 · 原理、追问与迁移案例
知识练习 · 1 道关联题 · 开始作答 →
核心方向 08
系统设计与工程取舍
综合场景把前面的机制放在共同约束下。理解业务目标、可接受风险和验收方式，才能选择合适的架构，并说明它在哪些条件下需要调整。
贯穿本方向的问题：如何根据任务、风险和团队条件，把这些机制组合成可交付的系统？
建议先理解：检索、证据与长期记忆、可靠执行与任务恢复、评测、验收与迭代、安全边界与生产运行
学完后，应该能够解释什么？
- 从企业任务推导架构而非堆叠组件
- 解释框架选择、客服动作、研发任务与研究发布的取舍
- 用本人负责的设计与证据说明项目经验
- 证据到发布的受控任务链把身份、知识权限、结构化工具、持久化任务与审核发布连接成可恢复的系统。
核心讲解 · 原理、追问与迁移案例
知识练习 · 1 道关联题 · 开始作答 → - 编排抽象与业务责任的匹配用状态复杂度、恢复要求、工具契约和团队约束做取舍，而不是按框架热度选择。
核心讲解 · 原理、追问与迁移案例
知识练习 · 1 道关联题 · 开始作答 → - 代码变更与验收证据绑定考察代码库理解、隔离执行、验收、回归与人工评审。
核心讲解 · 原理、追问与迁移案例
知识练习 · 1 道关联题 · 开始作答 → - 自然语言诉求与交易状态分离考察意图理解、业务规则、授权和可追溯执行。
核心讲解 · 原理、追问与迁移案例
知识练习 · 1 道关联题 · 开始作答 → - 主张、来源与验证范围的绑定考察研究计划、来源核验、证据账本、实验与发布门槛。
核心讲解 · 原理、追问与迁移案例
知识练习 · 1 道关联题 · 开始作答 → - 租户隔离与执行面的权限连续性考察控制面、执行面、数据隔离、容量和渐进交付。
核心讲解 · 原理、追问与迁移案例
知识练习 · 1 道关联题 · 开始作答 → - 项目能力的证据与条件推演考察项目复盘、本人贡献、量化证据和技术取舍。
核心讲解 · 原理、追问与迁移案例
知识练习 · 1 道关联题 · 开始作答 →
怎样读得懂，也能举一反三？
- 先用核心原理建立因果关系，再读实现与取舍。
- 沿着连续问答，看约束变化后方案怎样变化。
- 比较迁移案例，找出相同的不变量和不同的前提。
- 需要检查理解时，再做短答或小实验，记录自己的解释。