规格系列的作用
该规范部分是 UAI 的规范锚点。它解释了标准在散文中的承诺、UAI-1 如何适应更广泛的家族，以及实施者应该与文本一起阅读哪些支持记录。
公共记录如何整合在一起
- UAI-1 定义当前的规范消息模型和一致性期望。
- 模式 表达已发布配置文件背后的机器验证结构。
- 注册表 发布稳定的标识符、句柄和面向兼容性的引用。
- 示例 显示映射回规范记录的工作交流。
- 验证器 将这些记录转化为可重复的一致性证据。
- 治理 变更日志解释了该标准如何公开演变。
当前发布的个人资料系列
uai.intent.request.v1针对已声明主题的明确意图请求。uai.intent.response.v1用于在同一个可审查信封中返回已声明请求的结果。uai.capability.statement.v1用于面向发现的功能元数据和支持的配置文件声明。uai.error.v1用于跨当前消息流提供稳定的机器可读故障报告。uai.conformance.result.v1用于验证器提供的与审查和发布工作相关的证据。
实施者应如何使用本节
- 引用标准行为时，请引用准确的 UAIX 文档路径。
- 将规范性散文、模式、注册表条目、示例、验证器指南和变更日志条目视为一项协调记录。
- 使用规范来了解语义意图、兼容性状况以及跨实现必须保持稳定的内容。
- 与临时私有编码或隐藏的交换快捷方式相比，更喜欢声明的接口和可审查的有效负载。
机器可读的发现
自动化应该从发布的发现清单和目录开始，以便工具可以解析当前的 UAI-1 路由，而无需抓取公共站点。
发现清单
.well-known 入口
使用 `.well-known` 清单进行持久站点发现；当你希望从 API 表面获取同样的数据时，可改用 REST discovery 路由。生产部署应从规范 HTTPS 源发布同一份清单。
- 发布版本
- UAI-1
- 配置文件数
- 57
- 生成时间
- 2026-06-11T04:50:41+00:00
公共路由
当前面向机器的表面
该清单公布了构成当前 UAIX 标准表面的 API 路径和公共发布路径。
-
目录:
/wp-json/uaix/v1/catalog -
模式:
/wp-json/uaix/v1/schemas -
注册表:
/wp-json/uaix/v1/registry -
字段注册表:
/wp-json/uaix/v1/field-registry -
传输绑定:
/wp-json/uaix/v1/transport-bindings -
信任通道:
/wp-json/uaix/v1/trust-channels -
一致性级别:
/wp-json/uaix/v1/conformance-levels -
错误注册表:
/wp-json/uaix/v1/error-registry -
示例:
/wp-json/uaix/v1/examples -
验证:
/wp-json/uaix/v1/validate（POST JSON） -
公开记录项:
/wp-json/uaix/v1/adoption-kit -
公开记录项:
/wp-json/uaix/v1/mock-exchange公开记录项