维护的目标是让线上版本可观察、可停止、可迭代,同时不把内部 API 或尚未开放的控制能力伪装成开发者功能。
Agent 详情页显示 Online;仅有“发布成功”不足以证明正在供给。
使用发布结果的 user_agent_url,或在官网公开 Agents 列表按准确名称找到并核对 Agent。点击 Use in ChatGPT,或从右侧菜单选择 Use in Claude/Use in WorkBuddy,按安装弹窗进入一个实际客户端。不要自行用内部 Agent ID 拼公开 URL。
安装后先在该客户端按准确名称搜索/选择当前 Agent,并核对说明与开发者身份;通用安装弹窗本身不绑定当前 Agent。然后覆盖一个最小正常请求并检查最终输出。若承诺文件、图片或其他 artifact,必须实际打开或下载验证;公开页或安装入口缺失时记录为 BLOCKED,而不是改用 WebChat 代替。
记录版本号、调用时间、输入类型、可见结果和失败码;Token、Cookie、私钥和完整 SSH 命令中的敏感部分必须打码。
需要维护、发现高风险缺陷或不再提供服务时,在已发布版本页面点击 Take Offline,并等待页面确认 Offline。Offline 表示停止接受新的正式调用,不等于删除 Agent、版本或历史记录。
如果当前行为可能造成错误交付、异常成本或数据风险,先使用页面的 Take Offline 停止新流量,再定位问题。
对已发布程序做功能变更时,应通过开发者页面提供的版本入口创建或编辑草稿版本,重新完成 Workspace 开发、WebChat 测试、Agent Card/MOM/Pricing 校验以及 Publish。不要在文档里假设发布后仍可直接改写线上快照。
N.N.N 版本号,并说明行为变化。succeeded + visible + Go Online + 公开页安装 + 真实调用。| 能力 | 当前公开入口 | 该怎么做 |
|---|---|---|
| 创建 Workspace | 网站引导 + CLI workspace create | 以目标 Version ID 和已确认来源创建,并等待 active |
| 查询/连接 Workspace | CLI workspace status/connect | status 只查生命周期;以 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 命令,不得绕过控制面调用内部接口。
CLI 返回的 expires_at 是短期连接期限。active + expired 时,开发者明确继续使用后可 resume,再用 connect 验证 SSH;接近到期时先保存并核对 /oasn 中的工作。以下终态不能继续作为开发环境使用:
failed:创建或运行失败;结合 failure_code 诊断。closed:Workspace 已关闭。published:该开发 Workspace 已因发布流程进入终态。cleanup_pending / close_pending:平台正在收尾;不要继续上传或执行。oasn-webui block 一致;链接换代后不再交付旧 URL。