《扣子（Coze）从入门到精通》：能截图的它写满了，画不出的它留白了

2026-11-08silcano

微信读书《扣子（Coze）从入门到精通：轻松搭建AI Agent》· 79 屏（数艺社AI项目组，落款 2025 年 9 月）
逐页翻阅 79 屏 · p0006 核对书名，p0079 为末屏 · 2026-11-08
说明三点。第一，这 79 屏不是全书。前言里明确提到"第9章和第10章着重介绍在多Agents模式下，如何运用扣子的各项功能来解决实际问题"，而我读到的最后一屏停在"5.3 工作流中的节点类型与应用"这个标题上，p0079 是一张还在转圈的加载页。十章的书，我只有前五章的一半。第二，因此下文所有"全书没有"的说法，严格讲是"我读到的 79 屏里没有"，每一处我都标了页码，你可以自己核。第三，这是本界面书，图5-5 里的时间戳写着 2024-07-03 19:33，我引的每一步只对截图里的那一版界面负责。抽样逐字核对 17 处：p0002 前言局限、p0005 图1-1 导图、p0009 插件六类、p0021 编辑页六区、p0027 第三章引言、p0033 图3-8/3-9 发布流程、p0037 图3-17 WebPilot、p0044 图4-4 人设提示词、p0053 模型参数面板、p0059 多 Agent 画布、p0065 提示词示例、p0071 图5-4/5-5、p0077 图5-19 结束节点。

先说结论：这是一本把"搭一个智能体"拆成界面步骤的书。拆得很干净，你照着点，第一个 bot 能跑起来。但它拆的是能截到图的部分——注册、面板、按钮、参数框。至于截不到图的部分——什么时候该用选择器而不是循环、流程超时了怎么回滚、一个工作流该切成几个节点——这本书没有写，而且作者在前言里先说了自己写不了。

这句话不是我的推测，是他的原话。所以我给这本书的定位是：一份写得挺认真的开机指南，被摆在了"从入门到精通"的货架上。

一、79 屏的账：五分之一花在注册，工作流断在半句

先把这本"书"的物理事实摆出来。79 屏，按页面记录切分如下：

前言 p0001–p0003（3 屏）
第1章 扣子平台概览 p0004–p0010（7 屏）
第2章 扣子的访问与配置 p0011–p0025（15 屏）
第3章 扣子快速入门 p0026–p0040（15 屏）
第4章 界面、模型配置、提示词 p0041–p0067（27 屏）
第5章 工作流 p0068–p0079（12 屏，止于 5.3 标题）

三组数字值得放在一起看：第 2 章 15 屏，占 19%，讲的是注册、登录、初始设置、功能偏好；第 4 章 27 屏，占 34%，讲的是界面分区、模型参数、提示词；第 5 章 12 屏，占 15%，讲工作流，而且在"节点类型"这个标题上断了。

我不认为这是作者偷懒。恰恰相反，这个比例是界面书的结构性宿命：篇幅不是按难度分配的，是按可截屏程度分配的。

注册流程的每一步都能截：图 2-7 是账号面板，用户名那一栏填着"Wunton"，个性签名是"这个用户很懒，什么都没有留下"；初始设置里六项功能排成一列，1 人设与回复逻辑、2 插件、3 工作流、4 知识、5 开场白、6 预览与调试——每一个都对应屏幕上的一块区域，写起来毫不费力，读者也一看就懂。

但"什么时候该用选择器、什么时候该用循环"截不出来。图 5-4 那张节点面板上并排放着六个方块：工作流、问答、选择器、变量、循环、数据库。这六个词认起来只要十秒，用对要半年。你能截到"它们长什么样"，截不到"这个场景该选哪个"。

于是就有了这本书的样子：六个方块的名字讲清楚了，什么时候用哪个，留给你自己。

二、前言里那句自认，比正文十页都值钱

p0002 是全书写得最诚实的一页。它在交代完本书结构之后，主动承认了局限：

本书内容丰富，图文并茂，步骤详尽，但也有其局限性。由于扣子平台特有的节点式交互界面，在面对复杂的节点布局时，无法展示全部流程节点，这可能会对读者的理解和实践造成一定的障碍。

我把这句话读了五遍。它说的是：这本书讲工作流，但它画不出工作流。

