规范

规范系列的作用#

规范部分是 UAI-1 的规范性书面层。当你需要了解公共契约、标准的语义边界，以及机器可读工件必须保留的含义时，应从这里开始。

当前公共记录如何组成一个整体#

1. UAI-1 定义共同信封、配置文件语义、支持边界和一致性期望。
2. 模式 与字段注册表把这份契约转成可由机器检查的结构，以及从有键到无键的公共字段顺序。
3. 注册表发布六个当前配置文件标识符、它们的兼容配对关系，以及对应的模式和示例链接。
4. 示例展示请求、响应、能力声明、错误、一致性结果和异步任务状态记录的实际写法。
5. 验证器同时应用结构校验和策略检查，使同一套公共记录能够支撑评审与发布门禁。
6. 实施轨道、治理和变更日志说明当前真正受支持的内容，以及变更如何成为公共事实。

当前已发布的配置文件家族#

• uai.intent.request.v1 用于针对已声明主题发起明确请求。
• uai.intent.response.v1 用于返回结果、确认消息以及接受异步移交。
• uai.capability.statement.v1 用于发布可公开审查的能力声明。
• uai.error.v1 用于发布具类型、机器可读的失败记录。
• uai.conformance.result.v1 用于导出验证器证据。
• uai.task.status.v1 用于公开异步任务的进度与完成状态。

如何正确理解边界#

• 把 UAI-1 视为公共交换层和发布记录层，而不是要求你替换所有本地工具总线、运行时协议或信任栈。
• 本地执行问题应继续使用相邻的编排或工具协议；当公共互操作性重要时，再把对外可审查的记录映射回 UAI-1。
• 凭证、签名和传输系统应作为在信封中声明的配套层存在，而不是被硬编码成唯一必选技术栈。

机器可读发现#

自动化应通过发现清单和标准目录来解析公共记录，而不是抓取页面文本。发现表面会明确发布版本当前的路由、计数和 .well-known 入口。

下一步#

继续阅读 UAI-1 以了解规范契约，然后依次进入 模式、注册表、示例 和 验证器。