智能体设计指南：教会你写提示词，没教会你设计系统

2026-11-13silcano

微信读书《智能体设计指南：成为提示词高手和AI Agent设计师》（云中江树、王照华、伊丽琦、李继刚 著，机械工业出版社 2025-03，ISBN 9787111775843）· 逐页翻阅 793 屏 · 抓取标记 reached_end=True（end_reason=last_page，书尾落在"文后"页）· 阅读器共记录 88 个章块，十二章。
抽样说明：这本书分两部分，第一部分讲提示词，第二部分讲 Agent 设计，所以我按两条线抽读：p0001 版权页（核对作者与出版社）、p0006 自序（作者自述写作初衷，这段决定了全书定位）、p0112 结构化提示词拆解、p0171 结构化提示词与 AI Agent、p0250 四·一 工作原理、p0277 四种设计模式之基本反思、p0493 测试方法、p0640 扣子短篇小说案例、p0760 幻觉一节。
章屏数按阅读器顶部章标签切分（88 个章块，章级为主，个别章内有小节标签）。所有引文与数字只来自上述页面；关于"案例会随平台改版失效""测试章只是一张名词表""设计模式一章是文献综述"这类判断，是我的核查意见，不是书里的原话。

793 屏，十二章，88 个章块。这是我在这个系列里读到的屏数最多的一本书。

先说结论：它有 165 屏是真的好东西，剩下 600 多屏是另一个东西——一份写得很客气的平台操作手册。

这两件事被装进了一个书名里，叫"智能体设计指南"。于是问题就来了：一个读者冲着"设计"两个字买回去，读到第五章会发现自己在学怎么点按钮；一个读者其实只想搭个智能体，他会在第一章那 81 屏提示词方法论里绕不出来。

不是书不好。是它对自己是谁，说得不够清楚。

一、先搞清楚这本书是谁写的

这一点很关键，很多人读完全书都未必意识到：这本书不是一个作者写的，是一个社区写的。

自序里，作者说得很直白：他们团队"结合多年的 AI 应用经验和对大语言模型特性的深入理解，提出了结构化提示词方法论，并建立了一个蓬勃发展的 AI 提示词交流社区"。后面还有一句：他们构建的知识库"在整个飞书同类社区中长居前三，更是吸引了数十万人次的访问"。

这段自述解释了这本书的全部气质。

社区作品的优点是接地气：它知道普通人卡在哪，知道哪些提示词写法真的有效，知道新手第一句会问什么。它的第一章从"人工智能从概念到实际应用"讲起，一路铺到"编写提示词的常见误区"，耐心到近乎啰嗦，但那种啰嗦是有对象的——它假定你昨天才注册账号。

社区作品的缺点也很一致：它天然偏向"操作"而不是"原理"。因为社区里传播的是"这样点、这样填、这样就能出结果"，而不是"这个系统的状态该怎么管、失败该怎么恢复"。人在群里问的是"为什么我的智能体不听话"，很少有人问"我的编排拓扑该用 DAG 还是动态重规划"。

于是这本书就有了一个清晰的分水岭：凡是涉及"人怎么把话说清楚"的部分，它都写得极好；凡是涉及"系统怎么保证不出错"的部分，它都退回到概念名词。

二、793 屏的账：一半是方法，一半是界面

按章统计：前置（版权、内容简介、推荐序、自序、前言）16 屏；第一部分、第二部分的分隔页 3 屏；第 1 章 提示词基础知识 81 屏；第 2 章 结构化提示词方法论 84 屏；第 3 章 全面了解 AI Agent 51 屏；第 4 章 工作原理与设计模式 77 屏；第 5 章 主流 AI Agent 设计平台 65 屏；第 6 章 设计 AI Agent 的关键组件 94 屏；第 7 章 AI Agent 设计流程 62 屏；第 8 章 基于 GPT Store 的设计 26 屏；第 9 章 基于智谱平台的设计 32 屏；第 10 章 单智能体设计 72 屏；第 11 章 多智能体系统设计 70 屏；第 12 章 局限性与缓解方法 51 屏；附录、结语、作者简介等 9 屏。

加起来 793。

这里面有两笔账要分开算。

第一笔：提示词部分 165 屏，占 20.8%。第 1 章加第 2 章，是全书唯一有体系、有递进、有自己原创贡献的部分。这一块我下面单独讲。

