WorkBuddy Agent回答质量不稳定需三步排查：一、重写提示词为“角色+任务+约束”三段式并清除CDN缓存；二、缩短历史消息保留条数至5并添加动词+名词锚定指令；三、确认知识库启用、解析成功且手动触发强制重索引。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
WorkBuddy的Agent回答质量不稳定，可能是提示词模糊、上下文截断或知识库未实时同步导致的，需逐项排查并针对性调整。
检查并重写核心提示词（Prompt）
打开WorkBuddy后台 → 进入「Agent设置」→ 点击「系统提示词」编辑框。
删除当前笼统的描述（如“请专业、友好地回答用户问题”），改用具体角色+任务+约束三段式结构：第一行定义身份（例：“你是一名专注IT运维的SOP执行助手”），第二行明确输入输出格式（例：“只回答与Linux命令、K8s排错、Jenkins流水线相关的问题；不猜测、不编造、不确定时回复‘该问题超出当前知识范围’”），第三行加硬性限制（例：“单次响应不超过120字，禁用‘可能’‘大概’‘一般’等模糊词”）。
保存后强制刷新Agent缓存：在「调试模式」下发送一条测试消息，观察首条响应是否立即符合新规则。若仍复现旧风格，说明旧提示词被缓存在CDN节点，需联系WorkBuddy技术支持清除边缘缓存。
调整上下文窗口与记忆长度
方法一：缩短单轮对话记忆深度
进入「高级配置」→ 将「历史消息保留条数」从默认20改为5。过长的历史会挤占模型对当前问题的理解带宽，尤其当用户连续追问不同主题时，Agent容易混淆上下文。
方法二：启用关键信息锚定
在提示词末尾追加一句：“每次响应前，先提取用户最新提问中的【动词+名词组合】（如‘重启服务’‘查看日志’‘导出报表’），仅围绕该组合生成答案。” 这能强制模型聚焦当前动作，避免被前几轮无关对话干扰。
验证并更新知识库源文件
第一步：确认知识库是否启用
在「知识增强」模块中，检查「启用外部知识检索」开关是否为开启状态。关闭状态下Agent完全依赖预训练参数，无法调用你上传的SOP文档或FAQ。
第二步：检查文件解析状态
点击「已上传文档」列表，查看每份PDF/Word文件右侧的图标：绿色对勾表示解析成功，黄色感叹号代表OCR失败或表格识别异常——这类文件实际未被索引，需重新上传为纯文本或截图转文字后的TXT格式。
第三步：触发增量更新
修改任一知识库文档后，不能只点“保存”，必须点击文档右侧的【强制重索引】按钮。WorkBuddy默认采用懒更新策略，不手动触发则新内容不会进入向量库。
