《AI智能体搭建与应用（基于Coze）（慕课版）》 课件 项目3 智能体搭建全流程

3项目三智能体搭建全流程智能体搭建全流程任务一确认搭建需求确认搭建需求是智能体搭建的起点，需理清四大问题，即输入需求、功能需求、交互需求、输出需求，以此形成清晰的搭建目标框架。输入需求1输入需求分类1用户需提供规范格式的数据，要求数据可无缝对接后台流程。（1）结构化数据输入半结构化数据是指结构化字段与自然语言相结合的数据，需平衡格式约束与表达灵活性。（2）半结构化数据输入输入需求量化标准2仅保留实现功能所必需的数据，剔除冗余信息以减轻用户操作负担。（1）拆解流程评估用户获取信息的难度，优化输入方式。（2）访谈用户任务一确认搭建需求输入需求技术规范3智能体应支持文本、语音、文件等多种输入形式，适配网页、App、微信等多终端传输；明确传输限制；多模态输入需分通道处理。任务一确认搭建需求功能需求2功能需求分类1不可替代的核心功能是用户选择的关键。（1）核心功能辅助功能是指提升体验的补充模块，需贴合潜在需求，避免冗余。（2）辅助功能功能需求量化标准2按“必需、建议、可选”三级划分。（1）分层功能级别制定可量化标准，如关键词识别正确率≥95%、消息响应时长≤2s。（2）明确衡量指标采用插件化设计，以便后期适配新业务，降低重构成本。（3）预留扩展性任务一确认搭建需求功能需求价值作用3依据核心功能选插件、按辅助功能配提示词模板，以减少搭建成本。（1）明确搭建方向量化标准有助于快速定位优化点，降低返工成本。（2）提供测试依据任务一确认搭建需求交互需求3交互需求分类1交互动作一般包含打字、语音、音视频通话及勾选、滑动等用户界面（UserInterface，UI）操作，遵循简洁、直观的原则。（1）交互操作单轮响应适配简单查询，多轮对话适配复杂需求，通知推送适配周期性需求。（2）交互模式交互需求量化标准2普通交互≤3s，复杂操作≤5s，并显示进度提示。（1）控制响应延迟商业场景用正式书面语，儿童教育场景用活泼、充满童趣的语言。（2）适配语气风格交互时应支持上下文记忆，意图模糊时主动澄清需求；优化UI布局，核心按钮需可（3）明确记忆能力任务一确认搭建需求交互需求异常处理3提示用户检查网络连接，恢复后自动续办未完成任务。（1）网络中断用通俗语言说明原因并给出建议，避免使用专业术语。（2）输入无效告知用户故障情况与预计恢复时间，提供用于刷新的便捷按钮。（3）系统错误任务一确认搭建需求输出需求4输出需求分类1基本信息输出适配查询类智能体。（1）基本信息输出数据与文件输出适配分析/生成类智能体。（2）数据与文件输出输出需求量化标准2如语法纠错智能体准确率≥90%，外部信息需标注来源以保证可追溯。（1）结果准确商业场景用正式书面语，儿童教育场景用活泼、充满童趣的语言。（2）结果完整统一排版样式，核心结论加粗，表格明确表头与单位，按要求更新信息以保证时效性。（3）结果标准任务一确认搭建需求输出需求结果约束3依据需求选择实时/非实时交付、文本/文件形式、文本/图片模态及是否开启流式输出。（1）输出方式适配设置字数限制、敏感信息过滤及内容审查等边界约束，以确保输出合规。（2）边界约束任务二搭建智能体进入扣子开发平台1扣子开发平台是一个高效、智能的工具构建平台，用户可以通过它创建和管理各种智能体。认识界面1下面从进入平台开始逐步介绍其页面和操作流程。

