AI Agent 核心知识图解
这是一套可以直接阅读的图解课：先用 15 张核心图串起 Agent 判型、工程闭环、模型 API、结构化输出、RAG、文档入库、MCP 工具、状态记忆、工作流、多智能体、可观测与成本、评估发布、安全红队和项目交付，再按三卷展开 44 个模块图谱。第一次学习按 01 到 15 阅读，复习时直接进入对应知识图。
15 张核心知识图
先分清边界，再建立 Agent 闭环
Chatbot、Workflow 与 Agent 怎么选
先按任务的不确定性、工具动作、状态跨度和风险判断系统形态，避免所有需求都硬套 Agent。
- Chatbot 适合一次问答
- Workflow 适合固定步骤
- Agent 处理动态决策
- 风险决定审批强度
路径越不确定、工具越多、状态越长，越需要 Agent；风险越高，人工边界越要前置。
进入对应章节一个 Agent 项目怎样形成工程闭环
Agent 不是一次模型调用，而是一条从目标、上下文、计划、工具执行到评估、恢复和证据的可回放链路。
- 目标先于模型选择
- 工具动作写回状态
- 失败必须可恢复
- 每轮留下验收证据
只要工具执行可能失败，就必须同时设计状态更新、重试上限、人工接手和验收证据。
进入对应章节Tool Calling 为什么必须经过权限网关
模型只能提出工具调用意图，真正执行前还要经过参数契约、风险分级、身份权限、审批、幂等和审计。
- 模型只提调用意图
- 参数先过数据契约
- 写操作需要幂等
- 高风险动作人工审批
模型不拥有执行权；应用层决定谁能在什么条件下调用什么工具，并对结果负责。
进入对应章节模型、Token、上下文与 API 请求如何协作
一次模型请求同时受输入结构、上下文窗口、输出预算、模型能力、超时重试和成本记录约束。
- 上下文窗口有硬上限
- Token 同时影响质量与成本
- 模型能力需要按任务匹配
- 超时和限流必须有兜底
模型不是无限记忆的黑盒；每次请求都要明确输入、上下文预算、输出上限、超时和成本证据。
进入对应章节结构化输出为什么必须经过校验与重试
Prompt 只表达意图，Schema 固定字段契约；模型输出必须先解析和校验，失败后才能修复、重试或转人工。
- Schema 是输出合同
- 解析成功不代表语义正确
- 重试必须携带错误原因
- 超过上限转人工或降级
JSON 看起来正确不等于业务可用；字段类型、枚举、范围和跨字段规则都要在应用层验证。
进入对应章节把知识、状态、协作和质量连起来
RAG 的离线入库与在线问答是两条链
可信 RAG 同时依赖离线资料治理和在线检索回答；只做向量库，不做权限、引用、拒答和评估，系统仍不可用。
- 入库前先治理资料
- 检索前先按权限过滤
- 重排后判断证据是否充分
- 回答必须引用或拒答
RAG 的质量上限由资料治理决定，可信度由权限过滤、引用、拒答和评估共同决定。
进入对应章节文档如何经过解析与质量门进入知识库
文档入库不是抽出文本就结束，还要识别格式与版本、选择解析器、统一结构、生成质量信号，并让失败文件可隔离、修复和重跑。
- 先识别真实格式与版本
- 统一中间格式保留版面结构
- 质量门阻断低质量内容
- 隔离文件修复后可重复入库
解析成功不等于入库合格；结构完整性、文本可读性和来源可追溯性必须同时通过质量门。
进入对应章节MCP 与 Tool Calling 如何组成工具体系
Tool Calling 让模型表达调用意图，MCP 统一能力发现、参数传输和结果返回；应用 Host 仍负责权限、审批、执行和审计。
- Tool Calling 表达模型意图
- MCP Client 管理协议连接
- Server 暴露能力清单
- 权限和审计仍留在 Host
MCP 解决接入标准化，不会自动解决安全；模型只选能力，Host 才拥有连接管理、权限判断和最终执行权。
进入对应章节State、Session、Memory 和 Checkpoint 的区别
四个概念解决不同时间尺度的问题：会话标识一次交互，状态驱动当前流程，检查点支持恢复，记忆跨会话复用。
- Session 标识交互范围
- State 驱动当前节点
- Checkpoint 用于中断恢复
- Memory 跨会话但受权限约束
不要把整段聊天都叫记忆；先明确生命周期、读写者、恢复点和权限，再决定存在哪里。
进入对应章节LangGraph 如何把 Agent 变成可控状态图
节点只做一件事，边决定下一步，State 传递事实，Checkpoint 保存进度，Interrupt 把高风险动作交给人工。
- 节点负责单一动作
- 条件边负责路由
- State 传递事实
- Interrupt 与 Checkpoint 支持人工恢复
可控工作流的关键不是节点数量，而是状态字段、路由条件、停止条件和恢复语义都明确。
进入对应章节多智能体不是多角色聊天，而是受控协作
Supervisor 按共享状态分派任务，专业 Agent 只返回结构化结果，质检节点决定继续、返工、停止或转人工。
- Supervisor 负责任务路由
- 专业 Agent 权限最小化
- 共享 State 代替自由聊天
- 质检和停止条件防止无限循环
每个 Agent 都要有输入契约、输出契约、权限和停止条件；否则角色越多，系统越不可控。
进入对应章节一次 Agent 运行怎样被追踪、计费和告警
可观测性要用同一个 trace_id 串起 Agent、模型和工具 Span，再把轨迹聚合成质量、延迟、重试与成本指标，驱动告警和降级。
- trace_id 串起完整运行
- Span 记录模型与工具细节
- 成本按任务和模型归因
- 告警触发限流降级与修复
只记最终答案无法排障和控费；每次运行都要能回答慢在哪里、错在哪里、花在哪里、由谁触发。
进入对应章节评估、回归、灰度和回滚怎样连成发布门禁
评估不是上线前跑一次分数，而是用固定样例、失败分类、阈值门禁、灰度观察和回滚条件约束每次变更。
- 评估集覆盖正常与边界样例
- 失败按类型分桶
- 门禁使用明确阈值
- 灰度和回滚条件提前定义
平均分不能代表可上线；关键失败类型必须单独设阈值，并在灰度期持续监控。
进入对应章节Prompt 注入、数据泄露与越权如何分层拦截
外部内容、检索资料、工具参数和模型输出都可能成为攻击面，需要用来源隔离、指令边界、权限网关、输出检测、审计和红队回归形成纵深防御。
- 外部内容默认不可信
- 系统指令与业务数据隔离
- 工具权限在应用层校验
- 红队失败样例进入长期回归
任何外部内容都只能作为数据，不能获得系统指令权；真正的安全边界必须在应用层强制执行并持续回归。
进入对应章节把技术能力变成可验收项目
从客户原话到可验收项目的交付链
商业项目先把客户原话翻译成范围、字段契约和验收样例，再做原型、上线和运营；证据必须贯穿每个阶段。
- 客户原话先转成业务目标
- 范围和非目标写进合同
- 验收样例先于开发
- 上线后仍需监控和复盘
真正可交付的不是一个演示页面，而是一套范围清楚、失败可解释、结果可验收、上线可运维的业务闭环。
进入对应章节按卷展开，继续深入每一个知识模块
核心图负责建立主干；模块图负责告诉你每章有哪些角色、数据、动作、边界和交付证据。
第 01 卷基础与工具14 个模块
先建立模型、Prompt、工具、状态、接口和工程基础。
第 1.1 章Agent 边界先划清目标、工具和人工接手边界，再决定一个需求是否值得使用 Agent。
第 1.2 章工程师能力地图本模块沿“岗位要求 → 能力分层 → 工程组合 → 项目证据”展开，先理解业务主线，再进入逐页实现。
第 1.3 章模型、Token 与 API本模块沿“业务请求 → 上下文预算 → 模型适配 → 响应与成本”展开，先理解业务主线，再进入逐页实现。
第 1.4 章Prompt 与结构化输出本模块沿“任务指令 → 结构化 Schema → 输出校验 → 重试与复核”展开，先理解业务主线，再进入逐页实现。
第 1.5 章第一个 Agent本模块沿“输入契约 → Agent 执行 → 状态与日志 → 验收结果”展开，先理解业务主线，再进入逐页实现。
第 1.6 章工具调用本模块沿“业务动作 → 工具契约 → 权限审批 → 执行审计”展开，先理解业务主线，再进入逐页实现。
第 1.7 章状态、记忆与会话本模块沿“会话输入 → 短期上下文 → 长期记忆 → 状态恢复”展开，先理解业务主线，再进入逐页实现。
第 1.8 章Python 工程能力本模块沿“项目结构 → 依赖配置 → 模块边界 → 测试交接”展开，先理解业务主线，再进入逐页实现。
第 1.9 章Pydantic 数据契约本模块沿“字段语义 → Schema 版本 → 跨层契约 → 失败校验”展开，先理解业务主线，再进入逐页实现。
第 1.10 章FastAPI 后端本模块沿“请求入口 → 鉴权追踪 → Agent 服务 → 工具响应”展开，先理解业务主线，再进入逐页实现。
第 1.11 章文件与数据格式本模块沿“文件入口 → 解析清洗 → 统一格式 → 质量门禁”展开，先理解业务主线，再进入逐页实现。
第 1.12 章测试、日志与配置本模块沿“评测样例 → Mock 与真实 → 结构化日志 → 回归门禁”展开，先理解业务主线，再进入逐页实现。
第 1.13 章多模型适配本模块沿“供应商配置 → 能力矩阵 → 路由适配 → 评测回滚”展开，先理解业务主线，再进入逐页实现。
第 1.14 章个人 AI 助手本模块沿“个人场景 → 能力组合 → 数据边界 → 项目雏形”展开，先理解业务主线，再进入逐页实现。
第 02 卷工程实战18 个模块
再把 RAG、MCP、工作流、权限、部署和评估连成系统。
第 2.1 章RAG 边界与架构本模块沿“企业资料 → 检索与重排 → 引用回答 → 权限评估”展开，先理解业务主线，再进入逐页实现。
第 2.2 章文档解析与入库本模块沿“原始文件 → 解析清洗 → 中间格式 → 入库版本”展开，先理解业务主线，再进入逐页实现。
第 2.3 章分块、向量与重排本模块沿“文本分块 → 向量索引 → 召回过滤 → 重排评估”展开，先理解业务主线，再进入逐页实现。
第 2.4 章向量数据库选型本模块沿“数据与过滤 → 方案比较 → 索引查询 → 运维决策”展开，先理解业务主线，再进入逐页实现。
第 2.5 章知识治理本模块沿“知识 Owner → Reviewer 审批 → 版本新鲜度 → 下线审计”展开，先理解业务主线，再进入逐页实现。
第 2.6 章MCP 工具体系本模块沿“外部能力 → 协议卡片 → 权限检查 → 工具生态”展开，先理解业务主线，再进入逐页实现。
第 2.7 章MCP Server/Client本模块沿“Client 发现 → 传输鉴权 → Server 执行 → 结果兜底”展开，先理解业务主线，再进入逐页实现。
第 2.8 章LangGraph 工作流本模块沿“State → Node → Edge → 中断恢复”展开，先理解业务主线，再进入逐页实现。
第 2.9 章多智能体协作本模块沿“Supervisor → 专职角色 → Handoff 复核 → 停止升级”展开，先理解业务主线，再进入逐页实现。
第 2.10 章AI 前端工作台本模块沿“用户会话 → 过程状态 → 引用与工具 → 人工确认”展开，先理解业务主线，再进入逐页实现。
第 2.11 章部署与环境本模块沿“浏览器入口 → Nginx 网关 → 服务与 Worker → 环境密钥”展开，先理解业务主线，再进入逐页实现。
第 2.12 章可观测性与成本本模块沿“用户请求 → Trace 与 Span → 延迟成本 → 告警复盘”展开，先理解业务主线，再进入逐页实现。
第 2.13 章安全、权限与审批本模块沿“身份与角色 → 权限策略 → 工具网关 → 审批审计”展开，先理解业务主线，再进入逐页实现。
第 2.14 章商业访谈与验收本模块沿“需求访谈 → 范围版本 → 验收样例 → 报价变更”展开，先理解业务主线，再进入逐页实现。
第 2.15 章质量与发布本模块沿“评估集 → 回归红队 → 发布门禁 → 灰度回滚”展开，先理解业务主线，再进入逐页实现。
第 2.16 章综合知识库 Agent本模块沿“资料治理 → RAG 检索 → MCP 工具 → 工作台交付”展开，先理解业务主线，再进入逐页实现。
第 2.17 章评估与回归本模块沿“评估基线 → 分层数据集 → 指标阈值 → 回归阻断”展开，先理解业务主线，再进入逐页实现。
第 2.18 章安全攻防与红队本模块沿“威胁建模 → 攻击样例 → 多层防线 → 修复复测”展开，先理解业务主线，再进入逐页实现。
第 03 卷项目交付12 个模块
最后把能力迁移到业务场景，形成可验收、可运营的项目。
第 3.1 章从需求到交付本模块沿“客户原话 → 范围与架构 → 验收报价 → 项目故事”展开，先理解业务主线，再进入逐页实现。
第 3.2 章客服与售后本模块沿“官网问答 → 风险识别 → 工单处理 → 质检验收”展开，先理解业务主线，再进入逐页实现。
第 3.3 章销售、私域与增长本模块沿“销售线索 → 标签评分 → 话术跟进 → 转化复购”展开，先理解业务主线，再进入逐页实现。
第 3.4 章内容 SEO/GEO本模块沿“选题事实 → 内容生成 → 人工审核 → SEO GEO 评估”展开，先理解业务主线，再进入逐页实现。
第 3.5 章企业知识与内训本模块沿“制度资料 → 权限知识库 → 问答培训 → 反馈更新”展开，先理解业务主线，再进入逐页实现。
第 3.6 章办公自动化与审批本模块沿“会议邮件 → 任务提取 → 审批执行 → 过程留痕”展开，先理解业务主线，再进入逐页实现。
第 3.7 章数据报表与决策本模块沿“指标口径 → 查询计算 → 报表异常 → 建议复核”展开，先理解业务主线，再进入逐页实现。
第 3.8 章财务、人事、法务与采购本模块沿“高风险资料 → 字段规则 → 人工确认 → 审计证据”展开，先理解业务主线，再进入逐页实现。
第 3.9 章教育培训本模块沿“课程资料 → 问答题库 → 学习反馈 → 教师复核”展开，先理解业务主线，再进入逐页实现。
第 3.10 章电商、本地生活与门店本模块沿“商品门店 → 问答导购 → 运营分析 → 人工处理”展开，先理解业务主线，再进入逐页实现。
第 3.11 章软件开发与代码助手本模块沿“代码库 → 检索理解 → 评审测试 → 权限证据”展开，先理解业务主线，再进入逐页实现。
第 3.12 章交付、运维与续费本模块沿“上线监控 → 培训反馈 → SLA 复盘 → 续费增购”展开，先理解业务主线，再进入逐页实现。