内测与上线
审核通过(reviewed)后,版本还不会直接对所有人开放,而是先进入内测:只让一批你指定的用户提前体验,用真实使用场景做最后一轮验证,确认没问题再上线。
提交内测
提交内测名单
当版本处于"审核完成",配置预览页右上角的按钮会变成"提交内测"。点击后会弹出一个配置浮层,让你填写内测用户名单。名单以用户 UID 的形式提供,支持两种方式:
- 手动输入:直接在浮层里逐个填入 UID,适合少量内测用户。
- 上传文件:上传一个包含 UID 的 CSV 文件,适合批量导入。
填好后点击"确认提交",版本进入 testing。此时只有名单内的用户能在豆包里看到并使用这个版本,名单之外的用户不受影响。
提交内测时,如果 UID 格式不正确或名单为空,系统会拦截并报错。请确认名单内容无误后再提交。
内测阶段做什么
内测的目的是在有限范围内暴露问题,而不是大范围推广。建议在这个阶段:
- 覆盖典型使用场景,尤其是当初梳理的核心 Query,确认模型能正确调用工具、卡片渲染正常。
- 关注真实环境下的表现,比如响应速度、异常情况的处理、登录与支付链路是否顺畅。
- 收集内测用户反馈,如发现问题,回到开发阶段修复后重新提审,敏捷修复。
正式上线
内测验证通过后,由管理员确认将版本推向正式上线,版本进入 production。至此,所有符合条件的豆包用户都能正常使用你的应用插件。
上线后,你在开发者平台可以持续查看这个版本的运行情况和审核报告。当需要发布新功能或修复问题时,重新创建一个新版本,再走一遍"开发 → 提审 → 内测 → 上线"的完整流程即可——线上版本在新版本上线前保持稳定服务,不受影响。
版本管理
开发者平台的"版本管理"页是你管理所有版本的中枢。每个应用插件可以有多个版本并存,各自处于不同状态(例如同时有一个 production 的线上版本和一个 staging 的在研版本)。
在版本管理页,你可以:
建议采用清晰、递增的版本号(如 v1.1.0、v1.2.0、v1.3.0),并在每次提交时简要记录本次改动,方便团队协作和后续排查。
关于灰度发布
灰度发布,是指在正式全量上线之前,先让一小部分线上用户使用新版本,确认稳定后再逐步扩大范围。它比内测更进一步——面向的是真实线上流量,而不是预先指定的名单。
灰度能力(按比例逐步放量、依据线上表现动态调节放量速度等)会在后续版本中提供,Q3 内陆续开放。在此之前,请把内测阶段作为上线前的主要验证手段,尽量在内测中覆盖充分,以降低全量上线的风险。