在浏览器中搜索“扣子”，进入其主页并进行注册登录。单击左上角的“开发平台”按钮即可进入扣子智能体的开发平台，如图3-1至图3-2所示。图3-1扣子主页图3-2扣子开发平台左侧导航区任务二搭建智能体进入智能体编排页面2单击扣子开发平台左侧的“创建”按钮，在弹出的对话框中单击“创建”按钮。输入智能体名称与功能介绍，单击“确认”按钮，进入智能体编排页面，如图3-3至图3-4所示。图3-3选择创建智能体图3-4输入智能体名称与功能介绍任务二搭建智能体智能体编排页面介绍3进入智能体编排页面后，可看到以下3个面板，如图3-5所示。左侧为“人设与回复逻辑”面板，用户可以在这里输入提示词。中间为“编排”面板，用户可通过拖曳组件、配置流程搭建智能体的功能模块。右侧为“预览与调试”面板，能实时模拟用户使用场景。图3-5智能体编排页面任务二搭建智能体

设计提示词2它们构成了系统提示词——即为智能体明确人设定位、划定回复规则、引导交互行为的基础指令。与之对应的是用户提示词，指用户在对话过程中输入的具体问题、指令或诉求。二者区别如下：两大核心要素①人设即智能体的虚拟身份，需明确它的身定位与沟通风格。②回复逻辑约束智能体回复的规则，确保它的发言始终贴合人设、适配交互场景，同时满足用户的核心需求。表3-1系统提示词和用户提示词的区别对比维度系统提示词用户提示词定位智能体的“指令手册”，由开发者预设用户的“问题或请求”，由用户在交互中输入作用定义智能体的身份、能力边界、回复规则与格式要求，指导智能体的整体行为逻辑传递用户的具体诉求，触发智能体的响应动作可见性仅开发者可见，用户无法查看用户可自主输入，开发者可在后台查看历史记录

示例“你是家庭日常食谱助手，仅解答与家常菜做法、食材替代有关的问题，回复要口语化、步骤清晰，加一句安全提示”“鸡蛋和番茄不够了，能用什么食材替代做家常菜？”“教我做最简单的蛋炒饭，步骤别超过5步”任务二搭建智能体

将提示词输入“人设与回复逻辑”面板中，即完成了系统提示词的设置。单击此面板右上角的

按钮，还可利用AI自动优化提示词，优化前后效果对比如图3-6至图3-7所示。图3-6优化前的人设与回复逻辑提示词图3-7

AI优化后的人设与回复逻辑提示词任务二搭建智能体设置模型1配置能力3此处设置的模型是驱动智能体运行的系统模型。设置模型的具体操作步骤如下。（1）模型选择进入智能体编排页面后，在“编排”面板中找到“模型”，单击展开其右侧的列表，进行模型选择，如图3-8所示。图3-8模型选择任务二搭建智能体选定需要的模型后，需要对模型参数进行个性化设置，定制模型的实际能力。其中“生成随机性”用于控制输出内容的多样性；“输入及输出设置”则包括以下两个参数。“生成多样性”下的预设模式就可满足日常智能体搭建的需求，如图3-9所示。①“携带上下文轮数”用于设置模型带入上下文的对话历史轮数。②“最大回复长度”用于控制模型输出内容的长度上限。可根据智能体需要自行进行设置，如图3-10所示。图3-9模型模式设置图3-10模型的其他设置（2）模型力设置任务二搭建智能体添加技能2在扣子中，技能主要包括插件、工作流等。（1）插件插件在扣子平台中是包含一个或多个工具的工具集。能扩展智能体的基本能力范围。①打开“添加插件”对话框。在“编排”面板的“技能”栏中单击“插件”右侧的“添加插件”按钮，打开“添加插件”对话框，如图3-11和图3-12所示。图3-11单击“添加插件”按钮图3-12“添加插件”对话框任务二搭建智能体②选择合适的插件。在“添加插件”对话框中，搜索关键词查找所需的插件。还可以在工具的右下角查看工具的调用量、智能体引用量、平均耗时、成功率等信息，如图3-13所示。图3-13插件的数据信息③查看插件信息并添加插件。选择合适的插件后，单击插件右侧的 按钮（单击后变为 样式），查看插件的信息。以“头条新闻”插件为例，该插件只包含“getToutiaoNews”这一个工具，如图3-14所示。图3-14“头条新闻”插件的信息任务二搭建智能体单击工具右侧的“添加”按钮添加到智能体中。例如，此处选择“getToutiaoNews”工具，单击其右侧的“添加”按钮后，在智能体编排页面的“技能”栏中可看到添加的插件，如图3-15所示。图3-15插件添加成功示例图3-16根据你的提示词自动添加工具按钮还可单击“根据你的提示词自动添加工具”按钮