第二笔：平台部分 225 屏，占 28.4%。第 5 章平台导览 65 屏（国内入门级、国内进阶级、国外主要平台、选型四节），第 8 章 GPT Store 26 屏，第 9 章智谱平台 32 屏，再加上第 10、11 章里的四个界面案例 102 屏（腾讯元器翻译体 19 屏、扣子短篇小说家 37 屏、扣子活动组织专家 24 屏、扣子公文写作大师 22 屏）。

这 225 屏讲的是什么？是"在某个具体产品的某个具体界面里，点哪个按钮、填哪个框、变量名不要写错"。

第 10 章那段原话很典型：

参考图10-24配置模型、输入、提示词和输出，注意变量名不要写错，变量类型和描述要一一对应。提示词部分填写下面的内容：

这句话没有错，它是一句合格的操作指导。但它也是一句有保质期的话。图 10-23、图 10-24 那些配置界面的截图，记的是 2024 年前后的扣子。扣子改一版界面，这 37 屏就有相当一部分对不上号了。而书是 2025 年 3 月印的。

一本书的知识寿命被一个产品的 UI 迭代周期绑住了，这是结构性的风险，不是作者的失误。但它确实发生了，而且占了全书四分之一还多。

三、真正值钱的 165 屏：六种方法和一套语法

如果这本书只能留一章，我留第 1 章。81 屏，结构清清楚楚。

它把提示词方法拆成了六种基本手法，每种一节，各配例子：角色扮演法（1.5，8 屏）、细节法（1.6，6 屏）、示例法（1.7，8 屏）、推理法（1.8，7 屏）、格式法（1.9，15 屏）、迭代法（1.10，7 屏），最后一节 1.11 收在常见误区上。

这个拆法我很认。因为它不是按"技巧"分，是按你缺什么分：模型不知道你是谁，用角色扮演；模型不知道要多细，用细节；模型不知道你要的样式，用示例；模型跳步，用推理；模型输出没法用，用格式；一次不成，用迭代。

六种方法对应六种失败，这比"100 个提示词模板"有用得多。模板会过期，失败的分类不会。

还有一个细节值得说。六节里最长的是格式法，15 屏，几乎是其他几节的两倍。这个分配是对的，也是这本书里少见的、把篇幅给对了地方的一次。因为格式不是审美问题，是能不能用的问题：输出要进下游程序，就要是干净的 JSON；要有稳定字段，就要有明确的模式；要让模型不啰嗦，就得给出"只输出什么、不输出什么"的硬边界。

15 屏讲这件事，说明作者知道绝大多数"提示词不管用"的抱怨，本质是"输出没法被程序消化"。而这恰恰也是提示词和 Agent 之间那道门槛——提示词是写给人看的散文，Agent 需要的是能被解析的结构。

第 2 章接着把这六种手法收拢成一套语法，也就是结构化提示词。它的样子是这样的：

# Role：知识探索专家
## Profile
- Author：李继刚
- Version：0.8
- Language：中文
- Description：我是一个专门用于提问并解答有关特定知识点的AI角色。
## Goals

用 Markdown 的标题层级给提示词分块：角色、简介、目标、约束、技能、工作流、初始化。这套东西在 2023 年被这个社区推出来，后来成了中文区结构化提示词的通用写法之一。书里第一次把它讲全，讲清每个模块为什么存在、什么场景该加什么模块。

我得说句公道话：这 165 屏的原创性，比后面 600 多屏加起来都高。后面的内容是"别人做的产品 + 别人写的论文 + 公开的资料"，前面这部分是"我们自己实践出来的一套写法"。一本书里有这么一块，就已经值得买了。

第 2 章末尾还有两节很短但很重要的：2.6 局限性 3 屏，2.7 常见误区 5 屏。8 屏，讲结构化提示词什么时候不该用——模板化会带来僵化，模块太多会让模型抓不住重点。这种"我推的东西也有边界"的话，写的人不多。

四、它最大的问题：把"设计"写成了"操作"

第 7 章叫"AI Agent 设计流程"，62 屏，六节：需求分析、提示词设计、测试方法、版本迭代、用户反馈、后续搭建。

