You need to enable JavaScript to run this app.
导航
复制基础版资源到专业版
最近更新时间:2024.08.14 15:28:41首次发布时间:2024.08.07 15:54:19

扣子基础版和专业版是两套不同的账号体系,开通扣子专业版之后,如需使用扣子基础版中已经搭建的 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. 准备账号。

    账号类型

    说明

    专业版账号

    准备一个扣子专业版账号或子用户。
    资源复制为一次性的批量操作,不支持重试,建议先使用子用户进行测试,确认所需资源可全量无损迁移,再正式复制到主账号,便于后续的资源与权限管理。
    主账号创建子用户并授权的操作步骤可参考1 主账号创建扣子专业版子用户并授权

    基础版账号

    待复制的 Bot 所在的基础版账号。你需要提前在扣子平台个人信息页面查看基础版账号的用户名。
    图片

  2. 在基础版账号中准备待复制的资源。

    注意

    复制前,应查看文档复制范围了解复制操作的复制范围。如果你需要复制基础版中未绑定 Bot 的插件、知识库、图像流、工作流或卡片,可以提前创建一个复制专用的测试 Bot,并绑定这些资源。

  3. (可选)在专业版账号中创建团队空间。
    如果需要把 Bot 复制到专业版的团队空间中,应提前创建一个团队空间。

步骤二:复制 Bot 到专业版

  1. 登录专业版账号生成授权链接。
    1. 使用专业版账号登录扣子平台。
    2. 在左侧导航栏中单击扣子专业版,并在弹出页面中单击基础版资源复制
      图片
    3. 选择待复制的资源所在的基础版账号,并设置目标空间。
      资源复制功能会一次性将基础版账号中的 Bot 及绑定资源一起复制到指定的空间中。关于复制范围的详细说明可参考复制范围
    4. 单击生成授权链接,并复制授权链接。
      此链接 3 天内有效,失效后你需要参考以上步骤重新生成授权链接。
      图片
  2. 登录基础版账号同意授权,并启动复制。
    1. 使用基础版账号登录扣子平台。
    2. 访问步骤二中复制的授权链接,并在弹出页面中单击授权

      注意

      授权后,资源复制任务将立即执行且无法撤回。复制操作为一次性的批量操作,每个专业版账号仅限复制一次,且不支持重试。

      图片
    3. 复制完毕后,你可以在首页中收到复制完毕的消息提醒。
      如果有 Bot 或资源复制失败,消息提醒中会有相关提示。常见报错的原因及解决方案可参考常见报错信息。关于复制范围的详细说明可参考复制范围
      图片

步骤三:编排并调试 Bot

复制资源后,你需要在专业版账号下检查复制出的 Bot 的编排、相关资源是否已全部迁移,也可以在调试区域和 Bot 对话,对比 Bot 在复制前后的回复,确定专业版 Bot 的编排与对话表现和基础版中基本一致。

步骤四:重新发布 Bot

复制 Bot 不会影响原 Bot 的发布和使用,但是你如果希望在 Bot 商店、飞书、微信或其他渠道使用专业版 Bot,需要在专业版中重新发布 Bot。

说明

如果你已经在基础版中通过 API 或 SDK 使用 Bot,复制后也需要重新发布 Bot 为 API、SDK,并修改请求中的 Bot ID、SDK 代码中的 Version。

常见问题

为什么看不到“基础版资源复制”的按钮?

暂不支持基础版账号之间、专业版账号之间的资源迁移,仅支持将基础版资源迁移至专业版账号中。此外,每个专业版账号只能迁移一次。你可以通过以下步骤自检并排查:

  1. 确认当前登录账号是否已开通专业版。
    你可以在扣子平台左下角查看专业版开通状态。如果扣子专业版处显示已生效,表示当前登录账号已开通扣子专业版。
  2. 确认当前专业版账号是否已从基础版中复制过一次资源。
    如果当前专业版账号已复制过一次资源,则无法再次从基础版账号中复制资源。你可以查看账号主页的消息记录,如果历史消息记录中存在“资源复制开始”、“资源复制完成”等关键字,表示此专业版账号曾从基础版中复制过资源,无法再次复制。
    图片

为什么我的 Bot 没有复制到专业版?

部分资源暂不支持复制到专业版,例如团队空间中其他人拥有的 Bot、未绑定 Bot 的知识库等资源。暂不支持复制的资源可查看暂不支持复制的资源
如果你的资源属于可复制的范围,但未复制到专业版,可能是网络问题等原因导致复制失败,建议更换一个子用户后重试。

常见报错信息

复制扣子 Bot 到专业版的常见报错提示如下:

报错

说明

Bot不支持复制

  • 原因:多 Agent 模式 Bot 如果包含 Bot 节点,则不支持复制。
  • 解决方案:授权复制前,在基础版中手动复制出一个新的 Bot,并取消其中的 Bot 节点,这个新 Bot 可以复制到专业版中。复制后再参考基础版中的原 Bot,加上 Bot 节点。

插件%s复制失败,无插件权限或者需要重新绑定插件商店最新版本插件。

  • 原因:此插件为插件商店中,非本人创建的插件,仅限插件作者可复制;或者是插件商店中的官方插件。
  • 解决方案:在专业版的插件商店中找到此插件,并手动为 Bot 绑定插件。

插件xxx复制失败,关联卡片复制失败。

  • 原因:网络延迟等原因导致复制失败。
  • 解决方案:创建一个新的专业版子用户后重试。

触发器复制失败

  • 原因:网络延迟等原因导致复制失败。
  • 解决方案:创建一个新的专业版子用户后重试。

快捷指令复制失败

  • 原因:网络延迟等原因导致复制失败。
  • 解决方案:创建一个新的专业版子用户后重试。

系统异常

  • 原因:网络延迟等原因导致复制失败。
  • 解决方案:创建一个新的专业版子用户后重试。