助手
扣子 AI 帮助与支持
你好,我是 扣子 文档问答助手 🎉 你在阅读当前文档的过程中,无论对文档概念的解释,还是文档内容方面的疑问,都可以随时向我提问,我会全力为你解答
推荐问题
如何快速了解这个空间的核心内容?
有哪些近期更新的重点文档?
我应该从哪些文档开始阅读?
文档反馈
扣子编程介绍
动态与公告
新手教程
开发
技能
集成服务
部署运维
管理项目

迁移空间

更新于: 2026-06-25 17:39:01

组织超管或管理员可以将本人拥有的工作空间迁移到企业的组织中,以便继续开发企业级应用。

功能简介

创建企业之后,组织超级管理员或管理员可以将扣子个人版工作空间中的资源、智能体和应用迁移到企业的工作空间中。迁移空间功能可以高效地完成资源迁移,确保升级过程平滑顺畅。迁移后空间 ID、智能体 ID 保持不变,不影响已发布的智能体或应用正常运行,也无需重新发布。
Image

迁移规则

分类

说明

迁移影响

  • 此操作为一次性、不可逆的迁移操作,迁移完成后,该空间及其中的所有资源均为企业的专属资源,无法复制或迁移到企业外的空间中。建议谨慎操作
  • 由于智能体等资源属于空间,API 方式创建的会话属于扣子用户,迁移空间之后,智能体无权限访问原个人账号下的会话,建议开发者创建新会话。创建方式可参考创建会话
  • 如需迁移自定义渠道,建议联系扣子技术支持获取支持和帮助。
  • 迁移后,智能体和应用的 ID 均不变。

迁移范围

  • 工作空间中已创建的智能体、应用、工作流、插件、知识库、数据库、卡片和提示词会同步迁移到企业中。如果某个资源的所有者未同步迁移,该资源的草稿版本不会被迁移;多人协作场景下,协作者未提交的个人草稿版本也不会被迁移。
  • 空间中指定的内部成员(子用户)和外部用户(访客)会同步迁移到企业中。

权限要求

从扣子个人版迁移到企业版、团队版,请确保你是空间的所有者

创建企业之后,你可以将之前已创建的工作空间迁移到新的企业中,这些工作空间中可享受企业版、团队版套餐的全部高级权益,工作空间中的成员也可以继续编排原有的智能体、使用已有的知识库等资源。

操作步骤

1 选择工作空间

  1. 扣子编程左下角单击个人头像,选择企业账号,然后单击对应组织的设置图标。
    Image

  2. 企业组织管理的顶部选择空间管理页签,单击右上角的迁移空间
    Image

  3. 选择工作空间页面,选择待迁移的工作空间,单击下一步
    仅支持迁移你作为空间所有者的工作空间。
    Image

  4. (可选)如果选择了个人空间,你需要在弹出的对话框中设置该个人空间迁移后的工作空间的名称,单击确认

2 确认非 API 资源

确认待迁移的非 API 资源,单击下一步
非 API 资源的迁移范围包括空间中所有智能体、应用、插件、工作流、知识库、卡片、音色、提示词。
Image

3 迁移 API 资源

确认空间中待迁移的 API 资源,选择迁移方式。

  • 如果页面提示没有待迁移的 API 资源,可以直接单击下一步
  • 如果待迁移的工作空间中已创建了个人访问令牌、OAuth 应用等 OpenAPI 资源,你需要根据名下的 API 授权选择迁移方式,再根据页面提示完成迁移。

选择迁移方式

扣子支持以下两种迁移方式,其对比说明如下:

迁移对比

一键授权

手动迁移

是否有损

  • 无需任何额外操作,线上服务无损迁移。
  • 原个人账号下已创建的会话仍会保留。
  • 原本的 Access Token 失效,需要重新授权 API,以避免影响线上服务。
  • 智能体无权限访问原个人账号下已创建的会话,建议开发者创建新会话。创建方式可参考创建会话

迁移限制

  • 不会移动 API,只是变更了 API 的授权范围,增加企业的访问权限。你仍需在个人账号 > API 管理中查看API 授权。
  • 仅支持 PAT 和 AuthAPP,不支持 OBO。

将所有授权类型的 API(OBO、PAT、AuthApp)全部剪切迁移,后续可在企业账号 > API 管理处查看和修改。

适用场景

适用于无需迁移 OBO 授权的场景,且开发者希望快速完成迁移、仍可访问原个人账号下已创建的会话。

需要手动修改代码中的授权逻辑,适用于具备一定开发背景的专业开发者。但该方式会将 API 授权迁移至企业账号下,便于后续的资源管理和维护。

一键授权

根据页面提示授权,允许企业访问个人版账号 API。Open API 不会迁移,仅增加企业的访问权限。

  • 注意事项:一键授权迁移方式不会迁移 OBO 授权,如果存在 OBO 类型的 API,请先参考OBO 授权场景 手动迁移 OBO 授权。
  • 操作步骤
    1. 根据页面提示选择一键授权即可。
      Image
    2. 后续确认待迁移的用户之后,系统会自动完成授权。

手动迁移

将空间中的所有 API 授权手动迁移到企业,选择该方式需逐一确认您已知悉风险。可通过提前授权方式降低对线上服务的影响。

  • 注意事项

    注意

    • 若未执行更新 API 授权步骤、直接选择手动迁移,会导致原有的 API 授权失效,线上用户调用 API 时会因鉴权失败而无法正常访问。
    • 如果智能体、应用或工作流已发布到生产环境且线上用户量较大,为保障平滑迁移,建议选择服务流量较少的时段(如深夜或凌晨)执行手动迁移。
  • 操作步骤
    1. 更新 API 授权,将空间中的所有 API 授权手动迁移到企业。
      详细操作步骤可参考文档升级企业版后更新 API 授权
    2. 返回迁移空间页面,根据页面提示选择手动迁移
      Image
    3. 选择待迁移的 API 授权,确认已知悉相关风险。
      Image

4 迁移用户

选择用户页面,从工作空间中已有的成员中选择要同步迁移的用户,并单击确认
迁移成功后,被选中的成员将自动加入组织中对应的工作空间,并同步成为组织成员。支持将内部用户(子用户)和外部用户(访客)加入组织。
Image

说明

如果企业超级管理员和管理员设置了禁止访客加入企业,迁移空间时无法选择外部用户(访客)。迁移空间成功后,外部用户会自动退出此工作空间,其拥有的资源也会自动转让给空间所有者。