这个流程本身没错，是一个产品的完整生命周期。但读下来你会发现，这六节的重心全在"我怎么把想法填进平台"。需求分析是"你的智能体要解决什么问题"，提示词设计是"怎么写角色设定"，后续搭建是"怎么发布"。真正属于设计的部分——状态怎么存、失败怎么补救、工具权限怎么管、多个 Agent 之间怎么分工——全书加起来不到十页。

最能说明问题的是 7.3 测试方法。它给了六类测试：单元测试、集成测试、端到端测试、压力测试、安全性测试、鲁棒性测试。每一类下面三条要点，比如安全性测试是"进行渗透测试，以检查系统的安全漏洞／测试 AI Agent 的抗恶意输入能力／验证隐私保护机制的有效性"。

这份清单没有错，它是任何一本软件测试教材的前六页。但它是名词，不是方法：没有一个指标、一个阈值、一个工具、一个例子。什么叫"抗恶意输入能力"合格？测多少条算够？失败了怎么记？全都没有。

对比一下我上个月读的另一本《AI Agent 避坑实战》：那本书第 5 章 95 屏讲调试，至少给了"幻觉级联、工具调用失败、上下文溢出"七类故障的现象和排查路径，还给了 trace 和 span 的落地方式。两本书放在一起看，差距不在勤奋程度，在作者有没有真的运维过一个上线系统。

这不是苛责。一个社区作者团队，能调动的是"我搭过多少个智能体"，不是"我扛过多少次线上事故"。前者写出来是案例集，后者写出来是工程手册。这本书是前者，书名却按后者卖。

不过话说回来，案例集对它的目标读者是对的。一个从没搭过智能体的人，需要的不是"状态该怎么持久化"，而是"先跑通一个，看见它能干什么"。这本书的四个界面案例，每个都从"这个智能体能解决什么问题"讲到"最后长什么样"，中间一步一步配，对零基础的人是友好的。我批评它不像设计书，但它作为一本入门实操书，完成度是够的。

真正的问题是：入门之后没有第二本书接着。它把你领进门，然后告诉你门里就是这些——十二个平台案例、一批提示词模板、一章局限说明。而门外真正的工程问题，从这一本往后，得自己去找。

五、三个具体的硬伤

除了结构性的错位，还有三处我读的时候真的停了笔。

第一处：4.1 讲工作原理，39 屏，例子全不对题。这一节讲 Agent 怎么做决策，讲到要考虑成功概率、资源消耗、时间成本，要选最优行动方案，涉及优化算法和决策理论，要考虑多目标优化——然后举例：自动驾驶系统要同时考虑安全性、效率、舒适度，这需要多目标优化算法，如帕累托最优；天气预报系统要根据不完全的气象数据做预测，这涉及概率决策理论、模糊逻辑。

自动驾驶、天气预报、投资组合。这三个例子在 2015 年的人工智能教材里就有，它们跟大语言模型驱动的 Agent 几乎没有关系。一个 LLM Agent 真正要做的决策是"这一步该调哪个工具"、"结果不对该重试还是该问人"、"上下文快满了该丢哪段"，这些它一句没讲。

39 屏，占全书 4.9%，是讲"原理"的篇幅里最长的一段。它讲的却是另一类系统的原理。

第二处：4.2 四种设计模式，35 屏，本质是文献综述。图 4-10 叫"基本反思设计模式"，画的是一个循环：模型先给出初步响应，然后自我评估——点评、打分、记录，再反射回来修正，循环 N 次。步骤拆解是：任务定义、初始生成、自我反馈。

这套东西的出处是 2023 年那篇 Reflexion 论文，以及更早的 Self-Refine。书里把它画成图、拆成步骤，讲得清楚，但没有一个字提到"我们试过，在什么任务上提升了多少"，也没提这个模式的已知缺陷——反思会自我强化，模型对自己的错误越看越自信。

四种模式都是这个写法。它们是对的，但它们不是作者的发现，是作者转述的发现。

第三处：第 6 章"关键组件"94 屏，全书第二长的一章，讲的是提示词、插件、知识库、记忆系统、工作流。这五样确实是组件的名字，但五节的篇幅分配很奇怪：工作流 35 屏，知识库 21 屏，插件 20 屏，提示词 11 屏，记忆系统只有 7 屏。

