跳到主要内容

故障排查

本页用于定位常见的用户侧问题。操作失败时，请先保留错误信息、发生时间、空间名称以及相关执行 ID 或请求 ID，再进行重试。

登录与空间访问​

无法登录​

  1. 打开正确的国内站点：GeniSpace Hub 或控制台。
  2. 核对邮箱、密码和登录方式。
  3. 使用找回密码后，在最新版 Chrome、Edge、Safari 或 Firefox 中重试。
  4. 如果页面反复跳转，请清除 genispace.cn 的站点数据后重新登录。

找不到应用或功能​

切换到目标空间，并检查成员身份和角色。应用、数据集、知识库、智能体、额度和权限都归属于空间；在一个空间中可见的功能，在另一个空间中不一定可用。

智能体与对话​

对话提示“426 Upgrade Required”​

刷新页面，让浏览器加载当前版本的流式客户端。如果仍然报错，请记录应用、智能体名称、浏览器控制台错误和发生时间。该错误表示页面与 Agent 流式协议版本不一致，重复提问无法解决。

工具已经执行，但看不到结果​

展开智能体消息中的执行过程。工具可能展示结构化结果、应用专属卡片或错误信息。需要执行操作时请确认处于 Agent 模式；Ask 模式只回答问题，不执行操作型工具。

如果执行过程只有笼统描述，可刷新一次。结构化结果仍未出现时，请提交工具名称和执行 ID。

智能体要求用户确认​

按要求单选或多选。现有选项都不合适时，在自定义答案输入框填写内容，然后点击继续。提交成功后表单会变为已完成状态；除非提交失败，不要再在消息输入框重复发送同一答案。

智能体重复调用工具或一直不结束​

停止本轮执行，并明确目标对象、期望结果和重要约束。询问数据集时，说明需要精确计数/筛选，还是语义匹配。如果同一个只读工具在没有新证据的情况下重复执行，请保留执行过程并反馈。

会话即将达到上下文上限​

使用 /compact 汇总较早的上下文，同时保留当前目标、已确认决定和工具证据。命令会显示上下文使用情况。压缩影响模型使用的上下文，不会删除界面中的历史消息。详见上下文管理。

数据集搜索与 API​

向量搜索没有返回记录​

  1. 确认数据集存在向量字段，且新增记录已经完成向量化。
  2. 确认使用的是向量搜索，而不是精确结构化筛选。
  3. 用更完整的能力描述扩大查询，不要只机械翻译一个关键词。
  4. 与全文搜索结果对照，并检查源记录。Top-K 只是最相近的若干条，不代表这些记录一定满足业务条件。

如果新插入的记录无法检索，请让空间管理员检查 Dataset 服务和嵌入模型配置。

查询提示“field not exist”​

输出字段或筛选条件引用了数据集 Schema 中不存在的字段。打开数据集 Schema 或 API 试验场，复制准确的字段名后重试。对象内部的嵌套属性不会自动成为顶层字段。

筛选表达式无法解析​

在 API 试验场中构造并测试筛选条件，使用数据集 Schema 支持的运算符和值类型，不要套用只适用于 SQL 的语法。按 ID 批量查询时，应使用类型安全的 ids 参数，不要手写 IN (...) 表达式。

API 试验场调用失败​

检查操作类型、数据集 ID、请求体、字段类型，以及删除操作的确认步骤。只有在试验场请求成功后，再使用生成的代码。详见数据源与数据集。

行业解决方案​

部署看起来已经超时​

行业解决方案部署是包含多个步骤的后台任务。请保持进度弹窗打开，或重新查看应用状态，不要重复发起部署。提供单步重试时，只重试失败步骤。

部署后的方案语言不正确​

请安装目标版本和语言的模板。模板标题、说明、样例数据、看板和工作流文案都跟随模板语言，部署完成后不会再逐条翻译业务数据。

已有工作台没有获得模板改进​

使用可用的升级操作。upgrade-safe 流程会创建新的草稿版本，不覆盖已发布版本。检查草稿并处理有意保留的本地定制后，再自行发布。

工作台​

Copilot 创建页面后无法打开​

Copilot 的修改会先进入本地草稿。等待画布和导航刷新，再保存工作台草稿。如果新页面仍提示找不到配置，请撤销该草稿操作并重试一次；重复出现时提交 Copilot 工具结果和页面 ID。

组件被截断，或选中外框过高​

选中组件并调整网格高度。工作流、表单等组件可能在分配高度内部滚动。发布前分别预览桌面和手机布局。如果重新选中后内容与外框仍不一致，请在反馈中附上截图和组件类型。

Sticky 筛选器滚动时抖动​

确认页面外围只有一个滚动容器，并在预览模式复测。不要把启用 sticky 的 Filter Panel 放在另一个带动画或独立滚动的容器中。如果发布页面仍然抖动，请提交浏览器、视口和页面 ID。

用户看不到修改​

保存只更新草稿，发布才会让版本生效。核对版本状态并发布正确的草稿。可以通过版本历史对比或恢复以前发布的配置。

知识库与电子书​

知识搜索失败或证据相关性较弱​

确认源文档已经处理完成，并且包含在智能体的知识范围内。使用有描述性的问题，不要只输入一个词。有引用时，打开原文片段核对答案。反复出现嵌入错误时，需要管理员检查模型可用性和空间额度。

电子书编辑内容丢失​

检查保存状态和版本历史，必要时恢复正确版本。编辑和发布是两个独立操作；自动保存的草稿不会自动成为已发布版本。

工作流与任务​

工作流没有启动​

检查工作流或任务是否启用、触发器是否激活，以及当前空间是否具备所需连接和权限。在执行记录中检查触发事件、节点错误、重试状态和并发限制。

执行被延迟​

任务可能因空间或 Worker 达到并发上限而等待。延迟重试是正常机制，可避免同一任务被重复执行。使用 execution ID 区分不同执行，以及同一消息的重新投递。

计费与额度​

如果模型或嵌入请求提示额度不足，请在控制台打开额度历史和订阅与用量。用量会计入请求关联的用户或空间所有者。充值或变更订阅后，刷新页面再重试。

提交问题​

使用控制台的反馈按钮，或打开 /report-issue。请提供：

  • 国内版或 Global 版，以及页面 URL；
  • 空间名称和受影响应用；
  • 发生时间和时区；
  • 完整复现步骤；
  • 适用时提供执行 ID、请求 ID、数据集 ID 或页面 ID；
  • 完整错误信息，以及已经隐藏敏感值的截图。

可在 /feedback-records 查看已提交记录。如需进一步帮助，请联系 support@genispace.com。