扣子基础版和专业版是两套不同的账号体系,开通扣子专业版之后,如需使用扣子基础版中已经搭建的 Bot、工作流、知识库等,可以手动将基础版账号中的资源一次性批量复制到专业版账号中。
注意
复制基础版资源到专业版之前,应仔细阅读复制说明及复制范围。
复制说明
复制基础版资源到专业版时,扣子会将指定基础版账号中所有符合要求的 Bot 及其绑定的所有资源一次性批量复制到专业版账号中。详细的复制范围说明可参考复制范围。
复制资源前,应注意以下事项:
- 每个专业版账号只能执行一次复制操作,即暂不支持多个基础版资源复制到一个专业版账号,但一个基础版账号可以复制资源到多个专业版账号中。建议先通过子用户测试复制操作,确认所有资源均可以按要求复制后,再通过主账号复制资源。
- 不支持基础版账号之间复制数据,或专业版账号之间复制数据。
- 如果部分资源复制失败,暂不支持重试。复制失败的常见原因是此资源不支持复制,常见报错信息可参考常见报错信息。你可以创建一个新的专业版子用户,解决问题后重新复制一次。
- 复制操作不会影响基础版账号中 Bot 的运行。
下图以基础版账号 @jone 复制资源至专业版账号 @jone1 为例。基础版账号 @jone 个人空间中的 Bot A 及绑定资源、团队空间中本人拥有的 Bot B 及绑定资源可被一次性批量复制到专业版账号 @jone1 的个人空间或团队空间中,但团队空间中其他人拥有的 Bot C、个人或团队空间中未绑定 Bot 的资源不会被复制到 @jone1 账号中。
一个基础版账号可以复制资源到多个专业版账号中,所以完成专业版账号 @jone1 的资源复制之后,可以再次执行复制操作,将基础版账号 @jone 的资源复制到专业版账号 @jone2 中。
复制前,应注意以下使用限制:
限制项 | 说明 |
---|
模型选择 | Bot 使用的模型默认替换为 Doubao-pro-32K。
复制到专业版的 Bot 只能使用专业版账号下已接入的方舟模型。专业版接入模型的操作步骤可参考为扣子专业版接入模型。 |
Bot 版本 | 仅复制 Bot 最新编辑版本。 |
分析数据 | 复制到专业版的Bot,其状态为从未发布过的草稿版本,因此分析页面各个看板无数据,你可在调试后发布 Bot。 |
复制范围
复制 Bot 到扣子专业版时,复制范围包括个人空间和团队空间中本人拥有的 Bot,以及 Bot 中已绑定的插件、工作流、图像流、知识库和卡片,暂不支持自定义设置复制范围。
可复制的资源
个人空间和团队空间中本人拥有的 Bot,包括:
- 单 Agent 模式的 Bot
- 多 Agent 模式且不包含 Bot 节点的 Bot
- 工作流模式的 Bot
说明
本人拥有的 Bot 指 Owner 为当前登录账号的 Bot,例如以下 Bot:
暂不支持复制的资源
- 团队空间中其他人拥有的 Bot、插件、工作流、图像流、知识库或卡片。若有需要,你可以手动复制出一个新的 Bot,这个新 Bot 可以复制到专业版。
- 未绑定 Bot 的插件、工作流、图像流、知识库或卡片。若有需要,可以提前创建一个复制专用的测试 Bot,并绑定这些资源。
- 多 Agent 模式且包含 Bot 节点的 Bot。若有需要,你可以在授权复制前,在基础版中手动复制出一个新的 Bot,并取消其中的 Bot 节点,这个新 Bot 可以复制到专业版中。复制后再参考基础版中的原 Bot,加上 Bot 节点。
- 插件商店中的官方插件、非本人上架的插件。你可以在 Bot 复制完成后,在专业版的插件商店中找到此插件,并手动为 Bot 绑定插件。
- 和专业版空间中已有工作流/图像流同名的工作流/图像流。若有需要,可以提前重命名工作流或图像流。
- 知识库中状态为处理中和处理错误的文档。若有需要,你可以等待知识库中文件处理完成后再启动复制。
操作步骤
步骤一:准备工作
准备账号。
账号类型 | 说明 |
---|
专业版账号 | 准备一个扣子专业版账号或子用户。
资源复制为一次性的批量操作,不支持重试,建议先使用子用户进行测试,确认所需资源可全量无损迁移,再正式复制到主账号,便于后续的资源与权限管理。
主账号创建子用户并授权的操作步骤可参考1 主账号创建扣子专业版子用户并授权。 |
基础版账号 | 待复制的 Bot 所在的基础版账号。你需要提前在扣子平台个人信息页面查看基础版账号的用户名。
|
在基础版账号中准备待复制的资源。
注意
复制前,应查看文档复制范围了解复制操作的复制范围。如果你需要复制基础版中未绑定 Bot 的插件、知识库、图像流、工作流或卡片,可以提前创建一个复制专用的测试 Bot,并绑定这些资源。
(可选)在专业版账号中创建团队空间。
如果需要把 Bot 复制到专业版的团队空间中,应提前创建一个团队空间。
步骤二:复制 Bot 到专业版
- 登录专业版账号生成授权链接。
- 使用专业版账号登录扣子平台。
- 在左侧导航栏中单击扣子专业版,并在弹出页面中单击基础版资源复制。
- 选择待复制的资源所在的基础版账号,并设置目标空间。
资源复制功能会一次性将基础版账号中的 Bot 及绑定资源一起复制到指定的空间中。关于复制范围的详细说明可参考复制范围。 - 单击生成授权链接,并复制授权链接。
此链接 3 天内有效,失效后你需要参考以上步骤重新生成授权链接。
- 登录基础版账号同意授权,并启动复制。
- 使用基础版账号登录扣子平台。
- 访问步骤二中复制的授权链接,并在弹出页面中单击授权。
注意
授权后,资源复制任务将立即执行且无法撤回。复制操作为一次性的批量操作,每个专业版账号仅限复制一次,且不支持重试。
- 复制完毕后,你可以在首页中收到复制完毕的消息提醒。
如果有 Bot 或资源复制失败,消息提醒中会有相关提示。常见报错的原因及解决方案可参考常见报错信息。关于复制范围的详细说明可参考复制范围。
步骤三:编排并调试 Bot
复制资源后,你需要在专业版账号下检查复制出的 Bot 的编排、相关资源是否已全部迁移,也可以在调试区域和 Bot 对话,对比 Bot 在复制前后的回复,确定专业版 Bot 的编排与对话表现和基础版中基本一致。
步骤四:重新发布 Bot
复制 Bot 不会影响原 Bot 的发布和使用,但是你如果希望在 Bot 商店、飞书、微信或其他渠道使用专业版 Bot,需要在专业版中重新发布 Bot。
说明
如果你已经在基础版中通过 API 或 SDK 使用 Bot,复制后也需要重新发布 Bot 为 API、SDK,并修改请求中的 Bot ID、SDK 代码中的 Version。
常见问题
为什么看不到“基础版资源复制”的按钮?
暂不支持基础版账号之间、专业版账号之间的资源迁移,仅支持将基础版资源迁移至专业版账号中。此外,每个专业版账号只能迁移一次。你可以通过以下步骤自检并排查:
- 确认当前登录账号是否已开通专业版。
你可以在扣子平台左下角查看专业版开通状态。如果扣子专业版处显示已生效,表示当前登录账号已开通扣子专业版。 - 确认当前专业版账号是否已从基础版中复制过一次资源。
如果当前专业版账号已复制过一次资源,则无法再次从基础版账号中复制资源。你可以查看账号主页的消息记录,如果历史消息记录中存在“资源复制开始”、“资源复制完成”等关键字,表示此专业版账号曾从基础版中复制过资源,无法再次复制。
为什么我的 Bot 没有复制到专业版?
部分资源暂不支持复制到专业版,例如团队空间中其他人拥有的 Bot、未绑定 Bot 的知识库等资源。暂不支持复制的资源可查看暂不支持复制的资源。
如果你的资源属于可复制的范围,但未复制到专业版,可能是网络问题等原因导致复制失败,建议更换一个子用户后重试。
常见报错信息
复制扣子 Bot 到专业版的常见报错提示如下:
报错 | 说明 |
---|
Bot不支持复制 | - 原因:多 Agent 模式 Bot 如果包含 Bot 节点,则不支持复制。
- 解决方案:授权复制前,在基础版中手动复制出一个新的 Bot,并取消其中的 Bot 节点,这个新 Bot 可以复制到专业版中。复制后再参考基础版中的原 Bot,加上 Bot 节点。
|
插件%s复制失败,无插件权限或者需要重新绑定插件商店最新版本插件。 | - 原因:此插件为插件商店中,非本人创建的插件,仅限插件作者可复制;或者是插件商店中的官方插件。
- 解决方案:在专业版的插件商店中找到此插件,并手动为 Bot 绑定插件。
|
插件xxx复制失败,关联卡片复制失败。 | - 原因:网络延迟等原因导致复制失败。
- 解决方案:创建一个新的专业版子用户后重试。
|
触发器复制失败 | - 原因:网络延迟等原因导致复制失败。
- 解决方案:创建一个新的专业版子用户后重试。
|
快捷指令复制失败 | - 原因:网络延迟等原因导致复制失败。
- 解决方案:创建一个新的专业版子用户后重试。
|
系统异常 | - 原因:网络延迟等原因导致复制失败。
- 解决方案:创建一个新的专业版子用户后重试。
|