发布和上线是两个动作

发布完成后的版本默认是 Offline。只有随后点击 Go Online,Agent 才能接受新的正式调用。

发布前最后检查

发起 Publish

  1. 点击 Publish

    在版本工作台检查发布确认框列出的版本和配置,不要把“可以打开确认框”当作“已发布”。

  2. 确认发布

    确认后页面创建异步 Publish Job。保持页面打开并观察状态,或稍后回到同一版本继续查看。

  3. 等待双重完成条件

    只有 Job 为 succeeded 且 publication 为 visible,才表示发布链路完整完成。

发布确认对话框
发布确认:提交前再次核对目标版本;截图中的 Agent 数据已脱敏。
发布任务进度界面
异步进度:不要在 queuedrunning 时重复创建发布任务。

Publish Job 状态

状态含义开发者动作
queued任务已入队,尚未开始等待,不要重复提交
running发布阶段正在执行继续观察当前任务
succeededJob 阶段成功还要确认 publication 为 visible
failed任务以失败终止记录失败阶段/错误,修复草稿后再发布
canceled任务已取消确认取消原因,必要时重新发起

Publication 状态

状态含义是否完成
pending等待同步到可见目录
syncing正在同步发布事实
visible发布内容已可见是,但仍默认 Offline
failed可见性同步失败
不能只看一个绿色状态

job.status=succeeded 但 publication 仍是 pendingsyncing 时,发布还没有完整结束;必须等到 publication_status=visible

从 Offline 切换到 Online

  1. 确认发布成功且可见

    版本状态应显示为已发布,Publish Job 为 succeeded,publication 为 visible

  2. 点击 Go Online

    发布后的初始版本/UI 状态为 Offline。点击 Go Online 并等待页面确认 Online;排查 API 时,版本 status=online 与 Agent supply_status=listed 是不同字段。

  3. 做一次正式调用验收

    打开发布完成结果给出的 user_agent_url;若当前页面没有展示该链接,就回到官网公开 Agents 列表,按 Agent 的准确名称搜索,核对名称、说明与开发者身份后打开。公开路由由平台使用 public slug 生成,不要把内部 agent_id 自行拼成 URL。

  4. 安装到一个实际客户端

    在公开 Agent 页点击 Use in ChatGPT;需要其他客户端时展开分裂按钮右侧菜单,选择 Use in ClaudeUse in WorkBuddy。按安装弹窗完成接入,不要复制内部 API、Token 或开发 Workspace 的 WebChat URL作为正式入口。

  5. 提交代表性请求并核对结果

    安装完成后,先在客户端搜索或选择当前公开 Agent,并用准确名称、说明和开发者身份再次核对,不能默认通用安装弹窗已经绑定当前 Agent。然后提交一个最小正常请求,检查最终文本;若 Agent 承诺文件、图片或其他 artifact,还要实际打开或下载。结果应与开发态 WebChat 契约一致,但必须以这次正式调用本身为验收证据。

公开入口缺失时不能宣布完成

succeeded + visible + Online 后仍找不到正确公开 Agent,或安装弹窗/目标客户端不可用时,把正式验收记录为 BLOCKEDNOT TESTED 并报告可见状态与时间;不要猜 slug,也不要用 Workspace WebChat 结果代替。

发布后 Offline 状态以及 Go Online 操作
上线门:截图显示发布成功后的 Offline 与 Go Online。完成上线后,页面会提供 Take Offline 用于停止新调用。
真正完成的判定

succeeded + visible + Online + 从公开 Agent 页安装到实际客户端 + 一次真实调用成功。缺少任何一项,都不应向调用方宣布上线完成。