《AI Agent 高级编程》目录
《AI Agent 高级编程》全书导航页：说明本卷定位与前置知识、五到六周学习节奏与三条阅读路径，交代「用框架重写 ResearchCopilot」的主线、与卷一、卷二的关系及「与既有 AI 专题的分工」，并按五个部分列出 11 章 33 节的完整章节索引，另含常见问题速查表。
category
Agent
共 150 篇文章。
《AI Agent 高级编程》11.3 全景回顾：从零到框架的完整路径与展望
三卷本收官：把卷一的 minagent（从零手写）、卷二的 ResearchCopilot（工程化服务）与卷三的框架重写与生产化串成一条线，用一张「能力 × 卷 × 视角」总表看清各自的位置与取舍，回顾卷三 11 章各自解决了什么，并给出从零到框架的完整路径与下一步展望。
《AI Agent 高级编程》11.2 真实 API 冒烟：假模型 vs 真模型量化差距
全卷都在用假模型跑确定性对照，但「假模型全绿」到底能不能代表上线质量？本节给出一套可运行的对照 harness：同评测集、同评分器，先真跑出假模型列的数字，再把真模型列留空、显式标注「需用户授权后运行 --real 才填」，并逐条列出假模型量不出的五件事及其度量方法。
《AI Agent 高级编程》11.1 平台化：Agent 注册、版本与配额
把单实例 ResearchCopilot 推进成多 Agent 平台：用一份可运行的注册表实现 Agent 的注册、发现与 semver 版本路由，再用配额账本在调用前完成扣减与拒绝。附真跑输出，并给出「平台替你做了什么、你又让渡了什么」的对照表。
《AI Agent 工程实战》目录
《AI Agent 工程实战》全书导航页：说明本卷定位、读者画像与前置知识、六到八周学习节奏与三条阅读路径，交代贯穿项目 ResearchCopilot 与「与既有 AI 专题的分工」，并按六个部分列出 18 章 54 节的完整章节索引，另含常见问题速查表与通往卷三的路线。
《AI Agent 工程实战》18.3 上线、观察与迭代 + 真实 API 端到端冒烟（可选）
收官节分三块收束全卷：上线检查单、上线后的观察节奏（第 1 小时/第 1 天/第 1 周各看什么、何时回滚）、把线上失败与成本异常回流成评测样本与优化项的迭代闭环。再给出可选的真实 API 端到端冒烟流程与代码，明确标注需自备密钥、本机未执行，并用假模型跑同一脚本做离线等价验证，最后给全卷回顾与通往卷三的路线。
《AI Agent 工程实战》18.2 故障演练：模型超时/DB 宕机/队列积压
设计三个受控故障演练：模型超时（假模型注入延迟，验证超时止损与降级链）、DB 不可达（连不存在的端口，验证 readiness 摘流量与明确报错）、队列积压（往队列塞远超消费能力的任务，验证背压与告警）。每个都写清注入方式、预期表现、观测点、恢复动作与复盘问题，并逐个在本机真跑贴出日志、耗时与队列深度，最后给出复盘模板表。
《AI Agent 工程实战》18.1 容量与架构评审清单
收官章先把全卷散落的工程决策收成一份可执行清单：接口与契约、数据与一致性、并发与资源、可观测与告警、安全与合规五组，每条给出可判定的通过标准。再给一套容量估算方法，用一个真跑的脚本代入具体参数，算出每日 token、模型成本、DB 增速、Redis 内存与 worker 数。
《AI Agent 开发入门》附录 D.常见错误与 FAQ
本附录按「症状 / 原因 / 处置」整理本书最常撞上的问题：ERR_UNSUPPORTED_TYPESCRIPT_SYNTAX 参数属性、pip 换中科大源、api.openai.com 不可达、假模型脚本耗尽、工具异常回灌、YAML 里 @ 开头加引号、tags 含 # 被 urlize 吃掉、hugo --quiet 掩盖 REF_NOT_FOUND、单段站内链接是死链等十余条。
《AI Agent 开发入门》附录 C.环境与离线复现速查
本附录固定全书的环境口径：Python 3.14.6 与 Node 26.5.0 的实测版本表、用中科大源建 venv 与装依赖的步骤（清华源与阿里云源在本机不可用）、Node 26 只支持类型擦除的可擦除语法规则、离线复现的必需与可选依赖清单，以及 postgres:17-alpine 与 redis:7-alpine 的本地起法。
《AI Agent 开发入门》附录 B.FakeModel 脚本与测试夹具速查
本附录讲透 FakeModel 的脚本语法与测试夹具用法：三种脚本元素（str、ToolCall 列表、ModelResponse）的语义对照，如何脚本化工具调用收敛、注入错误、制造死循环与格式漂移，如何用 model.calls 断言调用序列，以及把真实响应录成 JSON 夹具离线重放的可运行 pytest 片段。
《AI Agent 开发入门》附录 A.minagent API 与模块速查
本附录把 minagent 的权威 API 契约压成速查表：Role、ToolCall、Message、ModelResponse、Model 协议、Step、RunResult 的字段，Tool 与 ToolRegistry 的签名，run() 与 Agent 的调用方式，以及构造 FakeModel、注册工具、跑一轮、断言轨迹的可运行片段。
《AI Agent 开发入门》目录
《AI Agent 开发入门》全书导航页：说明本卷定位、读者画像与前置知识、八到九周学习节奏与三条阅读路径，交代贯穿项目 minagent 与「与既有 AI 专题的分工」，并按六个部分列出 18 章 54 节的完整章节索引，另含序、前言、附录 A–D 与常见问题速查表，方便读者按需定位、跳读与随时查阅。
《AI Agent 开发入门》序
《AI Agent 开发入门》的序。从大模型「会聊天」到「会做事」的转折谈起，说明 Agent 工程在可靠性、可观测、成本与安全四个方向的真实难点，解释为什么本书选择「从零手写 + 假模型确定性复现」这条路线，并交代本书与站内既有 AI 专题的分工与不同起点的读者该从哪里进入。
《AI Agent 开发入门》前言
《AI Agent 开发入门》前言：说明本书的目标读者与前置知识、六部分 18 章的结构分工、每一节的组织方式，交代 Python 3.14 主线与 TypeScript 对照线的版本口径、venv 与假模型零凭据的运行方式，预告入门/实战/高级三卷结构，并说明本书与站内既有 AI 专题的分工。
《AI Agent 开发入门》18.3 回顾与路线
本节收束卷一：把 minagent 从 20 行循环长成完整模块的 18 章推进逐条盘清，讲明「从零手写」得到了什么、还差什么，预告卷二（服务化、持久化、并发、可观测、评测回归、部署）与卷三（框架重写、durable execution、computer use、A2A、Agent RL），并给出一份「学完卷一你应该能回答」的自测清单。
《AI Agent 开发入门》18.2 真实 API 冒烟（可选）
本节只讲「如何」做一次真实 API 冒烟，不真的调用：给出把 FakeModel 换成 AnthropicModel 的最小代码（密钥只从环境变量读），离线验证双向映射，说明网络、密钥与用户同意三项前提，并用一份录制的响应夹具经 RecordedModel 离线重放同一条代码路径，真跑贴出轨迹。默认离线，真实调用请自行决定。
《AI Agent 开发入门》18.1 端到端
本节把前 17 章的模块串成一条真实可跑的通路：用假模型驱动的 Agent 走完「提问→检索→工具调用→多步循环→带引用回答」，并挂上 span 追踪、成本核算与评测。给出完整 demo_e2e.py 脚本，真跑并贴出轨迹、引用校验、span 树、成本表与评测报告的完整输出。
《AI Agent 高级编程》10.3 安全纵深：注入/越权/供应链审计
提示注入、工具越权、供应链投毒——Agent 的安全面比传统应用多出一整层「把不可信文本当指令用」。本节给出攻击面 × 防护措施对照表，并真跑两个最小防线：输入侧剥离注入指令行、工具侧按收件人白名单拦截越权调用，再用审计轨迹证明每一次拦截都留痕可查。
《AI Agent 高级编程》10.2 成本与延迟治理：路由/缓存/并发 + 评测兜底
路由、缓存、并发上限、降级——成本与延迟治理的四个旋钮，任何一个拧过头都会伤质量。本节用本地假模型真跑一条完整治理链：语义缓存命中即跳过、预算耗尽自动降级到小模型、Semaphore 把在飞请求压到上限内，再用评测集证明「降级后分数会掉」，并如实说明假模型为何量不出真实成本与延迟。