《扣子编程从零开始搭建智能体 卢欣欣 清华大学出版社》【摘要 书评 试读】- 京东图书《扣子编程从零开始搭建智能体》全书案例持续更新-CSDN博客为确保“灵犀”智能体的交付质量在核心功能与配置全部构建完毕后需进行全面测试与验证涵盖知识库匹配、大模型兜底回复以及“竞品拉踩”等场景。其中竞品拉踩测试结果如图10-42所示。图10-42 竞品拉踩测试当多轮常规与边界测试均确认系统响应精准、逻辑闭环严密且各项功能达标后即可单击页面右上角的“发布”按钮按照系统引导完成部署正式将智能体上线至生产环境。10.5拓展提升会话归档与数据反哺在用户交互过程中将用户咨询的问题及回复内容全量、结构化地写入飞书多维表格进行数据沉淀。一方面可以实现会话数据的持久化归档方便运营人员跟踪查阅特定时段内的用户反馈精准洞察高频热点问题与业务痛点另一方面构建了“从业务中来到业务中去”的数据反馈闭环通过分析提炼归档数据的可将高频且未覆盖的新增热门问题及时补充至知识库推动知识库的动态扩容与迭代优化赋予智能体持续进化的能力。优化后的完整对话流如图10-43所示。图10-43 拓展优化后的会话流10.5.1创建相关数据表格1.创建原始问答记录多维表格登录飞书官网新建一个名为“小诺运动相机智能客服记录”的多维表格具体创建方法请参考8.3.1节该表主要用于沉淀用户的会话交互数据包含“ID”“问题”“回复”“是否推荐”四个核心字段各字段的数据类型及详细说明如表10-1所示。表10-1 原始问答记录表的结构字段名称数据类型默认值说明ID自增数字主键标识系统自动递增编号问题文本用户咨询的原始问题内容回复文本回复内容是否推荐单选否标识该问答是否优质作为后续同步至FAQ知识库的筛选依据创建完成后的多维表格如图10-44所示。单击右上角的“分享”按钮获得该表格的地址后续在对话流中要使用该地址。图10-44 多维表格2.创建在线FAQ表格步骤1进入云文档空间。返回飞书首页在左侧导航栏单击“云文档”选项进入飞书云文档管理页面如图10-45所示。图10-45 进入云文档步骤2定位至云盘目录。在云文档首页单击左侧菜单中的“云盘”选项将文档创建位置切换至云盘如图10-46所示。图10-46 进入云盘步骤3新建表格文档。进入云盘后首先确认当前位置是“我的文件夹”然后单击“新建”按钮在下拉列表中选择“表格”新建一个表格文档如图10-47所示。图10-47 新建表格步骤4选择空白模板。在弹出的模板选择窗口中再次确认创建位置无误选择“新建空白表格”完成表格的创建如图10-48所示。图10-48 选择模板步骤5表格基本设置。双击默认的表格名称将其重命名为“在线FAQ”并根据业务需要在首行依次输入列标题如“问题”“回复”等如图10-49所示。图10-49 表格基本设置步骤6配置分享权限。单击右上角的“分享”按钮开启分享功能并在“权限设置”中勾选“允许内容被分享到组织外”如图10-50所示。图10-50 权限设置扣子知识库目前仅支持解析普通二维表格无法读取轻量数据库性质的多维表格。为确保知识库能顺利读取数据“在线FAQ”需满足三项要求一是必须创建普通数据表格非多维表格二是必须存放于“云盘我的文件夹”目录下三是必须开启“允许内容被分享到组织外”权限。10.5.2设置数据同步指令步骤1新建指令。进入飞书机器人助手主页面https://botbuilder.feishu.cn/home单击“新建指令”按钮创建一个空白指令如图10-51所示。图10-51 新建指令步骤2选择触发器。在指令编辑页面中单击“选择触发器”在弹出的页面中选择“多维表格内容变更”触发器如图10-52所示。图10-52 选择触发器步骤3配置触发条件。在触发器配置页面中数据表选择10.5.1节创建的“小诺运动相机智能客服记录”多维表格下的默认数据表在“关注以下记录字段的变更”中仅勾选“是否推荐”字段变更方式选择“指定变更”变更条件设置为“等于”值设置为“是”。配置完成后单击“完成”按钮如图10-53所示。图10-53 多维表格内容变更配置步骤4选择执行操作。单击“选择操作”在右侧页面中选择“新增电子表格记录”如图10-54所示。图10-54 选择操作步骤5配置数据写入规则。在操作配置页面中工作表选择10.5.1节创建的“在线FAQ”表格中的Sheet1插入行位置选择“底部”在新增内容映射中设置“问题”和“回复”两项需与在线FAQ表格的列标题严格一致其值分别引用“小诺运动相机智能客服记录”多维表格中对应字段的值。单击“完成”按钮保存配置如图10-55所示。图10-55 配置新增电子表格记录步骤6启动指令。完成所有配置后单击页面右上角的“启动”按钮若指令未命名系统会提示先完成命名指令即可运行生效如图10-56所示。图10-56 启动指令10.5.3创建知识库由于10.3.1节创建的知识库是文本格式而当前的FAQ数据为结构化表格形式因此需要新增一个专属的知识库具体操作说明如下。步骤1创建知识库。进入扣子编程的资源库管理页面单击右上角“ 资源”按钮选择新建一个知识库并填写知识库相关信息如图10-57所示。图10-57 新建知识库步骤2完成飞书授权。首次接入飞书文档需要进行账号授权单击“授权”按钮按照系统引导完成飞书账号的授权流程如图10-58所示。图10-58 飞书授权步骤3选择知识库文件。授权成功后在“选择文件”页面即可浏览“我的空间”下的文档。勾选“在线FAQ”表格并设置更新频率为“每1天”如图10-59所示。最后单击右下角“下一步”按钮。图10-59 选择文件步骤4表结构配置。系统将自动识别数据表、表头和数据起始行等信息。用户只需在表结构中勾选“问题”列作为索引并单击“下一步”按钮如图10-60所示。图10-60 表结构配置用户的查询内容Query会与索引字段进行语义相似度匹配。支持设置多个索引字段但过多的索引可能会干扰匹配精准度建议仅勾选核心问题列。步骤5预览数据。在预览页面核对数据的解析与分段情况确认无误后单击“下一步”按钮如图10-61所示。图10-61 预览数据步骤6数据处理。系统开始处理数据可在该页面查看处理进度。单击“确定”按钮即可完成知识库的创建如图10-62所示。图10-62 数据处理10.5.4优化对话流1.添加目标知识库选中“知识库检索”节点在右侧参数配置面板中单击“目标知识库”右侧的“”按钮在弹出的窗口中添加10.5.3节创建的“飞书在线FAQ”知识库。该节点的目标知识库配置如图10-63所示。图10-63 知识库检索节点的目标知识库配置2.汇聚回复内容步骤1添加变量聚合节点。在原对话流中新增一个“变量聚合”节点随后断开两个“输出”节点与“结束”节点之间的原有连线将其重新连接至“变量聚合”节点以实现“知识库检索”与“大模型兜底”两条分支回复内容的统一汇聚。步骤2配置变量聚合节点。选中该节点在右侧参数配置面板中为默认分组变量“Group1”绑定输入源分别引用“加工处理回复”大模型节点的输出变量output与“兜底回复”大模型节点的输出变量output。该变量聚合节点的参数配置详情如图10-64所示。图10-64 变量聚合节点的配置3转换数据格式步骤1添加代码节点。在“变量聚合”节点的下游添加一个“代码”节点负责将用户输入的问题与系统回复的内容转换为飞书多维表格API支持的标准数据格式。步骤2配置代码节点的输入参数。选中该节点在右侧参数配置面板中添加用户问题“question”和回复内容“reply”两个输入变量。将question与“开始”节点的USER_INPUT变量绑定将reply与“变量聚合”节点的Group1变量绑定如图10-47所示。图10-65 代码节点的输入配置步骤3编辑转换代码。单击参数配置面板中“代码”右侧的“在IDE中编辑”按钮进入代码编辑模式。将编程语言切换为“Python”编写如下的代码实现数据格式的转换与封装。import jsonasync def main(args: Args) - Output:#获取输入参数question args.params.get(question,)reply args.params.get(reply,)#构建输出对象注意字典的键必须与飞书多维表格中的字段名完全一致records [{fields:{问题:question,回复:reply}}]#构建输出对象ret:Output {records:records}return ret步骤4设置代码节点的输出参数。在参数配置的“输出”模块中设置输出变量名为“records”需与代码中返回的键名保持一致并删除其他多余的默认输出参数如图10-48所示。图10-66 代码节点的输出配置4写入飞书多维表格步骤1添加飞书多维表格插件。在“代码”节点的下游添加一个“插件”节点。在插件市场中搜索“飞书”关键字找到“飞书多维表格”插件并展开选择“add_records”接口单击右侧的“添加”按钮完成节点挂载如图10-67所示。图10-67 添加飞书多维表格插件该插件使用前需要进行共享授权否则在运行时会报权限错误。授权的具体操作请参考8.3.2节的相关内容。步骤2配置飞书多维表格插件的输入参数。选中该节点在其右侧参数配置面板中“app_token”参数填入10.5.1节从多维表格分享链接中提取的表格地址“records”参数引用上游“代码”节点的输出变量records。该节点的输入参数配置如图10-68所示。图10-68 飞书多维表格插件的输入参数配置5对话流闭环与验证步骤1完成对话流闭环。将“飞书多维表格”插件节点连接至“结束”节点使整个对话流形成完整闭环。步骤2对话流测试。单击“试运行”按钮进行测试。首先检查运行过程中各节点是否报错测试结果如图10-69所示图10-69 对话流测试结果步骤3数据写入测试。对话流运行结束后打开飞书多维表格检查用户问题及系统回复是否已经准确写入对应的字段列中测试结果如图10-70所示。图10-70 数据写入测试结果步骤4数据同步测试。在多维表格中将新增数据“是否推荐”列的值修改为“是”以触发同步指令然后打开“在线FAQ”表格查看数据是否已自动同步。测试结果如图10-71所示。图10-71 数据同步测试结果以上步骤测试无误后再次发布对话流即可。