官网是 Agent、版本及发布状态的管理入口。本节只完成“登录 → 创建 Agent → 进入首个 draft”，不会在本机或远程 Workspace 写入任何 Program 文件。

1. 登录官网

  1. 打开登录页

    访问 OpenAgent 登录页。当前官网界面提供 Google 与 Apple 登录入口。

  2. 使用将长期维护 Agent 的账号

    Agent、draft、发布记录和上线状态都属于当前 Owner。不要为了临时测试切换到另一个账号，否则后续 CLI 登录可能无法访问这个版本。

  3. 确认回到官网

    授权结束后应返回官网并显示已登录状态。若授权页报错或回调未完成，重新从官网发起登录；不要向本地 AI、文档或命令行提供 OAuth code、Cookie 或 Token。

OpenAgent 官网登录页，提供 Google 与 Apple 登录入口
官网登录。 选择自己的 Owner 账号完成授权。截图使用公开页面与脱敏测试状态。
官网会话与 CLI 会话不是同一份凭据

CLI 在首次需要平台权限时会单独打开浏览器完成安全登录。不要从浏览器提取凭据给 CLI；CLI 会自行完成 loopback、state、PKCE 和一次性 code 校验。

2. 创建 Agent 和首个 draft

  1. 进入 Developer

    从官网进入 Developer，打开 My OpenAgents。这里列出当前账号拥有的 Agent，而不是所有公开 Agent。

  2. 点击 Create

    当前实现会在一次操作中创建 Agent 与它的第一个 draft 版本，然后直接导航到版本工作台。无需先创建空 Agent、再单独创建版本。

  3. 确认编辑对象

    检查浏览器地址已进入 /developer/agents/<agentId>/versions/<versionId>，工作台状态是 draft。URL 中的 ID 仅用于辨认上下文，不要手工改写。

Developer 的 My OpenAgents 页面及 Create 操作
My OpenAgents。 从这里创建新 Agent，或进入已有 Agent 继续维护版本；截图数据均为示例。

3. 设置版本号

版本标签采用严格的三段数字格式：

示例是否有效原因
0.1.0有效三段，每段 1 位数字
12.3.45有效三段，每段 1–2 位数字
v1.0.0无效不能带 v 前缀
1.0无效缺少第三段
100.0.0无效第一段超过 2 位
1.0.0-beta无效当前格式不接受后缀

建议首次实验使用 0.1.0。版本号用于区分交付，不等于 agent_version_id；后者是平台分配的唯一 ID。

4. 识别 Agent 与版本上下文

创建了错误账号下的 Agent？

立即停止后续构建，切回正确 Owner 再创建。不要通过猜 ID、改 URL 或复用另一个账号的 CLI session 继续；平台会按 Owner 权限校验访问。

创建阶段完成标准

继续：认识版本工作台。