常见问题
账户与空间
从哪里登录？
使用中国版平台 Hub。www.genispace.com 是产品与商务官网，不是应用控制台。
为什么看不到其他用户共享的资源？
检查当前空间、空间成员身份、资源访问策略和应用成员权限。绑定的数据、知识和工具还可能有额外权限。
协作空间使用量由谁付费？
从协作空间所有者的计费账户扣除。使用记录仍会标识实际发起请求的成员。
智能体与 Chat
对话型与任务型智能体有什么区别？
对话型智能体支持多轮交互、工具、确认和会话上下文。任务型智能体接收结构化输入，并为 API 和工作流返回经过校验的结构化输出。
GeniAssistant 和内置智能体是什么？
GeniAssistant 是平台助手。内置智能体是 Workbench Copilot、Knowledge Copilot 等专用能力，由平台定义，不是普通用户可编辑智能体记录。
Ask 与 Agent 模式有什么区别？
Ask 模式直接回答，不委托平台操作。Agent 模式可以使用授权检索和工具、请求确认并完成多步骤工作。两种模式都不能绕过权限。
执行时间轴会展示模型私有推理吗？
不会。时间轴展示用于理解系统实际操作的进度、工具调用、参数、证据、结果和校验事件。
/compact 有什么作用？
它总结较早的工作上下文，为后续对话释放空间，不会删除可见聊天历史或长期记忆。参阅上下文管理。
为什么智能体要求我选择？
已保存执行轮次缺少必要信息或确认。选择选项或填写自定义答案后点击继续，系统会恢复同一轮执行。
数据与知识
应该使用 Datasource 还是 Dataset？
对关系型数据库执行受控操作时使用 Datasource；管理 GeniSpace 记录并进行结构化、全文和语义搜索时使用 Dataset。
智能体应该选择哪种 Dataset 搜索？
- 精确字段值或 ID：结构化查询
- 字面关键词：全文搜索
- 语义、经历或跨语言相似性：向量搜索
向量 Top-K 是候选结果，不是满足硬性条件的证明。
插入记录后向量搜索为什么没有结果？
检查目标来源字段是否向量化、Embedding 是否成功、Dataset 绑定模型是否一致，以及过滤条件是否排除了所有记录。
Dataset 工具为什么提示 field ... not exist？
请求包含 Dataset Schema 中没有的输出或过滤字段。请使用 Schema 或 API 试验场模板。
应该使用 Dataset 还是知识库？
业务记录使用 Dataset；需要搜索和引用的文档使用知识库。两者的存储和权限契约不同。
Workbench 与行业解决方案
Workbench Copilot 修改会自动保存吗？
不会。Copilot 修改当前浏览器草稿。请核对画布并点击保存，测试运行态后再发布。
长内容为什么被裁剪？
固定高度组件应提供内部滚动。请检查配置高度、内边距以及渲染器是否设计为滚动，并测试桌面和手机布局。
对象数组可以不使用原始 JSON 编辑吗？
支持的记录编辑表单会将对象数组显示为结构化重复区块。如果字段仍显示 [object Object]，请检查组件是否使用结构化字段渲染，以及字段定义是否与 Dataset Schema 一致。
可以部署到现有空间吗？
如果您是目标空间所有者，可以部署。请阅读冲突警告并完成二次确认。需要严格隔离时应创建新空间。
行业升级会立即替换已发布 Workbench 吗？
不会。upgrade-safe 会创建可核对草稿，只有您发布新草稿后才替换当前发布版本。
计费
有哪些订阅计划？
计划代码可以包括 FREE、PERSONAL、PRO、TEAM 和 ENTERPRISE，但实际计划、价格、限制和周期以订阅页面为准。
内部 Embedding 调用是否计费？
Agent、Dataset、Worker 或其他服务通过平台模型网关并携带用户/空间上下文执行 Embedding 时，使用量会归属该账户和空间所有者。
API 与开发
在哪里创建 API Key？
从账户或控制台设置进入 API Key 管理。密钥显示时立即复制并安全保存。
是否提供 SDK？
提供。官方 JavaScript/TypeScript SDK 位于 genispace/sdk-javascript。
旧流式客户端为什么收到 HTTP 426？
交互型智能体流式调用要求当前 GeniSpace 协议和 SDK。请升级 SDK，不要继续手写旧 SSE 契约。
部署与支持
是否支持私有部署？
受支持的企业部署可以私有化，模型、域名、支付和额度政策可由组织管理。
如何报告问题？
请提供时间、版本、当前空间、应用、请求或执行 ID、完整错误和安全复现步骤。不要提供密码、API Key 或私密文档。