，让系统自动选择合适的插件，如图3-16所示。任务二搭建智能体（2）工作流扣子平台核心技能分为两类，配套可视化画布降低搭建门槛：工作流：平台高级技能，本质为可执行指令集，支持可视化搭建复杂任务框架，固定节点顺序执行，强任务导向，适配有明确输入输出的自动化场景。对话流：对话场景专用，可随用户回复动态调整执行路径，擅长多轮交互。任务二搭建智能体①创建工作流。在智能体编排页面“技能”栏中单击“工作流”右侧按钮，打开“添加工作流”对话框，单击“创建工作流”按钮，打开“创建工作流”对话框，填写工作流名称和工作流描述。填写完成后单击“确认”按钮，进入工作流编排页面，如图3-17至图3-19所示。图3-17

单击“创建工作流”按钮图3-18输入工作流名称及描述图3-19工作流编排页面任务二搭建智能体②添加节点。下面将重点介绍工作流中使用最多的开始节点、结束节点和大模型节点。图3-20-所示为开始节点及其配置面板。图3-20开始节点及其配置面板任务二搭建智能体图3-21-3-22为结束节点及其配置面板。图3-22结束节点及其配置面板（返回文本）图3-21结束节点及其配置面板(返回变量)任务二搭建智能体在结束节点中，需要关注两种信息输出模式，分别是返回变量与返回文本。返回变量：工作流运行结束后，会以特定的格式（一般是JSON格式）输出运行结果。返回文本：工作流运行结束后，嵌入相关工作流的智能体将使用系统大模型将指定的内容作为结果输出，指定内容的形式为“{{变量名}}”。任务二搭建智能体大模型节点是最常用的节点类型之一，它可以利用AI能力来处理文本相关的任务。单击工作流编排页面下方的“添加节点”按钮，在弹出的列表中可选择要添加的节点，如图3-23所示，图3-24和图3-25所示为大模型节点及其配置面板。图3-23添加节点图3-21大模型节点及其配置面板图3-25大模型节点的配置面板任务二搭建智能体这里以作用为“给出英文单词的释义”的工作流为例进行介绍。其包含开始节点、翻译节点、结束节点，如图3-26所示。图3-26工作流的节点③连接节点。节点添加完成后，连接各个节点，如图3-27所示。图3-27连接节点任务二搭建智能体④设置工作流节点的参数。开始节点只有一个输入参数，其设置如图3-28所示。图3-28开始节点的参数配置翻译节点的参数设置如表3-2所示。设置项具体设置说明模型选用“豆包・1.6・深度思考・250715”模型，开启“精准模式”输入变量引用开始节点中的“input”变量系统提示词输入“一个英文单词翻译工具，可根据用户输入的英文单词，给出相应的释义”，并启用自动优化功能优化提示词用户提示词引用输入变量，格式为“{{input}}”输出变量仅配置一个输出变量，用于承接大模型生成的英文单词释义任务二搭建智能体结束节点采用返回变量模式，如图3-29所示。图3-29结束节点采用返回变量模式对结束节点的输出变量进行设置，将大模型输出与生成结果、插件生成结果的变量添加到输出变量中，如图3-30所示。图3-28输出变量设置任务二搭建智能体⑤验证工作流效果。单击工作流编排页面下方的“试运行”按钮，如图3-31所示，打开“试运行”面板。图3-31单击“试运行”按钮在“试运行”面板中输入必填的变量“input”，单击下方的“试运行”按钮，开始试运行,等待片刻，即可看到试运行结果，如图3-32和图3-33所示。图3-32输入需求图3-33试运行结果任务二搭建智能体试运行验证通过后，进入工作流编辑界面右上角的发布设置页面，在其中输入版本描述后单击“发布”按钮，完成发布，如图3-34所示。图3-34发布工作流任务二搭建智能体扣子开发平台中的知识库类型有文本类、表格类、照片类。此处演示在扣子开发平台中创建与添加文本类知识库。（1）打开“选择知识库”对话框单击“编排”面板“知识”栏中“文本”右侧的“添加知识库”按钮，打开“选择知识库”对话框，如图3-35和图3-36所示。图3-35单击“添加知识库”图3-36“选择知识库”对话3添加知识库任务二搭建智能体（2）创建与添加知识库单击对话框中的“创建知识库”按钮，打开“创建知识库”对话框，创建知识库，如图3-37所示。①创建知识库。选择创建文本格式的知识库，输入知识库的名称与描述，选择一种导入类型。以导入本地文档为例，设置好知识库名称与描述后，单击“本地文档”按钮，再单击“创建并导入”按钮，进入本地文档上传页面，如图3-38和图3-39所示。“图3-37创建知识库”对话框图3-38知识库名称与描述设置图3-35单击“添加知识库”任务二搭建智能体②进入创建设置页面。单击页面右下角的“下一步”按钮，如图3-40所示，进入创建设置页面，如图3-41所示。图3-40单击“下一步”按钮图3-41创建设置页面任务二搭建智能体③进行创建设置。创建设置如图3-42所示。图3-42创建设置④进入分段预览页面。单击页面右下角的“下一步”按钮，进入分段预览页面，如图3-43所示。图3-43分段预览页面任务二搭建智能体⑤进入数据处理页面。单击右下角的“下一步”按钮，进入数据处理页面，如图3-44所示。图3-44数据处理页面⑥添加知识库。单击数据处理页面右下角的“确认”按钮，完成知识库的创建，进入知识库详情页面，如图3-45所示。图3-45知识库详情页面任务二搭建智能体单击右上角的“添加到智能体”按钮，将新创建的知识库添加到智能体，效果如图3-46所示。图3-46添加知识库后的效果任务二搭建智能体（1）变量变量核心功能是存储和管理智能体运行过程中动态变化的信息。扣子平台的变量分为系统变量与用户变量两类。系统变量由平台预设，涵盖多个类别。用户无法修改，可在工作流、插件中直接引用。用户变量是个性化设置的核心，个性化信息均可设置为用户变量，用于保存用户专属信息,是变量设置的主要操作项。记忆功能主要通过变量、数据库、长期记忆等核心模块实现。4添加记忆任务二搭建智能体①打开“编辑变量”对话框。在扣子智能体“编排”面板的“记忆”栏中单击“变量”右侧的“添加变量”按钮，打开“编辑变量”对话框，如图3-47和图3-48所示。图3-47单击“添加变量”按钮图3-48“编辑变量”对话框任务二搭建智能体②设置并验证用户变量。设置变量名称、描述、默认值，勾选“操作”列中的复选框，并启用变量，如图3-49所示。图3-49设置用户变量图3-50验证用户变量单击“编辑变量”对话框右下角的“保存”按钮，完成变量编辑。对变量进行验证。直接在智能体中输入问题，智能体将会根据变量输出结果，如图3-50所示。任务二搭建智能体（2）数据库数据库以表格形式组织、维护数据，可满足各种信息的存储需求。①打开“选择数据库”对话框。在扣子智能体“编排”面板的“记忆”栏中单击“数据库”右侧的“添加表”按钮，打开“选择数据库”对话框，如图3-51和图3-52所示。图3-51单击“添加表”按钮图3-52“选择数据库”对话框任务二搭建智能体②创建数据库。单击“新建数据表”按钮，在弹出的列表中选择“自定义数据表”选项，打开“创建数据库”对话框，选择“创建扣子数据库”选项。图3-63创建数据库输入数据表名称与描述，完成基本设置，如图3-53所示。③新建数据表。单击“创建数据库”对话框右下角的“确认”按钮，打开“新建数据表”对话框，如图3-54所示图3-54新建数据表对话框任务二搭建智能体单击“新建数据表”对话框中的“新增”按钮，添加一个字段。设置存储字段名称、描述、数据类型，开启“是否必要”选项。用相似的方法再添加一个字段，如图3-55所示。图3-55新增存储字段任务二搭建智能体④添加数据库。完成存储字段的设置后，单击“保存”按钮，完成数据表创建，返回“选择数据库”对话框。在该对话框中单击数据库右侧的“添加”按钮，将刚创建的数据库添加到智能体中，如图3-56所示。图3-56单击“添加”按钮任务二搭建智能体⑤修改数据库。数据库添加完成后，可在“预览与调试”面板中，用自然语言修改数据库中的数据，如图3-57所示。用户也能进行增添数据、删减数据、列出当前数据等操作，操作方法类似。图3-57使用自然语言修改数据库内容⑥查看当前数据库数据信息。单击“编辑表”按钮，进入数据库详情页，查看当前数据库数据信息，如图3-58和图3-59所示。图3-58单击“编辑表”按钮图3-59查看当前数据库数据信息任务二搭建智能体（3）长期记忆长期记忆功能可以让智能体“记住”用户个人信息，设置方法如下。将长期记忆状态设置为“开启”，将记忆有效期设置为“永久有效”，再打开“支持在Prompt中调用”功能，如图3-60所示。图3-60设置长期记忆任务二搭建智能体配置选项配置方法功能配置注意事项

