AXI：面向 Agent 的操作界面

AXI（Agent eXperience Interface）描述产品如何让 Agent 找到能力、定位对象、执行操作、观察结果，并在中断后恢复。人类界面与 Agent 界面共享业务对象、权限、副作用和状态。

例如，“审批这份文档”不应要求 Agent 先浏览所有菜单、猜测同名按钮、反复截图，最后在提交超时后重新审批。产品可以提供小型用途索引、精确合同、明确的文档引用，以及原操作恢复入口；需要判断文档内容时仍保留阅读和人工决定。

规范状态

当前版本为 0.2.1 草案，尚无稳定版本。它是独立设计提案，不具有行业标准地位，也不是其他同名项目的官方规范。规则和 Schema 可用于试验接入；符合性必须附上具体实现和任务证据。

从这里开始

目标	入口	读完能做什么
理解 AXI	架构	划分宿主、接入层与业务服务职责
组合生态能力	协作模型	协同 CLI、MCP、Skills、插件与 MCP Apps
接入 Codex	Codex 开放接口	区分插件、WebMCP、标注、原生界面、文件与运行时
梳理完整接入	生命周期	覆盖安装、鉴权、升级、发布和退役
跑通一个例子	快速上手	本地完成审批、丢失应答与恢复
实现合同	0.2.1 规范	使用明确字段、状态和要求编号
接入现有产品	提供方指南	从一个真实任务形成可交付接口
开发 Agent 客户端	客户端指南	按需发现、缓存、执行和核验
改进网页操作	浏览器指南	提供可定位控件和可选页面工具
优化速度	性能实践	测量并减少无效回合与重复读取
设计本地产品	本地工作区	划分项目文件、内部状态、独立本地、在线能力和协作
验证采用程度	符合性	声明覆盖范围和未验证依赖

AXI 包含什么

核心合同定义能力目录、动作描述、范围化对象、结果与错误、版本和安全要求。可选能力覆盖分页、只读批量、等待、取消和扩展。绑定指南说明如何在 CLI、MCP 和浏览器中保留这些语义。

本仓库提供版本化 JSON Schema、正反例夹具、本地参考提供方和文档测试。参考提供方只演示文档审批，不构成可部署的身份系统、MCP 服务或浏览器宿主。

与现有协议的关系

AXI 不定义新的网络传输、模型运行时或通用授权协议。CLI 可以承载 AXI JSON；MCP 可以暴露带有这些语义的工具；Skills 提供方法，插件组合与分发组件，MCP Apps 提供会话内的交互视图，网页和 DSH 等宿主也可经适配加入。支持某个载体不自动证明目标任务可用。

正文是自足的实现合同。外部来源集中在参考资料，产品自己的路径、上线记录和测试数据保留在其采用清单中。