规范

UAI-1

此处说明当前公开记录、证据路径和支持边界。

  • 记录 UAIX-SPEC-0050
  • 小路 /zh-cn/specification/uai-1/
  • 使用 规范公共记录

文件状态

公共标准页面 作为当前公共标准记录的一部分在 UAIX 上发布
代码
UAIX-SPEC-0050
表面
规范
使用权
公开且可链接

如何使用本页

使用此页面作为 UAI-1 的主要规范,并在描述所需的消息行为时引用它。

解析契约

模式字段注册表传输绑定信任通道

契约图

UAI-1 公共契约层如何协同

此处说明当前公开记录、证据路径和支持边界。

信封

共享消息形状

共同信封使身份、工作流连续性、来源、完整性和 profile 选择在每次公共交换中保持明确。

运行层

传输、信任、错误和声明

支持性的机器可读记录说明消息如何传递、信任如何声明、失败如何命名以及可以声明哪些支持级别。

证据

先验证,再作支持声明

在称任何实现已可发布或公开支持前,请将示例、模式和验证器一起使用。

可靠性

架构优先于模型记忆

UAI-1 不依赖 AI 记住正确答案。模式、注册表记录、来源、完整性字段、示例、验证器输出和发布轨迹承载公共事实。

发布基线必需文件

必需包文件,而不是新 profile

Memory-maintenance is required package policy; protected artifacts are not generated or inspected by default.

身份

令牌保管必须明确

启动包必须列明身份生命周期、令牌保管、存储确认、恢复边界、文本优先发现、安全港和 UTC 时间戳规则,同时不得发布原始令牌。

失败

问题详情是 HTTP 失败响应的形状

UAIX 平台 HTTP API 失败使用 RFC 9457 风格的 application/problem+json,并包含 UAIX 扩展字段、重试规则、证据建议、安全港链接、跟踪 ID 和关联 ID。

暂停

网络阻断会成为证据

暂停包必须携带阻断分类、有界重试策略、可公开安全披露的观察结果、证据包引用和人工升级路径,而不是无限期重试。

解析契约

模式机器验证的消息结构。字段注册表keyed 与 keyless 字段顺序图。传输绑定默认 keyed、keyless 和异步指引。信任通道公共信任姿态词汇。错误注册表类型化失败代码及含义。一致性级别公共发布的支持声明阶梯。公开记录项机器路由说明和问题详情响应模式。

证明路径

公开记录项

此处说明当前公开记录、证据路径和支持边界。

  1. 1公开记录项此处说明当前公开记录、证据路径和支持边界。
  2. 2公开记录项此处说明当前公开记录、证据路径和支持边界。
  3. 3公开记录项此处说明当前公开记录、证据路径和支持边界。
  4. 4此处说明当前公开记录、证据路径和支持边界。此处说明当前公开记录、证据路径和支持边界。
核心机器路由直接解析运行层
https://uaix.org/wp-json/uaix/v1/field-registry
https://uaix.org/wp-json/uaix/v1/transport-bindings
https://uaix.org/wp-json/uaix/v1/trust-channels
https://uaix.org/wp-json/uaix/v1/error-registry
https://uaix.org/wp-json/uaix/v1/conformance-levels
https://uaix.org/wp-json/uaix/v1/openapi.json

这些路由是书面 UAI-1 记录的面向机器配套表面。

UAI-1 是什么

UAI-1 是通用人工智能版本 1,是 UAIX 发布的 UAI 系列中的当前规范规范。它定义了一个结构化信封,用于在 AI 系统之间交换身份、意图、上下文、出处、有效负载、输出和错误,而无需将交换绑定到单个供应商或运行时。

消息模型

  • 每个交换系列的声明版本和发布的配置文件。
  • 稳定的消息标识和源/目标描述。
  • 承载交换的实际意图和主题的机构。
  • 来源和完整性字段使消息保持可审查和可审计。
  • 验证或执行失败时的可预测错误语义。

UAI-1 需要什么

  • 每个消息系列的显式版本控制和配置文件声明。
  • 机器可读的结构可以清晰地映射到已发布的模式和一致性检查。
  • 跨工具、服务和代理运行时的可移植有效负载处理。
  • 通过消息标识符、来源字段、可审查的日志引用和可导出的一致性结果进行跟踪。
  • 在声明的公共信封之外没有隐藏或隐蔽的信号要求。

当前发布的个人资料系列

  • uai.intent.request.v1 请求针对具有可审计来源和完整性字段的已声明主题进行明确的意图解析。
  • uai.intent.response.v1 返回已声明请求的结果,并以相同的可审查信封形状显示结果数据和通知。
  • uai.capability.statement.v1 发布功能元数据和支持的配置文件兼容性以进行发现工作。
  • uai.error.v1 在稳定的机器可读信封中报告验证、传输或执行失败。
  • uai.conformance.result.v1 捕获验证器输出,其中包含问题代码、严重性和发布证据的摘要计数。

UAI-1 没有定义什么

  • 它没有规定一种传输、托管堆栈或供应商运行时。
  • 它不会取代本地身份验证、授权或操作策略。
  • 它不将不透明的速记或私人代理方言视为规范行为。

交换示例

公开记录项
{ "uai_version": "1.0", "profile": "uai.intent.request.v1", "message_id": "msg-2026-04-20-0001", "source": { "type": "agent", "id": "agent.alpha" }, "target": { "type": "service", "id": "uaix.registry" }, "body": { "intent": "resolve-profile", "subject": "uai.intent.request.v1" }, "provenance": { "trace_id": "trace-7f3a2d", "issued_at": "2026-04-20T16:00:00Z", "log_ref": "urn:uaix:log:2026:0001" }, "integrity": { "version": 1, "checksum": "sha256:4cb0c8e7" } }
传输格式优化版(无键)JSON
公开记录项
[
    "1.0",
    "uai.intent.request.v1",
    "msg-2026-04-20-0001",
    [
        "agent",
        "agent.alpha"
    ],
    [
        "service",
        "uaix.registry"
    ],
    null,
    null,
    null,
    [
        "resolve-profile",
        "uai.intent.request.v1"
    ],
    [
        "trace-7f3a2d",
        null,
        "2026-04-20T16:00:00Z",
        "urn:uaix:log:2026:0001"
    ],
    [
        1,
        null,
        null,
        "sha256:4cb0c8e7"
    ]
]

字段顺序遵循有键 JSON 示例、已发布的模式顺序以及公共字段注册表。

执行阅读顺序

一起阅读 UAI-1 模式, 注册表, 示例,以及 验证器 因此,散文、标识符、测试样例和检查保持一致。

规范变更如何保持公开和可审查

  • 通过反映配置文件和兼容性更改 模式, 注册表, 示例,以及 验证器 而不是将它们仅仅隐含在散文中。
  • 将验证器支持的结果带入相关的 实施轨道 跟踪,以便发布证据保留在真实软件中。
  • 使用 变更日志 用于兼容性和迁移状态,以及 新闻 当变更还需要公开发布摘要时。
  • 使用 参考资料与贡献者 当读者需要围绕当前规范记录的稳定发现和引用链接时。

下一步

继续 模式 查看 UAI-1 的哪些部分经过机器验证以及发布的配置文件如何成为一致性目标。