记忆 7 屏。一个 Agent 之所以是 Agent 而不是一个对话框，很大程度上就靠记忆。而全书给记忆的篇幅，是给工作流的五分之一。为什么？因为工作流在平台上有可视化画布，能截图；记忆在平台上只有一个"开启/关闭"的开关，没得截。

篇幅跟着界面走，而不是跟着重要性走——这可能是这本书最诚实的自我暴露。

第四处：3.3 的 Agent 分类，用的还是 1995 年那套。15 屏，把 Agent 分成简单反射型、基于模型的反射型、基于目标的、基于效用的、学习型。图 3-6 画的是"基于模型的反射型 Agent 的模块组成"：感知—记忆—预定义规则—行动。举的例子是智能交通信号灯——根据当前路口车流量调整灯时长，还会考虑过去一段时间的交通模式预判拥堵；还有穿过迷宫的下棋机器人。

这套分类法出自 Russell 与 Norvig 那本经典教材，1995 年的东西，讲的是符号 AI 时代的智能体。它本身没错，是正统。但问题在于：这本书叫"智能体设计指南"，讲的是 2024 年的大模型 Agent，却从头到尾没有一句话交代这两者的关系。

一个读者读完这 15 屏，会以为 LLM Agent 就是"基于目标的 Agent"加了张嘴。实际上它是另一条技术路线：不靠预定义规则，靠概率生成；不靠显式状态机，靠上下文窗口；它的"目标"常常是自然语言写的一句模糊要求，连"效用量化"都无从谈起。

用旧框架解释新对象，最危险的地方不是错，是让人以为自己懂了。

六、它其实很诚实，这一点要认

批评说完，得把另一半也说了，否则不公平。

这本书第 12 章，51 屏，标题叫"AI Agent 的局限性及其缓解方法"。分五节：多模态 AI（8 屏）、智能体无法准确识别数字（8 屏）、智能体难以解决数学问题（7 屏）、智能体会产生幻觉（15 屏）、其他常见问题（12 屏）。

这个安排很不像一本"教你成功"的书。多数同类书会把局限塞进最后一节，两三页带过。这本书给了整整一章，而且给了最长的 15 屏在幻觉上。

它讲幻觉的方式也很朴素。没有堆术语，讲了一个比喻：你有个朋友从没去过任何餐厅，他了解餐厅的唯一途径是听别人描述。有一天你让他推荐一家高档餐厅，他很认真地开始推理——大家谈高档餐厅时会提到水晶吊灯、银质餐具、意面、牛排，于是他拼起来，给你推荐了一家"星光餐厅"，说那里的松露意面和无菌牛排非常美味。听起来很不错，但他从没去过。

AI 幻觉的背后，是人工智能模型在生成文本时，没有基于对现实世界的理解或事实的核实，而是基于其所训练的庞大数据集进行推测和组合。

这段话准确，而且它敢说"没有基于对现实世界的理解"。有些书到这里会绕，说"模型可能存在事实性偏差"，绕开"它不知道"这件事。这本没绕。

同样诚实的还有自序里那句定位：本书的写作初衷是回答"普通人如何用好 AI"这个问题。

但诚实不等于准确。第 12 章里有一节我读得最不舒服，12.2 "智能体无法准确识别数字"，8 屏。它归了三个原因：模型的视觉能力不足，看不懂细微的表情变化和情绪区别；环境因素，光照条件、噪声干扰、拍摄角度会影响数字图像质量；算法的局限性，当前多数智能体基于 CNN、RNN 这类深度学习算法，识别数字的形状和模式很好，做精确计算和逻辑推理就差。缓解方法是增加数据量、做数据增强，比如 RandAugment 的几何变换和旋转变换。

读到这里我愣了一下：这一节讲的是"从照片里认出数字"，而大模型算错数，原因是分词和浮点表示，跟摄像头、光照、拍摄角度没有关系。12.2 全节八屏，只有一句话顺带提到"低精度浮点数在 AI 训练和推理过程中也会导致数字分辨能力有限"，剩下的篇幅都在讲图像识别。

把"读图时认错"和"推理时算错"混成一个话题，然后拿数据增强去解，这个方案是给错的人开的药。12.3 "智能体难以解决数学问题"7 屏，是同一个毛病的延续。