一本教人搭 agent 的书，最核心的对象就是"流程"。流程不是一张截图能装下的东西——它有分叉、有回环、有失败分支、有并行。当节点一多，画布就溢出屏幕，一张图截不全，两张图读者接不上。作者知道这件事，于是把它写在最前面，然后给出了自己的解法：

请读者重点学习智能体相关搭建思路，举一反三，灵活应变。

"举一反三"是一个态度，不是一个方法。它把一本工具书最难的那部分，转化成了一句对读者的期待。

而讽刺的是，这本书里其实画出来了一张复杂流程——p0059 的多 Agent 画布。那张图上并排躺着三张智能体卡片：左边一张叫"询问小报"，做的事是问题改写；中间一张是 Agent 选择器，说明写着"根据匹配度与计划，决定使用……的智能体"；右边展开的那张叫"新闻编辑毛毛"，里面挂着追问情境、模型设置、Agent 选择器、技能 YunCloud_MV_Info，以及一个已经关闭的"用户问题建议"。三张卡之间用曲线连着，还有一个"天气热点总结"挂在下游。

这张图证明作者是见过复杂流程的。他也知道该把"问题改写"和"回答"拆成两个 agent。但他把这张图当成插图放在了第 4 章，而不是当成案例放在第 5 章。它被用来展示界面，没有被用来解释设计。

这是全书最大的浪费：它手上有一个能讲两万字的例子，只用了两行图注。

三、图 4-4 是全书最好的一页，也是它自己没做到的一页

如果只让我留一页，我留 p0044。那是 4.1.2 节里的一段人设提示词，图 4-4 整屏就是它。开头是：

#角色
您就是"胖阿虎"媒体号的首席内容分析专家和助理。站在知识库的底蕴之上，您在回答用户疑问的过程中驾轻就熟。
###技能
###技能1：提示词优化
－用户输入问题时，先通过"PromptPerfect"的插件进行提示词优化，让输入的问题更准确。
###技能2：问题的解读与回答
－在与用户的互动过程中，能够细致分析用户的提问，并准确依托于知识库资源进行回答。
###技能3：处理未知情况
－在遇到答案无法从知识库中找到，且通过网页搜索也无法获取相关信息的问题时，坦诚回复"我深感抱歉，针对您的问题，我暂时无法提供答案。不过，我可以为你检索网络信息，如果需要，请继续提出您的问题。"
－在表述完上面这一句之后，如果用户继续提问，才查阅各类网页资料寻找信息进行回答。
###技能4：注明信息来源
－无论是文档还是视频等资料，全部回答都要注明具体的来源地址，供URL链接，以便查证。

这段东西好在哪，我要说清楚。

第一，技能 3 把"不知道"做成了一条可执行的分支。大多数 agent 教程写人设，写到"你是一个专业的、友好的助手"就结束了。这一段不是：它给了一句逐字可复述的拒绝话术，还规定了触发条件（知识库找不到 + 网页搜索也搜不到），并且规定了二次触发条件——只有在用户继续追问之后，才去查网页。这是一个 if-else，写在自然语言里。

第二，技能 4 把"可核查"写进了人设。每个回答都要带来源 URL。这不是格式要求，是责任要求：它逼着模型在生成之前先想"我这句话是从哪来的"。一个 agent 有没有这条，用起来的信任度差一个档。

这两条，我在近两年读过的同类书里见得不多。多的是"角色+能力+语气"三件套，少的是"不知道怎么办"和"说完了怎么证明"。

但也是这一页，暴露了这本书方法上的问题。

技能 1 的顺序是反的。它要求模型在回答之前，先调 PromptPerfect 把用户的问题改写一遍，然后回答改写后的问题。这在工程上叫"查询重写"，本身是个正经技术，好处是补全上下文、消歧义。但它的代价是：如果用户一开始就问偏了，你答的是"你以为他想问的"。医生不会先把病人的主诉改写成教科书上的病名再回答，因为改写的那一刻，鉴别诊断的信息就丢了。

而且技能 1 和技能 2 在文本里是并列的（都是 ###技能），模型并不知道该先跑哪个。写提示词的人心里有顺序，读提示词的人（模型）没有。

还有一处用词。p0044 第二行原文是"站在知识库的底蕴之上"。"底蕴"指的是底子、涵养，这里要说的显然是"底座"。一个字，说明这段提示词是从某处搬来改的，没通读。这件事不算大，但它跟这一段其他地方的精细（拒绝话术逐字复述、触发条件两级）放在一起，很像两种来源：骨架是搬的，血肉是自己加的。

