OpenAgent
OpenAgent

开始使用

最小摘要 Agent 示例

下载中英文完整示例

可直接跟做：最小摘要 Agent。

示例不安装 npm/pip 包，不依赖 Plugin、MCP 或 WebUI，只用 AGENTS.md 约束 main 的行为，适合验证从 Program 到 WebChat 的最短闭环。

示例文件

minimal-summary-agent/
├── README.md       # 跟做说明
├── AGENTS.md       # 复制到 /oasn/AGENTS.md
├── avatar.png      # 上传到 Agent Card 的 1:1 PNG 示例头像
├── MOM.md          # 上传到官网 Agent Card
└── test-cases.md   # WebChat 最低测试集

离线包内路径：examples/minimal-summary-agent/。先完整阅读该目录的 README.md，再执行下面流程。

从空草稿到可测试 Program

  1. 创建 Agent 和版本草稿

    登录官网进入 My OpenAgents，点击 Create。版本号使用严格的 N.N.N 格式，例如 0.1.0。

  2. 连接本地 Agent

    在版本工作台点击 Build With Local Agent，复制完整可信提示词并原样交给支持的本地开发 Agent。提示词已经绑定当前 Agent 和 Version，不要删除或替换 ID。

  3. 选择来源、取得 active Workspace 并连接

    按 CLI 页面完成校验安装和 doctor，运行 workspace sources 并明确选择已有 Workspace、来源版本或 --fresh。创建/查询到 active 后运行 workspace connect；若没有现有 key，只有经明确同意才创建。以 ssh_binding_status=bound、ssh_verified=true 为 SSH 完成门。

  4. 把 AGENTS.md 安全同步到 /oasn

    把示例文件视为只读源，在系统临时目录创建副本。经单独同步授权后，使用本次成功 connect 结果的完整 SSH/SCP 信息，先上传到 /oasn/.oasn-staging/<run-id>/，SHA-256 一致后再应用为 /oasn/AGENTS.md。

  5. 用 WebChat 跑三类请求

    打开 CLI 返回的 WebChat URL，按示例 test-cases.md 依次测试正常文本、真实文本附件、缺失输入。记录实际回复，不把未执行项标为通过。

  6. 填写 Agent Card

    上传示例目录的 1:1 avatar.png，填写名称、说明、分类，并上传示例 MOM.md。MOM 包含 Use when、Inputs、Outputs 三个必需二级标题；生产 Agent 请换成具有使用权且不冒充平台官方身份的头像。

  7. 完成模型、资源与定价

    为 LLM 选择平台模型，并在 Resources 中选择一个可用 CPU 和一个可用 Memory 规格；本示例不需要额外 Plugin、MCP 或 A2A 集成。填写 0–100 的整数 cost-plus 毛利率，并填写以 Credit 为单位、非负的 Minimum Starting Balance 后保存草稿。

  8. 发布、上线、正式验收

    等待 succeeded + visible；版本默认仍是 Offline，先点击 Go Online。打开发布结果的 user_agent_url；若页面未展示，就从官网公开 Agents 列表按“最小摘要助手”的准确名称搜索并核对。点击 Use in ChatGPT，或从右侧菜单选择 Claude/WorkBuddy，按弹窗安装；安装后还要在实际客户端按“最小摘要助手”搜索/选择，并核对说明与开发者身份，再重跑代表性请求。找不到公开页、当前 Agent 或安装入口时记录为 BLOCKED/NOT TESTED，不能用开发态 WebChat 结果替代正式验收。

三条必测请求

用例提交内容预期行为
正常文本“请将下面内容压缩为 3 个要点：OpenAgent 版本先开发、再测试、发布后还需要上线。”返回简短摘要、1–3 个要点；不增加输入中没有的事实。
文本附件上传一个 UTF-8 文本或 Markdown 小文件，并请求“按文件内容给出摘要和关键事实”。明确基于本次附件总结；不扫描其他文件；结果与附件一致。
缺失输入“请帮我总结。”但不提供待总结文本或附件。请求用户补充文本或附件，不编造摘要，不声称已读取文件。

为什么这个示例足够作为起点

  • 业务价值、输入、输出和失败语义都能从一个文件读懂。
  • 没有额外依赖，排除了安装与系统包问题。
  • 既覆盖文本，也覆盖附件边界和缺失输入。
  • MOM 可直接用于当前官网必填的 Agent Card 流程。
  • 测试通过后，可一次只增加一种能力，并复用同一验收方法定位问题。

示例不是生产承诺。

它不包含 WebUI、MCP、A2A、外部网络、持久数据库或复杂文件生成。增加能力后，应按需要更新 Models 与 CPU/Memory，并在 Workspace 中实现相应扩展，为每项能力增加独立真实测试。

搜索文档

推荐搜索