# 常见问题

按您在界面上实际看到的提示语或现象组织的故障排查手册，每条说明出现场景、原因和解决步骤。

建议用浏览器的页内搜索（Ctrl+F / Cmd+F）直接搜您看到的报错文字。

**通用三招**（多数临时性问题适用）：① 刷新页面重试；② 退出登录后重新登录；③ 换个时间再试。三招无效再按下文逐条排查，仍无法解决时联系您机构的管理员。

**按功能域速查**：先确定您的问题属于哪个功能域，再跳到对应小节：

| 您的问题涉及…… | 请看小节 |
| --- | --- |
| 登录、密码、账号状态 | [登录与账号](#faq-login) |
| 发消息、附件、会话操作、导出 | [对话与会话](#faq-chat) |
| 数据源授权、密钥、授权过期 | [授权与数据服务](#faq-auth-data) |
| 添加机构自己的外部服务 | [添加外部服务（MCP / HTTP）](#faq-external-services) |
| 知识库、文档上传、表格导入 | [知识库](#faq-knowledge) |
| 技能导入、定时任务不执行 | [技能与定时任务](#faq-skills-schedules) |
| 权限确认条、通道绑定 | [权限与通道](#faq-permissions-channels) |
| 我的记忆、界面上找不到功能 | [其他](#faq-misc) |

## 登录与账号

**Q: 提示「用户未登录，请先登录」或「登录会话已过期，请重新登录」怎么办？**

- **出现场景：** 打开页面或操作到一半时弹出，随后被带回登录页。
- **原因白话解释：** 您的登录"有效期"到了。为了账号安全，登录状态不会永久有效，闲置较久或距上次登录时间过长就会失效；在别处重置过密码也会让当前登录立即失效。
- **解决步骤：** 重新登录即可。对话记录都在云端，重新登录后在「最近会话」里可以找回（见[对话与会话](/docs/workbench/chat-and-sessions.md)）。
- **相关章节：** [快速上手](/docs/workbench/quick-start.md)、[对话与会话](/docs/workbench/chat-and-sessions.md) 会话管理小节

**Q: 修改密码时提示「密码复杂度不满足要求：至少8位，必须包含大写字母、小写字母、数字和特殊字符」**

- **出现场景：** 在「用户设置」→「重置密码」窗口提交新密码时；同类提示还有「密码长度至少为 8 位」「密码必须包含大写字母」「密码不能包含用户名」「两次输入的密码不一致」等。
- **原因白话解释：** 新密码没有同时满足全部安全要求。
- **解决步骤：** 最省事的办法是点击密码框右上方的「自动生成」，系统会生成一个满足全部要求的随机强密码并自动填入两个输入框，抄录保存后直接提交。
- **相关章节：** [设置与记忆 – 用户设置](/docs/workbench/settings-and-memory.md#user-settings)

**Q: 提示「当前用户信息不存在，请联系租户管理员」或「用户不存在，请联系管理员」**

- **出现场景：** 登录后加载页面或执行操作时。
- **原因白话解释：** 您的账号在机构的用户名册里没有找到，多为账号被移除、尚未开通完成或机构配置变更所致。
- **解决步骤：** 这不是您操作的问题，请直接联系您机构的管理员核实账号状态。
- **相关章节：** [快速上手 – 登录](/docs/workbench/quick-start.md#login)

**Q: 登录后页面空白或提示无权限怎么办？**

- **出现场景：** 账号密码验证通过，但进入页面后一片空白，或提示没有权限访问。
- **原因白话解释：** 通常是您的账号权限尚未配置完成——账号虽已开通，但管理员还没有为它分配好可用的功能范围。
- **解决步骤：** 联系您所在机构的管理员，确认账号权限配置完成后重新登录。
- **相关章节：** [快速上手 – 登录](/docs/workbench/quick-start.md#login)

## 对话与会话

**Q: 对话没有响应 / 一直转圈怎么办？**

- **出现场景：** 发出消息后长时间没有任何文字出现。
- **原因白话解释：** 三种可能——任务本身复杂（专家正在多步查数分析，属正常）；网络不稳；或服务临时波动。
- **解决步骤：**
  1. 先看消息区有没有工具调用步骤在持续出现——有就是正在干活，复杂分析等几分钟属正常；
  2. 输入框如提示「智能体执行中，输入新的指令来调整方向...」，可以直接发一句"先停一下"或点停止；
  3. 确实卡死则刷新页面，回到该会话查看；仍异常可 Fork 一份会话或新开会话重试。
- **相关章节：** [对话与会话](/docs/workbench/chat-and-sessions.md)

**Q: 提示「智能体内核服务暂时不可用，请稍后重试」或「智能体内核服务连接失败，请稍后重试」**

- **出现场景：** 发消息或加载页面时弹出；同类提示还有「服务暂时不可用，请稍后重试」「网络异常，请检查网络后重试」。
- **原因白话解释：** 平台后台服务临时波动或您的网络不稳，就像电话占线，通常几分钟内自行恢复。
- **解决步骤：** 等待一两分钟后刷新重试；确认自己的网络正常（能打开其他网站）；持续超过十分钟不恢复，联系您机构的管理员。
- **相关章节：** [对话与会话](/docs/workbench/chat-and-sessions.md)

**Q: 提示「请等待附件上传完成」**

- **出现场景：** 附件还在上传时就点了发送。
- **原因白话解释：** 文件还没传完，专家还"没拿到"它。
- **解决步骤：** 等附件预览区的上传进度完成后再发送；大文件（接近单个 200MB 上限）需要更久。
- **相关章节：** [对话与会话](/docs/workbench/chat-and-sessions.md) 附件小节

**Q: 附件提示「文件 『xxx』 超过 200MB 限制」或附件数量超限**

- **出现场景：** 向对话添加附件时弹出大小超限提示，或附件数量达到上限无法继续添加（输入框上的计数显示为「50/50 附件」）。
- **原因白话解释：** 对话附件有两条限制——单个文件最大 200MB，单次最多发送 50 个附件。
- **解决步骤：** 超大文件请先拆分（如把大 Excel 按年份拆开）或压缩后再上传；附件数量超限则删减本次不必要的附件，或分多条消息分批发送。
- **相关章节：** [对话与会话](/docs/workbench/chat-and-sessions.md) 附件小节

**Q: 提示「会话不存在或已被删除」怎么办？**

- **出现场景：** 打开旧链接或点击某个会话时。
- **原因白话解释：** 这个会话已被删除（删除不可恢复），或链接指向的会话不属于当前账号。同类提示「无权访问该会话」则说明该会话属于其他用户。
- **解决步骤：** 在「最近会话」列表或会话搜索中确认会话是否还在；已删除的会话无法找回，只能新建会话重新开始。
- **相关章节：** [对话与会话](/docs/workbench/chat-and-sessions.md) 会话管理小节

**Q: 点会话菜单里的「Fork」提示「Fork 失败」**

- **出现场景：** 复制会话分支时。
- **原因白话解释：** 源会话必须处于"空闲"状态才能复制——专家还在这个会话里干活时不能复制。
- **解决步骤：** 等该会话当前任务执行完（或停止执行）后再 Fork；仍失败则刷新页面重试。
- **相关章节：** [对话与会话](/docs/workbench/chat-and-sessions.md)

**Q: 导出按钮是灰色的，提示「对话运行中，完成后可导出」**

- **出现场景：** 专家还在生成回复时尝试导出会话。
- **原因白话解释：** 内容还没生成完，现在导出会得到"半份"文档，所以系统暂时禁用了导出。
- **解决步骤：** 等本轮回复完成后导出按钮自动恢复。
- **相关章节：** [对话与会话](/docs/workbench/chat-and-sessions.md) 导出小节

## 授权与数据服务

**Q: 弹出「需要授权才能继续」怎么办？**

- **出现场景：** 对话中专家要查某个第三方数据源，但您还没授权过它。
- **原因白话解释：** 该数据源需要用您本人的凭证访问（像开通银行服务前要先签约），没授权它就取不了数。
- **解决步骤：** 点弹窗中的「去授权」，按[数据连接](/docs/workbench/data-connectors.md)的授权流程完成一次即可（之后不再询问）；暂时不想授权就点「稍后再说」，专家会跳过该数据源继续。
- **相关章节：** [对话与会话](/docs/workbench/chat-and-sessions.md) 数据源授权小节、[数据连接](/docs/workbench/data-connectors.md)

**Q: 提示「授权超时，请重新尝试」**

- **出现场景：** 点「去授权」后跳到数据提供方页面，但迟迟未完成操作；或授权窗口开着放了太久。
- **原因白话解释：** 授权像一次限时签约，页面开太久"签约单"就过期了。
- **解决步骤：** 关闭旧的授权窗口，回到点金 FinX 重新发起授权，这次尽快在跳转页面上完成登录和确认。
- **相关章节：** [数据连接](/docs/workbench/data-connectors.md)

**Q: 提示「请先完成授权后再启用」**

- **出现场景：** 想打开某个数据源的开关，但它还带着「需授权」标签。
- **原因白话解释：** 顺序反了——要先授权、再启用。
- **解决步骤：** 直接点击开关，会提示「该工具需先完成授权才能启用」并自动弹出授权窗口，按引导完成授权即可；也可点击「需授权」标签快速授权（对话面板中提示「该工具需先完成授权，点击「需授权」标签即可快速授权」），完成后再打开开关。若授权后提示「授权成功，但自动开启失败，请手动开启」，手动把开关打开即可。
- **相关章节：** [数据连接](/docs/workbench/data-connectors.md)

**Q: 提示「授权验证失败」或「凭证校验未通过，请检查后重试」**

- **出现场景：** 在「授权设置」中填写 API 密钥等凭证并保存时。
- **原因白话解释：** 您填的"钥匙"对不上锁——密钥抄错（多空格、少字符）、已过期或权限不足。
- **解决步骤：** 重新从数据服务商处复制密钥完整粘贴（注意首尾不要带空格）；确认密钥在服务商侧仍有效；仍失败则联系该数据服务商核实。
- **相关章节：** [数据连接](/docs/workbench/data-connectors.md)

**Q: 对话中提示某服务「xxx 的授权已过期，请在数据源设置中重新授权后重试」（xxx 为服务名）**

- **出现场景：** 之前授权过的数据源用着用着突然要求重新授权；同类提示还有「授权已过期或被撤销（invalid_grant），请重新授权」「授权链接已过期，请重新发起授权」。
- **原因白话解释：** 授权凭证有有效期，到期后系统会尝试自动续期；续不上（或您在数据提供方侧撤销了授权）就需要重新授权一次。
- **解决步骤：** 进入「数据连接」页面，找到该服务重新完成授权流程；如提示「xxx 的授权正在刷新中，请稍后重试」（xxx 为服务名），等一小会儿再发消息即可。
- **相关章节：** [数据连接](/docs/workbench/data-connectors.md)

## 添加外部服务（MCP / HTTP）

**Q: 添加 MCP 服务时提示「无法连接到 MCP 服务。请确认 Server URL 正确、服务已启动，并且当前网络可以访问。」**

- **出现场景：** 在「添加外部服务」中提交 MCP 配置后创建失败。同类失败提示还有两种：「连接 MCP 服务超时。请检查服务状态或适当延长超时时间后重试。」和「MCP 服务拒绝了本次访问。请检查认证方式和凭证是否正确。」
- **原因白话解释：** 三种提示分别对应"打电话没人接"（地址错或服务没开）、"电话一直没接通"（网络不通或对方响应过慢）、"接了但拒绝服务"（身份凭证不对）。
- **解决步骤：** 对照提示逐项检查——地址是否抄对、对方服务是否在运行、认证方式和凭证是否正确。这类配置通常由服务商或技术同事提供，建议把报错原文发给他们核对。
- **相关章节：** [数据连接](/docs/workbench/data-connectors.md)

**Q: 添加服务时提示「JSON 格式无效，请检查后重试」或「未找到有效的 MCP Server 配置」**

- **出现场景：** 粘贴 MCP 配置文本后提交。
- **原因白话解释：** 粘贴的配置文本不完整或格式被破坏——常见于复制时漏了开头结尾的花括号，或中间被聊天软件改了引号格式。
- **解决步骤：** 回到配置来源（服务商文档或技术同事）重新完整复制一遍，确保从第一个 `{` 到最后一个 `}` 原样粘贴。
- **相关章节：** [数据连接](/docs/workbench/data-connectors.md)

## 知识库

**Q: 文档状态显示「生成失败」**

- **出现场景：** 上传到知识库的文档，摘要树生成结束后状态为「生成失败」。
- **原因白话解释：** 系统"读"这份文档时出了问题——文件损坏、内容是扫描图片无法识别、或处理资源临时紧张。
- **解决步骤：** 在文档行的三点菜单中点「重建」重试一次，多数情况可解决；仍失败则检查文件本身能否正常打开，扫描件建议先转成可选中文字的 PDF 再上传。状态显示「等待资源」则只是排队，稍候即可。
- **相关章节：** [知识管理 – 重建索引](/docs/workbench/knowledge.md#rebuild-index)

**Q: 删除知识库时弹出「知识库正在被引用」**

- **出现场景：** 删除某个知识库时弹出第二重确认，列出「该知识库已被以下智能体启用」及专家名单；对应的接口报错文案为「知识库正在被智能体使用中，无法执行此操作」。
- **原因白话解释：** 还有专家正在引用这个库，直接删会影响它们的回答质量，系统多问一遍防止误删。
- **解决步骤：** 确认这些专家确实不再需要该库后，点「仍要删除」（删除后自动从这些专家中移除）；拿不准就先取消，用「智能体引用」开关逐个停用观察影响。
- **相关章节：** [知识管理 – 删除文档 / 知识库](/docs/workbench/knowledge.md#delete)

**Q: 上传文档提示「文件大小超过 100MB 限制」或「不支持的文件类型」**

- **出现场景：** 向知识库上传文件时。
- **原因白话解释：** 知识库单文件上限 100MB，且仅支持 PDF、DOC、DOCX、TXT、MD、JPG、PNG、XLSX、CSV、XLS 格式。
- **解决步骤：** 超大文件请拆分或压缩；不支持的格式先转换（如 PPT 导出为 PDF）。注意：对话附件的上限是单个 200MB，与知识库的 100MB 是两回事。
- **相关章节：** [知识管理 – 上传文档](/docs/workbench/knowledge.md#upload-documents)

**Q: 表格导入提示「请至少配置一个标题列」或「请至少保留一个列映射」**

- **出现场景：** 向知识库上传 XLSX / CSV / XLS 表格，在「导入表格」窗口点「保存并导入」时。
- **原因白话解释：** 列映射配置不合法——前者是没有任何一列被设为「标题」，系统无法建立索引结构；后者是所有列都被设成了「不导入」，等于什么都没导。
- **解决步骤：** 至少把一列设为某级「标题」（QA 类表格建议问题列设为标题），并保留正文列（如答案、条款说明列设为「正文」）；如果示例数据显示乱码或错位，先调整「表头行」和「数据起始行」，点「重新解析」后再配置列映射。
- **相关章节：** [知识管理 – 表格文件导入与列映射配置](/docs/workbench/knowledge.md#table-import)

## 技能与定时任务

**Q: 导入技能提示「导入失败，请检查文件格式」**

- **出现场景：** 在「技能管理」页导入 .zip 技能包时；同类提示还有「请选择 .zip 格式的文件」「文件大小超过 200MB 限制」。
- **原因白话解释：** 文件不是合规的技能压缩包——格式不对、超过 200MB，或包内结构不符合技能规范。
- **解决步骤：** 确认文件为 .zip 且在 200MB 以内；仍失败请联系提供该技能包的管理员检查包内结构。
- **相关章节：** [技能 – 导入技能](/docs/workbench/skills.md#import-skill)

**Q: 定时任务到点没有执行怎么办？**

- **出现场景：** 设置好的定时任务在预定时间没有产出。
- **原因白话解释：** 常见三种情况——任务被禁用了；一次性任务已执行完毕（状态归入「已结束」）；Cron 规则设置的日期当月不存在（配置时界面就提示过「部分月份不存在该日期，当月将跳过执行」）。
- **解决步骤：** 到「定时任务」页面检查该任务是否处于启用状态、「下次: 」时间是否符合预期；展开「执行历史」看有没有失败记录（红色状态点）；规则不对就点「编辑」修正。
- **相关章节：** [定时任务](/docs/workbench/schedules.md)

## 权限与通道

**Q: 屏幕上弹出「允许 / 拒绝」的确认条，不知道该点哪个**

- **出现场景：** 专家准备执行敏感操作（命中了"人工确认"类权限规则）时。
- **原因白话解释：** 这是您给专家立的"家规"在起作用——这类操作需要您先过目。
- **解决步骤：** 展开看清操作名称和参数详情：内容符合预期点「允许」，有疑虑点「拒绝」（专家会放弃该操作继续其他工作）。若某类操作反复弹确认且您每次都允许，可到「权限管控」把它调整为放行。
- **相关章节：** [对话与会话](/docs/workbench/chat-and-sessions.md) 权限确认小节、[权限管控](/docs/workbench/permissions.md)

**Q: 绑定通道提示「该渠道不属于当前应用空间，无法绑定」**

- **出现场景：** 在「通道集成」页面提交绑定时；同类还有笼统的「绑定渠道用户失败」。
- **原因白话解释：** 这个通道不是您所在机构应用配置的，账号与通道"不在一个单位"，系统拒绝跨机构绑定。
- **解决步骤：** 确认您登录的是正确的机构账号；问题依旧请联系管理员核实通道归属。「绑定渠道用户失败」则先检查粘贴的通道用户 ID 是否完整正确（用 `/me` 命令重新获取一次），再重试。
- **相关章节：** [通道集成 – 绑定通道](/docs/workbench/channels.md#bind-channel)

**Q: 绑定个人微信时提示「获取二维码失败」**

- **出现场景：** 打开「绑定个人微信」窗口后二维码没有出现。
- **原因白话解释：** 生成二维码的服务临时波动或网络不稳；个人微信通道本身是 Beta 试用功能，稳定性弱于正式通道。
- **解决步骤：** 等待倒计时结束后点「刷新二维码」重试；反复失败请改用钉钉 / 飞书等正式通道，并联系管理员反馈。
- **相关章节：** [通道集成 – 个人微信通道（Beta）](/docs/workbench/channels.md#personal-wechat)

## 其他

**Q: 我的记忆页面提示「加载记忆内容失败」**

- **出现场景：** 打开「我的记忆」页面时内容区显示红色错误提示。
- **原因白话解释：** 拉取记忆内容时网络或服务临时波动。
- **解决步骤：** 点提示旁的「重试」按钮；无效则刷新页面。记忆内容存在云端，加载失败不代表丢失。
- **相关章节：** [设置与记忆 – 我的记忆](/docs/workbench/settings-and-memory.md#my-memory)

**Q: 改坏了记忆 / 误删了记忆内容怎么办？**

- **出现场景：** 编辑「我的记忆」后发现删错了内容。
- **原因白话解释：** 不用慌——每次变更系统都自动留了"快照"。
- **解决步骤：** 在「我的记忆」页面右侧辅助面板的「记忆演化历史」中找到出错前的版本，查看详情后点「恢复此版本」，提示「已恢复至 vN」即可。
- **相关章节：** [设置与记忆 – 我的记忆](/docs/workbench/settings-and-memory.md#my-memory)

**Q: 手册里提到的某个功能，我的界面上找不到**

- **出现场景：** 对照手册操作时找不到对应按钮或页面。
- **原因白话解释：** 部分功能受您所在机构的配置和专家的能力开关控制，未开通的功能不会显示，属正常情况。
- **解决步骤：** 先确认当前专家的能力开关（见[智能体管理](/docs/workbench/experts.md)）；仍没有则联系您机构的管理员确认功能开通情况。
- **相关章节：** [智能体管理](/docs/workbench/experts.md)

## 下一步

- 界面名词不熟悉：[术语表](/docs/workbench/glossary.md)
- 从头系统了解产品：[快速上手](/docs/workbench/quick-start.md)