维护的目标是让线上版本可观察、可停止、可迭代,同时不把内部 API 或尚未开放的控制能力伪装成开发者功能。

上线后的最低验收

  1. 确认 Online

    Agent 详情页显示 Online;仅有“发布成功”不足以证明正在供给。

  2. 从公开页进入正式客户端

    使用发布结果的 user_agent_url,或在官网公开 Agents 列表按准确名称找到并核对 Agent。点击 Use in ChatGPT,或从右侧菜单选择 Use in Claude/Use in WorkBuddy,按安装弹窗进入一个实际客户端。不要自行用内部 Agent ID 拼公开 URL。

  3. 发起真实调用

    安装后先在该客户端按准确名称搜索/选择当前 Agent,并核对说明与开发者身份;通用安装弹窗本身不绑定当前 Agent。然后覆盖一个最小正常请求并检查最终输出。若承诺文件、图片或其他 artifact,必须实际打开或下载验证;公开页或安装入口缺失时记录为 BLOCKED,而不是改用 WebChat 代替。

  4. 记录可复现证据

    记录版本号、调用时间、输入类型、可见结果和失败码;Token、Cookie、私钥和完整 SSH 命令中的敏感部分必须打码。

暂停新调用

需要维护、发现高风险缺陷或不再提供服务时,在已发布版本页面点击 Take Offline,并等待页面确认 Offline。Offline 表示停止接受新的正式调用,不等于删除 Agent、版本或历史记录。

先下线,再处理高风险故障

如果当前行为可能造成错误交付、异常成本或数据风险,先使用页面的 Take Offline 停止新流量,再定位问题。

发布新版本

对已发布程序做功能变更时,应通过开发者页面提供的版本入口创建或编辑草稿版本,重新完成 Workspace 开发、WebChat 测试、Agent Card/MOM/Pricing 校验以及 Publish。不要在文档里假设发布后仍可直接改写线上快照。

Workspace 生命周期的当前边界

能力当前公开入口该怎么做
创建 Workspace网站引导 + CLI workspace create以目标 Version ID 和已确认来源创建,并等待 active
查询/连接 WorkspaceCLI workspace status/connectstatus 只查生命周期;以 connect 的 bound + ssh_verified=true 作为 SSH 完成门
续签短期连接CLI workspace resume只在明确继续使用同一 active + expired Workspace 时执行;不新建 Sandbox
关闭 Workspace当前没有网站按钮或 CLI 命令不要猜测内部 API,也不要编造 workspace close
配置 WebUI 端口CLI 0.7.3 version webui-ports get/set/refresh官网无表单;set 整体替换,refresh 保留端口换新链接,同时验证 sync/proxy 状态
不要把端口更新当成业务启动或永久链接

sync_status=ready 只表示端口声明同步,proxy_status=ready 只表示当前代理元数据有效;两者都不证明业务 HTTP 健康。当前仍没有公开 Workspace close 命令,不得绕过控制面调用内部接口。

Workspace 过期或进入终态

CLI 返回的 expires_at 是短期连接期限。active + expired 时,开发者明确继续使用后可 resume,再用 connect 验证 SSH;接近到期时先保存并核对 /oasn 中的工作。以下终态不能继续作为开发环境使用:

定期回归清单