开场白在智能体编排页面的“对话体验”栏中展开“开场白”，然后在文本框中输入开场白文案；此外也可单击按钮，使用AI生成开场白文案作为智能体与用户的首次互动内容，开场白可以传递智能体核心功能与服务范围等信息文本需简洁明了，避免过长；语气需与智能体定位匹配用户问题建议在“对话体验”栏中将“用户问题建议”的状态设置为“开启”开启功能，智能体回复后，将自动根据对话内容提供3条针对用户提问的建议如果智能体的功能比较垂直，开启该功能后，智能体可能无法回复建议中的问题，易给用户造成困扰

快捷指令在智能体编排页面的“对话体验”栏中单击“快捷指令”右侧“添加指令”按钮打开“创建快捷指令”对话框；依次配置按钮名称、指令名称、指令描述等基本参数，完成后单击“确认”按钮即可预设快捷指令可方便用户快速触发智能体特定功能，无须输入复杂提示词描述

需保证指令实用性，每个指令对应明确需求；操作需简便，以降低用户学习成本背景图片在“背景图片”处插入图片为用户带来沉浸式对话体验图片主题要与智能体相符且不影响用户与智能体的交互音视频在“音视频”右侧单击“添加语音”按钮，选择语言与音色智能体可以通过语音回复用户，用户还可与智能体进行音视频通话语言与音色应与智能体人设一致用户输入方式在“用户输入方式”处进行选择满足不同用户的输入需求（包括打字输入和语音输入）应考虑智能体与输入方式之间的适配性，以及分析智能体受众的输入方式5配置对话体验任务二搭建智能体（1）预览预览能让用户直观查看智能体的响应效果、功能完整性与整体交互表现，从而及时发现问题并调整。（2）调试（1）发起测试对话发起测试对话，以仅添加了“小学5年级数学知识大全”知识库的智能体为例。若向其发送“调用知识库，输出初中函数的知识点总结”的指令，因知识库中无初中数学相关内容，智能体将无法给出对应回答，如图3-61所示。图3-61发起测试对话预览和调试4任务二搭建智能体（2）打开“调试详情”面板图3-63“调试详情”面板（2）图3-62“调试详情”面板（1）单击测试对话右下角的

