调优记录1：优化知识库检索精度

（1）解决问题：知识库已录入完整内容，但出现有资料却检索失败的情况。

（2）问题收集：测试中发现，即便知识库内已收录校园活动的时间、地点、报名方式等信息，当用户用口语化、同义语句提问时，智能体常会提示“暂无足够相关资料”，检索成功率偏低。查看运行日志可见，知识库检索节点没有输出有效匹配内容。

（3）原因分析与优化方案：

问题类型：检索性能问题。

原因：检索功能的相似度阈值设置为0.8，标准过高，能匹配的语义范围窄，无法适配日常口语提问；同时大模型提示词未明确优先级，没有要求优先调用知识库内容。

方案：调低相似度阈值，扩大语义匹配范围，增加检索结果数量；修改大模型提示词，规定回答必须优先参考知识库内容，禁止随意编造信息。

（4）操作与效果验证：

将知识库检索相似度阈值从0.8调整为0.6，单次检索返回条数由3条改为5条；补充大模型提示词，明确要求优先使用知识库内容，无相关资料时如实告知用户。

重新测试后，针对“活动什么时候举办”“嘉年华在哪里参加”这类口语化提问，均能正常匹配知识库内容，问答准确率达到100%，问题彻底解决。

（5）版本更新：保存所有配置，重新发布工作流，生成V1.1版本二维码。

调优记录2：优化个性化变量交互

（1）解决问题：变量为空、内容加载异常，无法实现个性化展示。

（2）问题收集：用户使用后反馈，界面始终显示固定话术，无法展示用户名、年级等个性化内容；查看系统日志，发现存在变量空值报错，部分场景下还会导致工作流运行卡顿。

（3）原因分析与优化方案：

问题类型：交互体验+流程运行问题。

原因：开始节点的参数设置了必填项，且未设置默认内容，未传入信息时变量就会为空；变量关联规则有误，节点执行顺序混乱，变量无法全局生效；大模型中变量的引用格式不统一，导致内容无法正常显示。

方案：取消参数必填限制，补充默认内容；调整节点执行顺序，保证变量正常全局加载；统一变量引用格式。

（4）操作与效果验证：

取消user_name、user_grade、user_query的必填勾选，并为各项设置默认值；修正变量关联规则，保证参数正常传递；统一大模型内变量的书写格式。

经过多场景测试，系统可以正常读取并展示用户名、年级信息，个性化问候正常显示，不再出现报错、卡顿问题，相关功能恢复正常。

（5）版本更新：保存优化配置，重新发布工作流并生成二维码。

调优记录3：优化记忆与上下文能力

（1）解决问题：多轮对话衔接中断，无法识别指代内容。

（2）问题收集：进行多轮对话测试时发现，对话无法延续。当用户接着前文追问“那活动地点呢”“报名要求是什么”这类问题时，智能体无法理解指代内容，遗忘之前的对话信息，短期记忆失效，对话连贯性差。

（3）原因分析与优化方案：

问题类型：语义识别+交互体验问题。

原因：智能体提示词中没有清晰的记忆、上下文约束规则，也未设置对话历史读取规则；长期记忆功能未开启，无法留存用户信息。

方案：完善提示词，明确短期记忆、指代识别、对话连贯的相关规则；设置对话轮数，保证模型可以读取历史对话记录；启用长期记忆功能，长久保存用户信息。

（4）操作与效果验证：

修改智能体全局提示词，补充对话记忆、语义识别相关规则；将可读取的历史对话轮数设置为3轮；完整开启长期记忆功能。

优化后反复测试，系统可以记住用户姓名、年级等信息，也能准确识别对话中的指代内容，多轮对话衔接流畅，短期记忆与长期记忆均能正常使用。

（5）版本更新：确认全部配置无误，完成全流程检测后，发布最终版本并生成二维码。