9.3 面向工作流的提示词设计方法论

《扣子编程从零开始搭建智能体 卢欣欣 清华大学出版社》【摘要 书评 试读】- 京东图书《扣子编程从零开始搭建智能体》全书案例持续更新-CSDN博客第7章曾提出面向Agent的提示词五要素模型——角色、能力、数据源、关键约束、输出格式。这一模型对单Agent设计而言基本足够但对多节点工作流而言并不完整。工作流的提示词不仅要描述做什么还要描述在什么节点做、用什么输入、产出什么输出、与下游如何衔接。本节以笔者发给扣子编程的原始提示词为例提炼面向工作流的提示词设计方法论。9.3.1 从一段完整的工作流提示词说起本章的原始提示词较长这里首先摘录其中的关键骨架请帮我搭建一个「行业热点捕捉图文内容生成」工作流。工作流目标用户输入一个行业关键词系统自动完成热点搜索、趋势判断、内容定调、图文生成最终输出一篇可直接发布的行业热点图文内容并生成配图。工作流结构请按以下节点设计1.开始节点输入字段keyword/platform/audience/...2.新闻搜索节点能力联网搜索3.热点定调节点能力大语言模型4.内容模式路由节点根据content_mode路由5A.深度解读节点重磅模式5B.盘点汇总节点日常模式6.文章生成节点7.图片提示词规划节点8.图片生成节点能力生图模型9.结束节点这段提示词与第7章的提示词最大的差别在于第7章的提示词只描述了这个Agent应该具备什么能力而本章的提示词同时描述了这些能力应该被组织成哪些节点、节点之间如何衔接。这种差别背后是六个关键决策点。完整提示词如图8-2所示。图9-2 原始提示词页面9.3.2 决策点一先描述目标再描述结构提示词的首段写的是工作流目标用户输入一个行业关键词系统自动完成……最终输出一篇可直接发布的行业热点图文内容。这一句话决定了整个工作流的成功标准——衡量工作流是否成功唯一标准就是用户能否拿到一篇可直接发布的图文内容。把目标置于结构之前是面向工作流提示词的第一原则。如果一开始就给出节点结构扣子编程会被动地按照节点结构搭建但很难在节点之间做出全局优化。例如如果它知道终极目标是可直接发布的图文它会主动在文章生成节点强调话题标签8~12 个、适合封面的短标题3个这些发布必备元素反之它就只会输出一段无标签、无短标题的纯正文。目标导向是工作流的灵魂。9.3.3 决策点二节点输入输出的契约化定义提示词中对每个节点都做了“输入字段—任务描述—输出变量”的结构化定义。例如新闻搜索节点输入是keyword任务是搜索7天内的新闻输出是news_list热点定调节点输入是news_list任务是判断热点角度输出是topic_direction、content_tone、content_mode、key_points四个字段。这种契约化定义带来两个工程收益。第一扣子编程在生成节点代码时可以直接以输入输出字段为依据自动构造Pydantic模型这意味着每个节点都有独立的Input/Output类型定义。第二整条流水线的数据流变得可证明——只要相邻节点的输出字段与输入字段对得上流水线就一定能跑通。这是单Agent提示词所不具备的可证明性。9.3.4 决策点三分支与路由的显式化第4个节点内容模式路由的描述非常关键如果出现重大政策、重大技术突破、头部企业重大事件、行业拐点、强争议事件则进入重磅模式如果只是多个中等热度信息、行业动态汇总、常规更新则进入日常模式。这段描述把分支判断条件显式化、可解释化。在工作流提示词中凡是涉及条件分支的地方都必须把判断条件以可枚举、可枚举完的方式列出。模糊地说根据热点重要性判断是远远不够的必须明确写出重磅模式与日常模式分别对应哪些事件类型。这一原则在第7章的Agent提示词中并不重要因为Agent可以自由发挥但在工作流中模糊的分支条件会直接导致两条分支被错误触发。9.3.5 决策点四模型能力与外部能力的混合编排第2个节点新闻搜索和第8个节点图片生成使用的是外部工具能力联网搜索 SDK、生图模型SDK其余6个节点使用的是大语言模型能力。提示词通过明确能力联网搜索、大语言模型、生图模型三种标签告诉扣子编程AI在每个节点应当挂载何种类型的工具。这种混合编排是工作流相对于单Agent的一项核心优势单Agent中所有外部能力都要被挂载给同一个大模型实例模型在调用工具时容易出现忘了调用、调错参数、在不该调用时调用三种问题而工作流中外部能力被绑定到特定节点上调用时机由节点结构而非模型决定可靠性显著提升。9.3.6 决策点五终端输出的可发布性约束文章生成节点的提示词中特意强调了标题要有传播感但不能夸大、开头3秒抓住读者、内容适合小红书/公众号/视频号图文发布、不要编造事实、对不确定信息要标注仍需观察、结尾给出行动建议或思考问题6条约束。这些约束并非通用写作要求而是可发布性的具体落地——它们直接对应了主流内容平台的算法偏好与监管红线。可发布性约束是面向终端用户的工作流特有的提示词维度。如果工作流的输出是给下游系统消费例如生成SQL给数据库执行就不需要考虑可发布性但只要输出最终面向人类阅读、面向公开传播就必须把平台合规、读者体验、内容真实性的约束前置写入提示词。9.3.7 决策点六图像生成的视觉约束第7个节点图片提示词规划专门规定了视觉干净、商业感、科技感、信息图风格、不出现真实品牌Logo、不出现夸张虚假数据、中文平台友好这些视觉约束。视觉约束的前置声明规避了三类高风险问题品牌侵权自动生成时混入真实 Logo、数据失真生图模型偏爱夸张视觉效果、文化误读默认西方风格的UI在中文平台显得突兀。在工程实践中每一类风险都曾让一些AI生成的内容因合规问题被平台下架。提示词里的这四行约束相当于为工作流买了一份廉价但有效的保险。