四、参数那一屏：纪律对了，判据是空的

p0053 是 4.2 节，模型配置。它用 Moonshot（32K）做示例，给了一张完整的参数面板：生成多样性分四档——精确模式、平衡模式、创意模式、自定义；下面的高级设置里，生成随机性 0.1、Top P 1、重复语句惩罚 0、重复主题惩罚 0；再下面输入输出设置：携带上下文轮数 3、最大回复长度 1024、输出格式"文本"。

紧挨着面板有一段话，我认为是这本书方法论的第二个亮点：

在调整参数时，建议不要同时修改多个相关参数，以便更准确地评估每项调整的效果。

一句话讲对了实验设计的核心：控制变量。随机性和 Top P 是一对强相关的参数（都在控制分布的尖锐程度），一起改，你永远不知道效果是谁带来的。这句话值一整节。

但它的下一句就断了。书里没有说：改完之后，拿什么判断"效果更准"？

0.1 的随机性，相对什么而言是好的？如果你的 agent 干的是客服问答，0.1 是对的，你要它稳定；如果干的是文案，0.1 会让它每一版都像同一版。书里把"精确/平衡/创意"三档摆出来，等于把判断交回给读者，可读者恰恰是来看判断的。

这里其实有一个很便宜的做法，几十个字就能写完，书里没有写：拿十条你自己真会问的问题，每次只改一个参数，把十组答案存下来，逐条对比。这十条就是你的最小评测集，二十分钟能建完。有了它，"0.1 好不好"就从感觉问题变成了比较问题。

另外还有一处默认值和示例任务打架。同一章 4.3 节，p0065 的示例是"初始提示词为'写一篇关于远程工作的博客文章。'"，然后给了一大段生成结果。可"最大回复长度"的默认值是 1024。1024 个 token 按中文算大概七八百字，一篇博客的骨架都不够。书里一边教你把默认值留着，一边给你一个默认值撑不住的例子。这两件事中间应该有一句话，没有。

五、图 1-1 画了一张它不打算兑现的图

p0005 是 1.1 节"走进扣子平台"。正文只有三行，剩下大半屏是图 1-1，一张思维导图，跨了两屏（p0005 到 p0006）才显示完。

这张导图的主干是"扣子"，分五支：Agent 技术概念、扣子平台介绍、扣子平台用途、扣子平台使用方法、扣子平台优势。其中"用途"这一支列了三项：

自动化任务：日程管理、信息查询等。
提供个性化服务。
交互体验：自然语言交流。

我去 79 屏里找"日程管理"。

没有。一屏都没有。79 屏里唯一一条"信息查询"的实证，是 p0037 图 3-18：用户在预览框里打"今天的科技新闻有哪些"，bot 回一句"正在调用 WebPilot"，然后给出结果。这是全书的第一次成功演示，也是唯一一次。

三项用途，兑现一项。导图是承诺，正文是交付，中间差了两次。

更值得说的是"优势"那一支。它写：易用性——无须具备编程技能。这句话在 1.1 节是对的：扣子的注册、模板、发布，确实不需要写代码。但翻到第 5 章，图 5-19 的"结束"节点面板上，你要选"回答模式"（返回变量，还是由 Bot 生成回答），要给输出变量 output 指定"引用"来源，要在弹窗里一层层点到"开始 / 大模型 / output"；图 5-18 给的是节点的输入参数 query，类型 String；步骤 6 还要回到"大模型"节点里写提示词，把角色设成"小红书文案大师"。

"变量"、"引用"、"输出类型"、"上下文传参"——这套词汇，一点都不比编程简单。它只是换了一种写法：编程是打字，工作流是连线。连线连错了，报错信息比编译器还难读，而且没有 stack trace。

"无须编程"这四个字，是这本书里我最想改的一处。它没有骗人，但它给了一个错误的期待：让人以为自己省掉的是学习成本，其实省掉的只是语法，数据结构、控制流、错误处理，一样都没省。

六、截图停在 2024 年 7 月，落款写着 2025 年 9 月

p0071 是 5.2 节，讲工作流的复制。上半屏是图 5-4 的节点面板（工作流、问答、选择器、变量、循环、数据库，六个方块，带加号），下半屏是图 5-5，工作流列表：

core_flow　｜　状态：未发布　｜　2024-07-03 19:33　｜　复制 / 删除

