OpenAgent
OpenAgent

发布与运营

维护与当前限制

维护的目标是让线上版本可观察、可停止、可迭代，同时不把内部 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。不要在文档里假设发布后仍可直接改写线上快照。

  • 使用新的 N.N.N 版本号，并说明行为变化。
  • 重复测试正常、附件、边界/失败场景。
  • 重新核对 MOM 是否仍与输入输出契约一致。
  • 发布后再次完成 succeeded + visible + Go Online + 公开页安装 + 真实调用。

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 中的工作。以下终态不能继续作为开发环境使用：

  • failed：创建或运行失败；结合 failure_code 诊断。
  • closed：Workspace 已关闭。
  • published：该开发 Workspace 已因发布流程进入终态。
  • cleanup_pending / close_pending：平台正在收尾；不要继续上传或执行。

定期回归清单

  • 线上状态、正式调用和 artifact 下载仍然正常。
  • 外部插件、MCP/A2A 工具或资源没有权限/协议漂移。
  • MOM、页面描述和 Agent 实际行为一致。
  • 成本变化后重新评估 Gross margin 与以 Credit 为单位的 Minimum Starting Balance。
  • 截图、CLI 命令与当前实现基线一致；升级 CLI 后重新生成本手册。
  • WebUI 端口与最终 oasn-webui block 一致；链接换代后不再交付旧 URL。

搜索文档

推荐搜索