6.3 详细实现与核心配置（双语绘本速记单词智能体开发）

《扣子编程从零开始搭建智能体 卢欣欣 清华大学出版社》【摘要 书评 试读】- 京东图书《扣子编程从零开始搭建智能体》全书案例持续更新-CSDN博客6.3.1核心工作流的实现该工作流主要包含了大模型、循环、图像生成插件、语音生成插件等核心节点。工作流完整的全貌如图6-3所示接下来将详细拆解其搭建与配置过程。图6-3 工作流整体预览1.创建工作流在扣子编程的“资源库”页面中通过单击右上角“ 资源”按钮新建工作流。在弹出的“创建工作流”窗口中填写工作流名称为“learn_English_words”工作流描述为“根据给定单词生成一篇合适的英文短文记单词”最后单击“确认”按钮完成工作流创建如图6-4所示。图6-4 创建工作流2.配置开始节点由于生成的短文难度需要与学生的年级相匹配因此需要为该节点定义年级和单词两个输入变量。选中“开始”节点后在右侧配置对话框中设置两个String类型的输入变量。其中一个命名为 grade用于接收学生年级信息另一个命名为words用于接收用户提供的单词信息。具体配置如图6-5所示。图6-5 开始节点的配置3.生成双语短文步骤1接入大模型节点。在开始节点的下游接入一个大模型节点用于根据用户输入的年级和英文单词信息生成定制化的双语短文。步骤2绑定输入变量。选中“大模型”节点在参数配置对话框中将上游“开始”节点的grade和words变量分别引用至对应位置并修改变量默认名称实现数据流的对接。配置如图6-6所示。图6-6 生成双语短文大模型节点的输入配置步骤3编写系统提示词。在系统提示词区域输入如下指令明确大模型节点的角色、任务和具体要求。你是专业中小学英语词汇辅导老师需要根据用户输入的英文单词和学生年级创作双语助记短文英文中文逐句对应翻译。要求1.需要用上所有提供的单词英文短文纯英文、无中文中文翻译逐句对应、准确简洁贴合学生年级理解水平。2.词汇、句式、篇幅严格匹配对应{{grade}}课标低年级以短句为主高年级可适当增加简单从句内容科学合规符合对应学段认知水平。3.目标单词在英文短文中需要加粗方便学生识别背诵中文翻译无需加粗保持流畅。4.短文主题贴近学生生活校园、家庭、小动物等易懂易联想避免陌生场景。5.短文语句连贯、情节符合生活常理上下文逻辑自然顺畅不生硬拼凑单词。6.英文句式通顺、无生僻词、语法无误中文翻译符合中文习惯与原文语义一致适配学生对照学习。7.篇幅严格控制中英文对应一致- 12年级英文35句中文对应35句- 34年级英文68句中文对应68句- 56年级英文812句中文对应812句-初中及以上英文可适当加长中文翻译同步对应。8.所有内容严格适配儿童认知无任何不适宜未成年人的内容9.输出格式先英文短文目标单词加粗换行后中文翻译逐句对应、连贯无分段仅输出纯双语短文无任何多余内容。请严格遵循以上规则生成双语助记短文不得偏离。步骤4编写用户提示词。在用户提示词框中填入如下的内容以便将具体的用户数据传递给大模型同时帮助大模型节点更好地理解用户输入的内容。英文单词{{words}}年级{{grade}}4.生成图片分镜描述为双语短文配上形象、生动的插图可帮助用户更好地理解短文强化记忆效果。而“文生图”模型依赖结构化的图片生成指令。因此需要串联一个大模型节点专门负责根据文本故事生成专业的分镜提示词。步骤1接入大模型节点。在“生成双语短文大模型”节点的下游继续接入一个大模型节点。步骤2选择模型。选中该节点在参数配置对话框的模型列表中选择“DeepSeek-V3.2”。步骤3绑定输入变量。选中该节点在参数配置对话框中将默认输入变量的名称修改为“article_content”并引用上游大模型节点的输出结果output作为该变量的值。步骤4编写系统提示词。在系统提示词区域中输入以下指令明确分镜画面的撰写规则与输出格式。你是专业儿童绘本分镜设计师。任务根据用户输入的英文短文创作34幅连贯的分镜画面描述用于AI生成图片。规则1.严格按照短文内容顺序拆分成34个关键画面不编造额外情节。2.先确定唯一主角形象在所有分镜中主角的性别、年龄、脸型、发型、发色、服装款式与颜色、身高必须完全统一、全程不变绝不允许更换服饰、外貌、姿态特征。3.每一幅画面描述的开头都必须重复一遍主角的固定形象描述确保所有分镜角色完全一致。4.每幅画面包含场景、人物/动物动作、环境、光影、色彩、构图描述清晰、画面感强。5.风格统一为儿童绘本风/卡通清新风明亮温暖、简洁可爱适合中小学生。6.每幅分镜单独编号只输出画面描述不解释、不议论、不加标题。7.语言使用中文描述简洁具体可直接用于文生图模型。输出格式示例1.画面描述【固定主角形象】场景与动作2.画面描述【固定主角形象】场景与动作3.画面描述【固定主角形象】场景与动作在生成多幅连贯插图时为实现人物形象的统一提示词的第2、3条规则强制要求在每个分镜开头重复给出固定的形象描述以此最大程度解决多图生成时的角色不一致问题。步骤5编写用户提示词。在用户提示词文本框中填入如下内容。双语短文内容{{article_content}}步骤6设置输出格式。由于接下来需要通过循环节点逐一生成图片因此必须将大模型的输出结果设置为String类型的数组格式配置如图6-7所示。图6-7 生成图片分镜大模型节点的输出配置5.循环生成图片前期生成的分镜描述包含34个画面为实现批量、自动化生成图片需要引入循环节点。具体操作步骤说明如下。步骤1接入循环节点。在“生成图片分镜描述”的大模型节点下游接入一个“循环”节点。步骤2配置循环参数。选中该节点在参数配置对话框中将默认输入变量名修改为“description”并引用上游生成图像分镜“大模型”节点输出的分镜描述数组output作为该变量的值。循环类型使用默认值“使用数组循环”即可配置如图6-8所示。图6-8 循环节点的配置循环节点的输入变量必须为“数组”类型如果在变量下拉列表中找不到上游节点请回退检查上游大模型节点的输出类型是否正确设置为String数组。步骤3构建循环体。添加一个“生成图像”节点并拖拽该节点到循环体框内部。将“生成图像”节点的左、右端点分别与循环体的开始端口和结束端口相连使其成为循环执行的真正主体。步骤4配置图像生成节点输入。选中“图像生成”节点在参数配置对话框中将默认输入变量名修改为“item_description”并引用循环节点的迭代变量item作为该变量的值配置情况如图6-9所示。图6-9 图像生成节点的输入配置item是循环节点内置的迭代变量。执行循环时系统会自动从数组中按顺序逐个取出元素并赋值给item直到遍历完所有分镜描述。步骤5编写生图提示词。在图像生成节点的提示词区域输入以下提示词通过正向要求与反向限制确保节点生成高质量的绘本插图。严格按照{{item_description}}生成图片。图片要求儿童绘本风格卡通插画明亮柔和色彩简洁可爱线条干净温馨治愈高清细节适合小学生白色背景构图简洁所有画面中严禁出现任何文字、字母、数字、标语、符号纯画面叙事。禁止出现畸形五官畸形手指多余肢体人脸崩坏画面错乱暗黑风格阴暗色调恐怖元素写实照片复杂杂乱背景文字乱码英文字母汉字水印logo图案成人画风违和道具多余无关装饰。步骤6配置循环节点输出。单击循环节点在右侧配置对话框中将默认输出变量名“output”修改为“images”将其值引用为“图像生成”节点的输出结果data用于集中返回所有生成的插图文件配置如图 6-10 所示。图6-10 循环节点的输出配置一个完整的循环结构包含外层的“循环”节点和内层的“循环体”。在配置节点参数时务必区分清楚是在哪一层级进行操作。6.合成朗读语音为辅助学生进行跟读和纠正发音可接入语音合成插件将短文转化为音频。操作步骤说明如下。步骤1添加语音合成插件。在“循环”节点之后接入一个“插件”节点。在插件市场中搜索“语音”关键字找到“语音合成”插件后添加其提供的speech_synthesis工具如图6-11所示。图6-11 添加语音合成插件步骤2配置输入参数。将生成双语短文大模型节点的输出变量output即生成的双语短文作为该节点输入变量text的值其余参数采用默认值即可参数配置如图6-12所示。图6-12 合成语音节点的输入配置7.配置结束节点如图6-13所示选中工作流的“结束”节点在“返回变量”标签页中配置以下三个输出变量。article引用“生成双语短文”大模型节点的输出返回双语短文文本。images引用“循环节点”的输出返回生成的插图数组。audio引用“语音合成”插件的输出返回朗读音频文件。图6-13 结束节点的配置8.测试、发布工作流步骤1试运行验证。单击画布底部工具栏中的“试运行”按钮。在试运行对话框的输入框中分别输入测试年级和单词信息如图6-14所示。图6-14 试运行输入步骤2查看结果。再次单击试运行对话框下方“试运行”按钮启动工作流。等待执行完毕后检查输出的短文、图片及语音是否符合预期运行成功界面如图6-15所示。步骤3正式发布。测试稳定后单击工作流编辑页面右上角的“发布”按钮按系统提示完成工作流的发布。图6-15 工作流试运行结果6.3.2创建智能体返回扣子编程页面单击左侧“新建项目”按钮随后在页面右侧点击“智能体开发”打开“创建”页面点击“创建智能体”打开“创建智能体”对话框填写智能体名称为“词‘绘’精灵”填写智能体功能介绍为“根据给定的英文单词生成双语短文和插图助力小学生快速记单词。”接着单击默认图标右侧的“生成”按钮系统会根据描述自动生成匹配的图标。最后单击“确认”按钮即可完成智能体实例的初始化创建如图6-16所示。图6-16 创建智能体6.3.3添加工作流智能体创建完成后系统将自动跳转至详细配置页面。将6.3.1 节中完成的工作流接入智能体为其注入“核心引擎”。步骤1在编排区域的“技能”模块下单击“工作流”右侧的“”按钮如图 6-17 所示。图6-17 添加工作流步骤2在弹出的面板中定位到6.3.1节已发布的工作流learn_English_words单击其右侧的“添加”按钮即可完成引入。具体操作界面如图 6-18 所示。图6-18 添加工作流6.3.4设置人设与回复逻辑词“绘”精灵的核心角色定位为中小学英语单词智能助教。当接收到用户输入的“年级”与“目标单词”信息时系统将自动触发已配置的工作流learn_English_words。双语短文生成、绘本配图绘制以及标准音频合成等核心内容的生产过程均完全依托该工作流独立完成智能体本体不进行任何生成层面的干预。此外在交互逻辑上智能体需要严格执行标准化的输出模板遵循儿童友好的语言规范并适时融入正向的学习激励语。该智能体的人设定义及回复逻辑提示词具体如下。#角色中小学英语单词启蒙智能助教##目标1.接收用户输入的“年级目标单词”自动调用工作流完成双语短文、绘本配图、标准发音全链路生成2.提供适配对应年级的沉浸式单词学习体验激发儿童英语学习兴趣3.确保输出内容完整、合规、儿童友好。##技能1.精准识别并校验“年级目标单词”输入完整性触发工作流2.自动调用预设工作流获取工作流生成的双语短文、绘本配图、语音音频等内容3.按固定格式整合工作流输出结果若工作流返回多张绘本配图需要全部依次输出不得遗漏。最后附加正向鼓励语4.处理基础异常输入不全、单词输入错误、工作流生成失败输出对应引导或提示。##工作流1.触发条件用户输入完整“年级目标单词”自动触发工作流{learn_English_words}输入不全或输入单词错误时仅输出引导语如“你好你现在是几年级呀告诉我年级和想学习的单词我马上为你生成专属的单词学习内容~”并终止调用工作流2.核心规则仅调用预设工作流{learn_English_words}双语短文、绘本配图、语音音频均由工作流完成不手动生成任何内容3.异常处理工作流任一节点生成失败则输出提示“抱歉呀这次的内容生成遇到了小问题你可以再试一次哦~”。##输出格式双语小短文{工作流生成的双语短文}绘本配图点击播放标准发音{工作流生成的音频链接}##限制1.禁止手动生成任何内容双语短文、配图、音频等均需要来自工作流2.严格遵循工作流链路不跳过、不修改任何节点及逻辑3.语言需要贴合儿童认知保持童趣禁用复杂术语和生硬说教4.禁止输出不适宜未成年人的内容工作流生成内容不合规则自动触发重新生成5.严格遵循固定输出格式仅替换{}内的工作流生成内容不修改格式本身6.输入不全时仅输出补全引导语不执行其他操作、不调用工作流。6.3.5设置开场白在编排页面的“对话体验”模块下单击“开场白”右侧的按钮一键生成引导语。需要说明的是尽管系统支持生成预置问题以辅助用户快速交互但鉴于本案例仅接收特定格式的信息且回复逻辑中已设定屏蔽无关问答因此不再配置预置问题以避免无效交互。开场白设置如图6-19所示。图6-19 设置开场白