再看 p0029 的图 3-3，主页顶部横幅挂着"DeepSeek-V3 升级版模型已上线"。DeepSeek-V3 是 2024 年 12 月底发布的事。

这本书的落款是"数艺社AI项目组 2025年9月"（p0002 末屏）。而它引用的界面截图，至少有一张是 2024 年 7 月的。

我不认为这是刻意隐瞒。界面书的截图往往来自作者自己积攒的素材库，写到哪一节就从库里捞一张。但这件事对读者的影响是实打实的：2024 年下半年到 2025 年，扣子的发布渠道、商店、模型列表都改过。你按图 3-9 去找"选择发布平台"，可能会发现那一栏的选项已经不是"扣子商店 / 微信"两个了。

前言其实打过预防针——"随着平台不断更新，界面和功能可能会有一些变化"。但这句话和"我的截图是去年的"，是两个完全不同的事。前者说"未来会变"，后者说"你看的已经是过去"。读者有权知道第二条。

一本界面书，最该有的其实不是更多截图，而是一页"找不到按钮时的三条退路"：去设置里搜关键词、看平台更新日志、去官方社区搜报错原文。这三条能救活一本书的保鲜期。这本书没有这一页。

七、它的短板

短板一：十章只给了五章半。前言提到第 9、10 章讲多 Agents 模式，而我读到的最后一屏停在 5.3 的标题上，p0079 是一张加载页。工作流这一章真正难的部分——节点类型、分支条件、错误处理——全部在断点之后。我评的是前半本，后半本我没资格说。

短板二：五分之一篇幅花在注册。第 2 章 15 屏，讲注册、登录、账号管理、初始设置、功能偏好。图 2-7 里那两行"Wunton"和"这个用户很懒，什么都没有留下"，占了一整屏。这些内容在平台自己的引导页里就有，而且永远是新的。把书的五分之一押在"哪都能查到、且三个月就会变"的东西上，是选材的问题。

短板三：没有一个数字是钱。79 屏里，积分、调用量、模型单价、免费额度——零字。一个要跑工作流的系统，成本是它的第一性问题：一次工作流跑几个大模型节点、一个节点多少 token、免费额度够跑几天。这些不比"面板长什么样"次要。这条缺失，在我读到的每一屏上都成立。

短板四：没有失败处置。插件调用失败怎么办？工作流超时怎么回滚？发布被平台拒了怎么改？三种情况，79 屏里一个字都没有。这本书的每一个示例都是一次成功：图 3-18 一次就调出了 WebPilot，图 5-19 一次就把 output 接上了。而真实世界里，第一次跑工作流的人有八成会卡在"某个节点的引用选不到"上。书里教的全是通路，没教断路。

短板五：覆盖率我得说清楚。79 屏里我逐字核对了 17 屏，21.5%。这个比例不算低，但这 17 屏分布在前五章的每一个位置——第 1 章的功能概览、第 2 章的账号、第 3 章的发布、第 4 章的人设与参数、第 5 章的节点。如果连这些位置都在讲"怎么做成"，那"不讲做不成"这个判断就站得住。至于第 6 到 10 章有没有补上，我不知道，也不猜。

说完短板，说句公道话。这本的骨架是清楚的：一章一个动作，从"什么是智能体"到"发布到微信"，路径没有断。图 4-4 那段人设提示词，四个技能里有两个（拒答话术、来源标注）是真正干过活的人才写得出来的。p0053 那句"别同时改多个参数"，一句话顶得上一整节方法论。它把"第一次成功"这条路铺得很平。

它缺的是第二段：第一次跑通之后，你怎么知道它跑对了。

这本书适合谁？适合"听说过 agent、想用一个下午搭出第一个能发到微信里的 bot"的人。它会把你按在屏幕前，一步一步点过去，中间不跳步。

不适合谁？不适合"已经跑通了、现在开始担心它半夜跑挂"的人。那种需求要的是一张运维清单：失败重试几次、超时上限多少、失败通知发到哪、一个月成本上限、账号怎么隔离。这五样，这本书一样都没给——不是它写得不好，是它压根没打算写。

最后一句："从入门到精通"这个书名，入门的部分它做到了；精通的部分，它在前言里就先交还给了读者——而真正区分入门与精通的，从来不是会点哪个按钮，是知道按钮点下去之后，哪一步会错。