排查回答与操作问题
先确认问题发生在哪里：回答内容、文章引用、反馈操作，还是对话访问。下面按症状给出检查顺序。组件按钮不显示、登录令牌交换失败等接入问题，见安装反馈组件。
答案不准确，或者仍使用旧规则
- 确认组件连接到正确工作区，帮助文章也保存在同一个工作区。
- 打开对应文章，检查标题、描述和正文是否明确回答了这个问题。
- 确认允许 AI 使用已经开启并保存；只在外部文档站更新还不够。
- 检查其他 AI 可见文章是否仍写着旧规则，特别是套餐、权限和使用限制。
- 新开对话，用相同问题复查。
撤下或隐藏文章不会停止 AI 使用。需要停止读取旧资料时，另行关闭允许 AI 使用。关闭后不会清除已经发送的答案或已有对话历史。
如果资料都正确，回答仍然不符合预期，记录问题原文、实际回答和应依据的文章，便于团队继续定位；不要把一篇文章存在当作每次回答一定正确的保证。
回答没有文章卡片，或者引用打不开
没有卡片不一定是没有查资料：允许 AI 使用的非公开文章可以用于回答，但不能作为公开引用。
对于应该公开的文章，依次检查：文章已发布、分区对读者可见、门户已开启帮助中心。从编辑器复制实际文章链接，确认普通读者能够打开。详细步骤见控制公开访问。
以前分享过的引用也不保证永久可读。文章撤下、分区隐藏或门户关闭后，旧链接会失去公开访问权限。
没有创建新反馈，或者给已有反馈投了票
先查看回复中的操作说明和反馈卡片。Agent 会查找相似反馈，同一诉求可能通过投票和订阅记录，不一定创建新条目。
如果只是询问“这个功能怎么用”，Agent 可能先回答问题。希望记录缺陷或建议时，应说明意图和必要细节，例如“导出一直失败，请记录这个问题”，再补充预期、实际结果和复现条件。
没有操作结果时，检查用户身份和工作区权限。访客提交、投票和评论分别受权限控制。需要登录时，应走产品自己的登录入口。
如果匹配到的反馈并不是同一个问题，在原对话中说明具体差异，并检查后续保存的结果。
无法修改刚提交的反馈
直接纠正反馈标题或正文，需要同时满足：
- Agent 在当前对话中为当前用户创建了这条反馈。
- 反馈仍处于刚创建后的短时间内。
- 没有其他用户投票或评论。
公开反馈属于社区共同讨论的内容，需要保留其他人投票或评论时所依据的信息。不适合直接修改时，可以追加评论解释更正。
Agent 也可以纠正自己在同一对话中代写的评论。
回复失败，不确定操作是否完成
回复中断不代表先前操作被撤销。先检查门户中的反馈、票数或评论；界面提供重试时，可以使用重试继续获取回复。不要立即重复发送同一个创建请求。
如果持续失败，记录大致时间、错误提示和请求的操作。自部署管理员检查模型配置及服务连接。消息最多 4000 字符，单张图片不超过 16 MB；短时间频繁发送也可能被限流。
历史对话找不到
检查是否使用同一个产品账号或访客身份。登录 FeedLog 管理后台不等于组件已获得相同身份；组件使用的是产品接入提供的身份。
访客清除浏览器数据后，可能失去原访客身份。较早的对话也可能超出工作区设置的可见范围，管理员可在设置 → 反馈组件检查对话可见天数。
要求人工帮助，却只收到邮箱
这是当前支持方式：Agent 提供客服邮箱和联系指引，由用户通过该渠道联系团队。
如果邮箱缺失或错误，管理员应更新设置 → 反馈组件中的客服邮箱。若普通产品建议经常被引导给客服，检查联系规则是否写得过宽，参考配置并上线 Agent。