按钮，打开“调试详情”面板，如图3-62和图3-63所示。任务二搭建智能体“调试详情”面板中的调用树是排查问题的核心工具，可展示智能体的完整调用路径。（3）通过调用树排查问题可见，由于知识库中没有初中函数相关内容，智能体无法搜索到结果，因此无法输出结果。图3-64单击“知识库Knowledge”图3-65“调试详情”面板中的智能体输出参数（4）借助火焰图优化性能“调试详情”面板中的火焰图能查看智能体运行过程中各环节的实际耗时，如图3-66所示。图3-66火焰图任务二搭建智能体发布智能体5单击智能体编排页面右上角的“发布”按钮，进入智能体发布页面，如图3-67所示。以将智能体发布至扣子商店为例。输入版本记录，说明本次修改内容，勾选“扣子商店”复选框，单击智能体发布页面右上角的“发布”按钮；等待官方审核通过后即可完成发布，如图3-68所示。图3-67智能体发布页面图3-68成功发布智能体任务三搭建智能应用创建应用项目。登录扣子开发平台，单击“创建”按钮，然后单击“低代码搭建”按钮；选择“创建空白应用”，输入应用名称及应用介绍；单击“确认”按钮，进入应用集成开发环境（IntegratedDevelopmentEnvironment，IDE）的业务逻辑页面，如图3-69所示。图3-69业务逻辑页面业务逻辑页面左侧为资源列表，右侧为配置区域。图3-70所示为用户界面，在其中可以选择UI搭建类型，包括小程序和H5、桌面网页。图3-70用户界面任务三搭建智能应用创建业务逻辑1创建业务逻辑本质上就是编排工作流。此处只介绍创建业务逻辑最核心的内容——工作流的设置。在智能应用业务逻辑页面可通过“工作流”模块的对应按钮导入资源库中的工作流，效果如图3-71所示。图3-71在业务逻辑页面导入工作流任务三搭建智能应用搭建用户界面2单击业务逻辑页面上方的“用户界面”按钮，切换到用户界面。初次进入时需选择UI搭建类型，此处选择“桌面网页”，单击“开始搭建”按钮，如图3-72所示。图3-72选择UI搭建类型进入用户界面搭建页面，如图3-73所示。图3-73用户界面搭建页面①选择UI搭建类型任务三搭建智能应用用户界面搭建页面各组成部分的功能如表3-4所示。表3-4用户界面搭建页面各组成部分的功能组成部分功能“组件”面板提供丰富的组件，支持通过拖曳操作将组件添加到画布，以实现用户界面的快速搭建“模板”面板提供一系列预设模板，用户可在选择模板后，根据需求对模板进行个性化修改“结构”面板用于浏览和管理用户界面编辑器中的不同界面和图层“数据”面板用于设置当前应用专属的界面变量，界面变量可存储界面临时数据，实现组件与界面间的信息传递和交互联动画布支持拖曳组件，同时支持通过拉伸方式快速调整组件的大小配置面板可通过属性配置调整组件样式；通过事件绑定实现业务逻辑与界面组件的联动（如为按钮绑定工作流单击事件、用户单击时触发工作流调用）任务三搭建智能应用（1）搭建页面整体结构图3-74容器组件Div1