我说这一节，不是要挑刺。是因为它恰好暴露了这本书的结构性局限：它擅长讲"人怎么和工具打交道"，不擅长讲"工具内部发生了什么"。一旦话题滑进模型内部，它就退回教科书的通用解释，而通用解释往往对不上具体问题。

如果读者记得这句话，全书 793 屏都是合理的——它本来就是写给普通人的。可惜大多数人是先看到书名才看到自序的。

七、它的短板

按这本书自己的框架，我给四条。

第一，时效性风险最大的一条：28.4% 的篇幅绑在别人产品的界面上。第 5、8、9 章加上四个界面案例，225 屏，记的是 2024 年几个平台的菜单结构。这类内容有一个残酷的特点：写的时候越细，过期的时候越没用。37 屏讲扣子的短篇小说工作流，真要照着做，直接打开扣子看官方文档比翻书快，而且是当前版本。

第二，缺少一条可验证的判据。全书讲了很多"应该怎么做"，几乎没有一处"做完之后怎么知道做对了"。测试章只有名词，案例章只有截图后的一句"效果如下"。我翻完全书，没有找到一个准确率、一个响应时间、一个成本数字。一本讲设计的书，没有验收标准，读者就只能靠感觉判断自己有没有学会。

第三，重复度高。同一个提示词模板在第一章、第二章、第十章反复出现，同一个"角色设定"写法在不同案例里各贴一遍全文。88 个章块的结构本来就很碎，每一块自成起讫，跳读友好、通读损耗。我读到第 9 章时已经改成只看每节开头两段。

第四，多智能体那一章（70 屏）撑不起来。11.1 什么是多智能体系统只给了 4 屏，11.2 工作原理 8 屏，11.3 设计原则 3 屏，11.4 常用设计模式 3 屏——加起来 18 屏讲理论，然后 46 屏讲两个扣子案例（活动组织专家 24 屏、公文写作大师 22 屏）。理论部分薄到像提纲，案例部分厚到像教程。而多智能体真正难的地方——角色怎么划分、冲突怎么裁决、消息怎么传递、失败了谁来兜——18 屏里一句都没有。

八、怎么读：两处深读，其余当手册

我给三个建议。

要学提示词，把第 1 章 81 屏老老实实读完，一节不跳。这是全书唯一有递进结构的部分：六种方法对应六种失败，读完你会有一套自己的诊断顺序——输出太泛，加细节；风格不对，加示例；逻辑跳步，加推理；格式不稳，加约束；一次不成，改结构再来。这套顺序比记住一百个模板值钱。

要学结构化提示词，读 2.1 到 2.5 那 62 屏，然后去抄 2.5 的经典模板。作者给的是完整可用文本，不是提纲，这一点很难得。抄的时候只改三个地方：角色、目标、约束，别动骨架。

其余部分当查询手册用，不要通读。想知道某个平台怎么选，翻 5.4 那 13 屏；想知道插件和知识库怎么配，翻第 6 章的对应小节；想搭第一个智能体，直接跳到第 10 章挑一个案例照做一遍。等你真的动手了，再回头看第 12 章——那一章在你踩过坑之后读，感受会完全不同。

最后说一句我的整体判断。

这本书让我想起很多年前那些"XX 从入门到精通"。它们的共同点是：教你用工具，不教你造工具。这没有错，市场需要这样的书，绝大多数人也确实只需要会用。问题是，当工具本身每半年换一次壳的时候，"从入门到精通"这件事就得每半年重来一次。

而真正不会过期的部分——怎么把话说清楚、怎么判断一个输出好不好、怎么知道自己错了——这本书给了 165 屏，给得很好。剩下的 600 多屏，是一次诚实的、认真的、但注定会过期的记录。

一句话收尾：它把一个社区五年攒下的说话手艺装订成册，却把一个产品的使用说明当成了设计方法论。

---

阅读记录｜微信读书《智能体设计指南：成为提示词高手和AI Agent设计师》，云中江树、王照华、伊丽琦、李继刚 著，机械工业出版社 2025 年 3 月第 1 版，ISBN 9787111775843。逐页截图 793 屏，88 个章块，十二章，抓取耗时 1075.6 秒，读到书尾（end_reason=last_page）。本文引文出自 p0006、p0112、p0171、p0250、p0277、p0493、p0640、p0760 等页；篇幅统计按阅读器章标签逐页归属计算；判断与批评为本人观点。