Open Agent Format
Open Agent Format,简称 OAF,是一套用目录结构和文件约定来描述智能体的开放工程格式。它不把智能体理解成一个孤立的提示词文件,而是把“智能体是谁、怎么启动、如何与用户交互、哪些能力可以复用”拆分成清晰的工程层次。
在 AIUI 中,Open Agent Format 不只是“描述规范”,也是把智能体落成可运行应用的骨架。你可以把它理解成:AIUI 基于 OAF,把智能体从静态说明扩展成了具备页面、组件、模块和可分发包的 AI-Native User Interface。
它到底是什么
如果只用一段文本描述智能体,通常很难回答这些工程问题:
- 智能体的身份、职责和行为边界写在哪里
- 应用从哪个入口启动
- 页面如何组织,用户最终会看到什么界面
- 可复用的组件、模块和资源如何拆分
- 这些能力如何在不同项目之间迁移和复用
Open Agent Format 解决的,就是这些信息的组织问题。它把智能体重新落回“文件系统”本身,让工程结构天然成为智能体定义的一部分。
换句话说,OAF 不是单个配置文件,而是一套面向工程的组织方式:
- 用
AGENTS.md表达智能体描述层 - 用
app.json和应用入口表达运行层 - 用
pages/表达页面和交互层 - 用
widgets/表达小尺寸独立界面 - 用
workers/表达跨页面共享的后台任务 - 用组件、模块与 Package 表达复用层
AIUI 扩展了什么
标准 OAF 更强调“如何描述一个 Agent”,而 AIUI 更进一步,补上了“如何把 Agent 运行成界面应用”这一层。
在 AIUI 里,一个完整的 OAF 工程通常至少包含以下几部分:
AGENTS.md:定义智能体身份、系统指令、能力边界和协作约束app.json:定义应用入口、页面列表和全局窗口配置pages/:定义具体页面、页面生命周期、事件以及交互逻辑widgets/:定义 Widget 入口、显示内容和状态变化回调workers/:定义 Agent Worker 后台任务components/:封装可复用 UI 与局部交互单元modules/或其他普通模块文件:拆分业务逻辑、工具函数和资源导入package.json与 Package 导出:把可复用能力分发给其他 AIUI 应用
因此,在 AIUI 语境下,Open Agent Format 可以理解成两层:
- 描述层:说明这个智能体是什么
- 应用层:说明这个智能体如何被运行、展示和复用
这也是 AIUI 和“只有提示词或只有配置”的 Agent 工程之间最大的差别。
典型结构怎么理解
下面是一个经过抽象后的 OAF / AIUI 工程示意:
agent-app/
AGENTS.md
app.json
app.js
pages/
home/
index.ink
widgets/
weather/
index.ink
workers/
sync.js
components/
agent-card.ink
modules/
format-message.ts
package.json
这里每一层分别回答不同问题:
AGENTS.md:这个智能体是谁,应该如何思考和回应app.json/app.js:这个智能体应用如何启动,以及有哪些全局行为pages/:用户实际看到和操作的界面是什么widgets/:用户可以快速查看或操作的小尺寸界面是什么workers/:哪些任务需要在多个 Page 或 Widget 之间保持运行components/:界面里哪些片段需要复用和封装modules/:哪些逻辑、资源或能力需要被拆分复用package.json:哪些能力要作为 Package 暴露给别的项目使用
如果你把 AIUI 看成“让 Agent 具备真实 UI”的框架,那么 OAF 就是这套 UI 工程的基础文件格式。
为什么它重要
Open Agent Format 的价值,不在于引入新的术语,而在于让智能体工程具备更好的可读性、可维护性和可迁移性:
- 目录本身就是文档,降低接手和协作成本
- 描述层与界面层边界更清晰,方便拆分职责
- 页面、组件、模块和 Package 之间职责明确,便于长期演进
- 不同平台之间更容易建立映射关系,而不是被私有配置锁死
对于 AIUI 来说,这一点尤其重要,因为 AIUI 面向的不是“只能回答文本的 Agent”,而是“能够运行页面、承载交互、管理状态”的智能体应用。
继续阅读
- AGENTS.md:了解智能体描述文件如何定义身份、说明和指令
- app.json:了解应用入口、页面集合和全局配置
- 页面:了解页面如何承载具体 UI、生命周期和交互
- Widget:了解如何开发小尺寸独立界面
- Agent Worker:了解如何开发共享后台任务
- 组件:了解可复用 UI 单元如何注册、组合和通信
- 模块:了解逻辑、资源和 WebAssembly 如何通过模块组织
- 资源(Assets):了解包内路径、网络 URL 和不同资源类型的加载规则
- Package:了解如何把模块与组件封装成可分发能力