①拖入并配置容器组件Div1。找到容器组件拖入画布中，在画布中选中拖入的容器组件，组件名称为Div1，如图3-74所示。进行Div1的尺寸和布局配置，如图3-75所示。图3-75尺寸和布局配置②用户界面搭建进行Div1的样式设计，如图3-76所示。图3-76Div1的样式设计任务三搭建智能应用②拖入并配置容器组件Div2、Div3、Div4。再拖入3个容器组件，用相似的方法进行配置。应用的页面整体结构搭建完成，如图3-77所示。图3-77页面整体结构任务三搭建智能应用图3-78文本组件配置（2）搭建页面标题区①拖入文本组件。找到文本组件，将其拖入顶部的容器组件Div1上。②配置文本组件。选中拖入的文本组件，在右侧的配置面板中输入文本内容，将预设样式设置为“标题四”，如图3-78所示。任务三搭建智能应用（3）搭建翻译内容区①拖入表单组件并删除多余组件。找到表单组件并将其拖入画布的容器组件Div3中；然后选中不需要的组件进行删除，如图3-79所示。图3-79拖入表单组件并删除多余组件任务三搭建智能应用②配置表单组件。选中表单组件，按以下步骤配置。图3-80搭建完成的翻译内容区a.设置宽度和高度，并删除边框。b.选中表单内的文本框，然后将其拉伸到合适的大小；再修改属性和宽度。c.选中表单组件中的选择组件，然后修改标签内容。d.选中表单组件中的按钮组件，修改内容。任务三搭建智能应用（4）搭建结果展示区①将Markdown组件拖入画布的容器组件Div4中。②选中新拖入的组件，进行属性配置。③找到图片组件并将其拖入Div4中，选中新拖入的图片组件，调整其大小和位置。用户可单击配置面板上方的“预览”按钮进行预览，预览效果如图3-81所示。图3-81预览效果任务三搭建智能应用绑定业务逻辑与用户界面3完成用户界面搭建后，需要将业务逻辑与用户界面绑定，以实