For AI agents: the complete documentation index is available at /apps-plugin/docs/llms.txt, the full documentation bundle is available at /apps-plugin/docs/llms-full.txt, and this page is available as Markdown at /apps-plugin/docs/release/beta-and-launch.md.

内测与上线

提示

审核通过(reviewed)后,版本还不会直接对所有人开放,而是先进入内测:只让一批你指定的用户提前体验,用真实使用场景做最后一轮验证,确认没问题再上线。

提交内测

提交内测名单

当版本处于"审核完成",配置预览页右上角的按钮会变成"提交内测"。点击后会弹出一个配置浮层,让你填写内测用户名单。名单以用户 UID 的形式提供,支持两种方式:

  • 手动输入:直接在浮层里逐个填入 UID,适合少量内测用户。
  • 上传文件:上传一个包含 UID 的 CSV 文件,适合批量导入。

填好后点击"确认提交",版本进入 testing。此时只有名单内的用户能在豆包里看到并使用这个版本,名单之外的用户不受影响。

提示

提交内测时,如果 UID 格式不正确或名单为空,系统会拦截并报错。请确认名单内容无误后再提交。

内测阶段做什么

内测的目的是在有限范围内暴露问题,而不是大范围推广。建议在这个阶段:

  1. 覆盖典型使用场景,尤其是当初梳理的核心 Query,确认模型能正确调用工具、卡片渲染正常。
  2. 关注真实环境下的表现,比如响应速度、异常情况的处理、登录与支付链路是否顺畅。
  3. 收集内测用户反馈,如发现问题,回到开发阶段修复后重新提审,敏捷修复。

正式上线

内测验证通过后,由管理员确认将版本推向正式上线,版本进入 production。至此,所有符合条件的豆包用户都能正常使用你的应用插件。

上线后,你在开发者平台可以持续查看这个版本的运行情况和审核报告。当需要发布新功能或修复问题时,重新创建一个新版本,再走一遍"开发 → 提审 → 内测 → 上线"的完整流程即可——线上版本在新版本上线前保持稳定服务,不受影响。

版本管理

开发者平台的"版本管理"页是你管理所有版本的中枢。每个应用插件可以有多个版本并存,各自处于不同状态(例如同时有一个 production 的线上版本和一个 staging 的在研版本)。

在版本管理页,你可以:

能力说明
版本列表按时间线查看该应用插件的所有版本,以及每个版本当前所处的状态(开发中 / 审核中 / 已通过等)、更新时间、产物包大小等信息。
版本详情进入某个版本查看其配置预览、审核报告与提审包元信息。
版本对比对比不同版本之间的差异,便于确认改动内容。
撤回在版本尚未推进到不可逆节点前,撤回本次提交。
回滚当线上版本出现问题时,回退到此前的稳定版本。
提示

建议采用清晰、递增的版本号(如 v1.1.0、v1.2.0、v1.3.0),并在每次提交时简要记录本次改动,方便团队协作和后续排查。

关于灰度发布

灰度发布,是指在正式全量上线之前,先让一小部分线上用户使用新版本,确认稳定后再逐步扩大范围。它比内测更进一步——面向的是真实线上流量,而不是预先指定的名单。

灰度能力(按比例逐步放量、依据线上表现动态调节放量速度等)会在后续版本中提供,Q3 内陆续开放。在此之前,请把内测阶段作为上线前的主要验证手段,尽量在内测中覆盖充分,以降低全量上线的风险。