工具

工具

验证器、发现、现场注册和审查工具可帮助团队测试和采用 UAI-1。

  • 记录 UAIX-TOOL-0060
  • 路径 /zh-cn/tools/
  • 使用 规范公共记录

文件状态

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

如何使用本页

使用此页面查找验证器和其他支持工具以进行检查、发现和采用。

对于代理:将相关指南应用于用户的目标站点或存储库。除非用户明确要求该输出,否则请勿复制此 UAIX 页面、创建有关指南的页面或将此页面视为运行时权限。

工具

UAIX 工具支持 UAI-1 的验证、检查、现场订单治理、传输和信任审查、夹具测试、机器可读发现和实施入门。

哪些工具应该有帮助

  • 解析当前公共记录而不抓取页面文本。
  • 在发布之前检查架构目标、配置文件 ID、字段顺序、测试样例、传输绑定、信任通道、错误代码和一致性期望。
  • 在下游用户依赖它们之前,表面结构漂移、异步工作流程错误、跟踪上下文问题和信任策略差距。
  • 将一致性结果导出为可审查的记录,这些记录可以记录到发行说明、CI 日志或审计证据中。

主要工具路径

大多数读者应该从验证器,然后返回到示例或转发到实施轨道取决于下一个需要是调试还是发布证据。

WordPress 内存管理表面

UAI 内存管理是 UAIX.org WordPress 管理包,用于保持实时 .uai 内存、高级角色文件、现有 docs/wiki/ 内存表面、受保护的更新提示和项目切换导出保持一致。当 WordPress 站点需要人员和代理在漂移污染未来上下文之前查看陈旧、过大、重复或丢失的内存时,请使用它。

实验狗粮表面

UAIX 代理协议保留相同插件谱系、ZIP 预检检查、验证失败拒绝、清理和激活烟雾证据的旧版dogfood 记录。将这条路线视为历史证据;对当前公共管理插件表面使用 UAI 内存管理。

入门示例 一致性路径

  1. 选择已发布的一项示例或者准备一条与已知公开资料相关的候选人信息。
  2. 在运行检查之前解析匹配的架构、注册表、字段顺序、传输、信任和错误记录,以便其他审阅者可以重现相同的数据包。
  3. 运行验证器并将结果导出为可审查的记录。
  4. 将该结果带入实施轨道变更日志, 新闻, 和参考资料与贡献者当支票支持公开发布或支持声明时。
  5. 每当架构、注册表映射、字段顺序、传输指南、错误代码、验证器行为或运行时映射发生更改时,请重复运行。

已发布的入门路径

当下一个任务是在没有私人助手的情况下将工具、脚本或 QA 流程加载到实时公共界面时,请使用下面的公共验证运行和客户端调用。

证明路径

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

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

第 1 步

公开记录项

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

第 2 步

公开记录项

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

第 3 步

公开记录项

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

第 4 步

公开记录项

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

第 5 步

公开记录项

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

第 6 步

公开记录项

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

公开记录项 公开记录项 starter-message.json
代码示例
{
    "uai_version": "1.0",
    "profile": "uai.intent.request.v1",
    "message_id": "msg-2026-04-22-0001",
    "source": {
        "type": "agent",
        "id": "agent.alpha",
        "label": "Agent Alpha",
        "uri": "https://agents.alpha.example/runtime",
        "did": "did:web:agents.alpha.example",
        "role": "requesting-agent",
        "implementation": "alpha-runtime-2.4.1"
    },
    "target": {
        "type": "service",
        "id": "uaix.gateway",
        "label": "UAIX 闸门way",
        "uri": "/wp-json/uaix/v1/discovery",
        "did": "did:web:uaix.org",
        "role": "public-record-gateway",
        "implementation": "uaix-core-0.4.0"
    },
    "conversation": {
        "conversation_id": "conv-2026-04-22-uaix-001",
        "turn_id": "turn-001",
        "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01",
        "sequence": 1
    },
    "delivery": {
        "mode": "async",
        "priority": "interactive",
        "expires_at": "2026-04-22T16:05:00Z",
        "reply_requested": true,
        "ack_required": true
    },
    "trust": {
        "channel": "credentialed",
        "auth_scheme": "did+vc",
        "principal": "did:web:agents.alpha.example",
        "credential_ref": "https://agents.alpha.example/credentials/uai-interop.json",
        "signature_ref": "https://agents.alpha.example/signatures/msg-2026-04-22-0001.jws",
        "replay_window_id": "rw-2026-04-22-0001",
        "trust_profile": "uai.trust.did-vc-reference.v1",
        "verification_status": "not_verified",
        "credential_status": "not_checked",
        "verifier_ref": "https://agents.alpha.example/verifiers/uai-trust-policy.json",
        "trust_root_ref": "https://agents.alpha.example/.well-known/uai.json",
        "proof_ref": "https://agents.alpha.example/signatures/msg-2026-04-22-0001.jws",
        "replay_policy_ref": "https://agents.alpha.example/trust/replay-policy.json",
        "verification_checked_at": "2026-04-22T16:00:00Z",
        "verification_expires_at": "2026-04-22T16:05:00Z",
        "assurance_level": "reference_only"
    },
    "body": {
        "intent": "resolve-profile",
        "subject": "uai.task.status.v1",
        "requested_profile": "uai.task.status.v1",
        "parameters": {
            "include_schema": true,
            "include_example": true,
            "include_field_registry": true
        },
        "constraints": [
            "public-record-only",
            "trace-linked",
            "validator-ready"
        ],
        "response_profile": "uai.intent.response.v1"
    },
    "provenance": {
        "trace_id": "trace-7f3a2d",
        "parent_trace_id": "trace-root-uaix-2026",
        "issued_at": "2026-04-22T16:00:00Z",
        "log_ref": "urn:uaix:log:2026:0001",
        "agent_id": "agent.alpha",
        "model_id": "model.alpha.reasoner-2",
        "confidence": 0.98,
        "lineage": [
            {
                "stage": "request-composition",
                "actor_id": "agent.alpha",
                "model_id": "model.alpha.reasoner-2",
                "note": "Requested the async task-status profile and matching field registry."
            }
        ]
    },
    "integrity": {
        "version": 2,
        "algorithm": "sha256",
        "canonicalization": "jcs",
        "checksum": "sha256:dd8a9d16c9226cc9d1f4888a4d2bbcbf06b5b4b8"
    },
    "extensions": [
        {
            "namespace": "urn:uaix:ext:delivery",
            "purpose": "Explicit async request handling and expiry semantics.",
            "critical": false
        }
    ]
}
公开记录项 公开记录项 validate-request.json
代码示例
{
    "message": {
        "uai_version": "1.0",
        "profile": "uai.intent.request.v1",
        "message_id": "msg-2026-04-22-0001",
        "source": {
            "type": "agent",
            "id": "agent.alpha",
            "label": "Agent Alpha",
            "uri": "https://agents.alpha.example/runtime",
            "did": "did:web:agents.alpha.example",
            "role": "requesting-agent",
            "implementation": "alpha-runtime-2.4.1"
        },
        "target": {
            "type": "service",
            "id": "uaix.gateway",
            "label": "UAIX 闸门way",
            "uri": "/wp-json/uaix/v1/discovery",
            "did": "did:web:uaix.org",
            "role": "public-record-gateway",
            "implementation": "uaix-core-0.4.0"
        },
        "conversation": {
            "conversation_id": "conv-2026-04-22-uaix-001",
            "turn_id": "turn-001",
            "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01",
            "sequence": 1
        },
        "delivery": {
            "mode": "async",
            "priority": "interactive",
            "expires_at": "2026-04-22T16:05:00Z",
            "reply_requested": true,
            "ack_required": true
        },
        "trust": {
            "channel": "credentialed",
            "auth_scheme": "did+vc",
            "principal": "did:web:agents.alpha.example",
            "credential_ref": "https://agents.alpha.example/credentials/uai-interop.json",
            "signature_ref": "https://agents.alpha.example/signatures/msg-2026-04-22-0001.jws",
            "replay_window_id": "rw-2026-04-22-0001",
            "trust_profile": "uai.trust.did-vc-reference.v1",
            "verification_status": "not_verified",
            "credential_status": "not_checked",
            "verifier_ref": "https://agents.alpha.example/verifiers/uai-trust-policy.json",
            "trust_root_ref": "https://agents.alpha.example/.well-known/uai.json",
            "proof_ref": "https://agents.alpha.example/signatures/msg-2026-04-22-0001.jws",
            "replay_policy_ref": "https://agents.alpha.example/trust/replay-policy.json",
            "verification_checked_at": "2026-04-22T16:00:00Z",
            "verification_expires_at": "2026-04-22T16:05:00Z",
            "assurance_level": "reference_only"
        },
        "body": {
            "intent": "resolve-profile",
            "subject": "uai.task.status.v1",
            "requested_profile": "uai.task.status.v1",
            "parameters": {
                "include_schema": true,
                "include_example": true,
                "include_field_registry": true
            },
            "constraints": [
                "public-record-only",
                "trace-linked",
                "validator-ready"
            ],
            "response_profile": "uai.intent.response.v1"
        },
        "provenance": {
            "trace_id": "trace-7f3a2d",
            "parent_trace_id": "trace-root-uaix-2026",
            "issued_at": "2026-04-22T16:00:00Z",
            "log_ref": "urn:uaix:log:2026:0001",
            "agent_id": "agent.alpha",
            "model_id": "model.alpha.reasoner-2",
            "confidence": 0.98,
            "lineage": [
                {
                    "stage": "request-composition",
                    "actor_id": "agent.alpha",
                    "model_id": "model.alpha.reasoner-2",
                    "note": "Requested the async task-status profile and matching field registry."
                }
            ]
        },
        "integrity": {
            "version": 2,
            "algorithm": "sha256",
            "canonicalization": "jcs",
            "checksum": "sha256:dd8a9d16c9226cc9d1f4888a4d2bbcbf06b5b4b8"
        },
        "extensions": [
            {
                "namespace": "urn:uaix:ext:delivery",
                "purpose": "Explicit async request handling and expiry semantics.",
                "critical": false
            }
        ]
    },
    "format": "result"
}
公开记录项 此处说明当前公开记录、证据路径和支持边界。 mock-exchange-request.json
代码示例
{
    "scenario": "accepted-task",
    "format": "exchange",
    "message": {
        "uai_version": "1.0",
        "profile": "uai.intent.request.v1",
        "message_id": "msg-2026-04-22-0001",
        "source": {
            "type": "agent",
            "id": "agent.alpha",
            "label": "Agent Alpha",
            "uri": "https://agents.alpha.example/runtime",
            "did": "did:web:agents.alpha.example",
            "role": "requesting-agent",
            "implementation": "alpha-runtime-2.4.1"
        },
        "target": {
            "type": "service",
            "id": "uaix.gateway",
            "label": "UAIX 闸门way",
            "uri": "/wp-json/uaix/v1/discovery",
            "did": "did:web:uaix.org",
            "role": "public-record-gateway",
            "implementation": "uaix-core-0.4.0"
        },
        "conversation": {
            "conversation_id": "conv-2026-04-22-uaix-001",
            "turn_id": "turn-001",
            "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01",
            "sequence": 1
        },
        "delivery": {
            "mode": "async",
            "priority": "interactive",
            "expires_at": "2026-04-22T16:05:00Z",
            "reply_requested": true,
            "ack_required": true
        },
        "trust": {
            "channel": "credentialed",
            "auth_scheme": "did+vc",
            "principal": "did:web:agents.alpha.example",
            "credential_ref": "https://agents.alpha.example/credentials/uai-interop.json",
            "signature_ref": "https://agents.alpha.example/signatures/msg-2026-04-22-0001.jws",
            "replay_window_id": "rw-2026-04-22-0001",
            "trust_profile": "uai.trust.did-vc-reference.v1",
            "verification_status": "not_verified",
            "credential_status": "not_checked",
            "verifier_ref": "https://agents.alpha.example/verifiers/uai-trust-policy.json",
            "trust_root_ref": "https://agents.alpha.example/.well-known/uai.json",
            "proof_ref": "https://agents.alpha.example/signatures/msg-2026-04-22-0001.jws",
            "replay_policy_ref": "https://agents.alpha.example/trust/replay-policy.json",
            "verification_checked_at": "2026-04-22T16:00:00Z",
            "verification_expires_at": "2026-04-22T16:05:00Z",
            "assurance_level": "reference_only"
        },
        "body": {
            "intent": "resolve-profile",
            "subject": "uai.task.status.v1",
            "requested_profile": "uai.task.status.v1",
            "parameters": {
                "include_schema": true,
                "include_example": true,
                "include_field_registry": true
            },
            "constraints": [
                "public-record-only",
                "trace-linked",
                "validator-ready"
            ],
            "response_profile": "uai.intent.response.v1"
        },
        "provenance": {
            "trace_id": "trace-7f3a2d",
            "parent_trace_id": "trace-root-uaix-2026",
            "issued_at": "2026-04-22T16:00:00Z",
            "log_ref": "urn:uaix:log:2026:0001",
            "agent_id": "agent.alpha",
            "model_id": "model.alpha.reasoner-2",
            "confidence": 0.98,
            "lineage": [
                {
                    "stage": "request-composition",
                    "actor_id": "agent.alpha",
                    "model_id": "model.alpha.reasoner-2",
                    "note": "Requested the async task-status profile and matching field registry."
                }
            ]
        },
        "integrity": {
            "version": 2,
            "algorithm": "sha256",
            "canonicalization": "jcs",
            "checksum": "sha256:dd8a9d16c9226cc9d1f4888a4d2bbcbf06b5b4b8"
        },
        "extensions": [
            {
                "namespace": "urn:uaix:ext:delivery",
                "purpose": "Explicit async request handling and expiry semantics.",
                "critical": false
            }
        ]
    }
}

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

公开记录项

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

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

起步片段使用实时公开路由,而不是私有 SDK 或未发布的辅助层。

curl

普通 shell

用于文档、冒烟检查、CI 探针和快速人工复核的最快原始 HTTP 路径。

领养套件 获取已发布的入门数据包 uai-adoption-kit.json
代码示例
curl -sS "/wp-json/uaix/v1/adoption-kit" -o uai-adoption-kit.json
目录 解析实时路由目录
代码示例
curl -sS "/wp-json/uaix/v1/catalog"
示例 获取一个已发布起步数据包 example-record.json
代码示例
curl -sS "/wp-json/uaix/v1/examples/uai.intent.request.v1" -o example-record.json
验证 提交数据包以生成结果记录 validate-request.json
代码示例
curl -sS -X POST "/wp-json/uaix/v1/validate" \
  -H "Content-Type: application/json" \
  -d @validate-request.json
模拟交流 请求一个实时一致响应 mock-exchange-request.json
代码示例
curl -sS -X POST "/wp-json/uaix/v1/mock-exchange" \
  -H "Content-Type: application/json" \
  -d @mock-exchange-request.json

发现和站点地图表面

自动化和公共 QA 应该能够从根发现表面和区域设置前缀的路由空间解析相同的页面清单。

当前面向机器的路线

公共工具界面包括面向人的验证器页面以及面向机器的 REST 路由,用于自动化和发布检查。

API 参考和可重复使用的包装表面

  • AI内存封装向导将受支持的入门包引导到包模型、填充的系统配置文件、复制粘贴文件组、接收器简介、启动数据包、清单覆盖、持久内存配置所需的长期语义指针分类帐、就绪元数据和规范 ZIP 下载,而无需声明一般托管生成、自动存储库写入或自动 wiki 同步。
  • API参考将实时 REST 表面转换为逐条路线手册,其中包含已发布的 OpenAPI 3.1 文档和入门请求示例。
  • 领养套件发布第一个证明的入门包,其中包含入门文件、验证器就绪有效负载和模拟交换示例。
  • 一致性包将更广泛的模式、注册表数据、测试样例、传输和信任指南以及验证器入口点组装到一个可重复使用的机器可读数据包中。
  • /wp-json/uaix/v1/adoption-kit是面向机器的入门包,用于最短的可重复使用的首次验证运行;当您想要与附件相同的响应时,附加 ?download=1
  • /wp-json/uaix/v1/openapi.json是实时 UAIX REST 表面的面向机器的 OpenAPI 导出。
  • /wp-json/uaix/v1/conformance-pack是面向机器的 JSON 数据包,用于启动审核和可重复的一致性工作;当您想要与附件相同的响应时,附加 ?download=1
  • /wp-json/uaix/v1/roadmap是当前、下一步、计划的和研究跟踪工作的面向机器的远期计划记录;当您想要与附件相同的响应时,附加 ?download=1

已发布的操作界面参考

下面的记录是实时机器可读协议表面的一部分,在评估互操作性或支持声明时应附带架构和示例解决方案。

运行表面

传输、信任、错误与一致性

这些记录让 UAI-1 的运行层显式可见,而不是把传输绑定、信任姿态、类型化失败语义或支持声明留给私下约定。

传输

已发布绑定

默认
https-json-envelope.v1
绑定数
2
  • https-json-envelope.v1: application/vnd.uaix.uai+json
  • https-json-keyless.v1: application/vnd.uaix.uai-keyless+json

信任

已发布信任通道

  • public-web: 通过 HTTPS 公开可读的记录,无需事先建立双边信任。
  • private-api: 范围网络或租户边界上的服务到服务交换。
  • mtls: 在连接层锚定对等身份的传输认证交换。
  • signed-envelope: 记录附带消息级签名或独立签名参考。
  • credentialed: 发送方或执行上下文由机器可验证凭证或类似的签名身份声明支撑。

一致性

已发布级别阶梯

  • L1-core-envelope: L1 核心信封
  • L2-profile-validation: L2 配置文件验证
  • L3-trust-and-integrity: L3 信任与完整性
  • L4-public-record-publisher: L4 公共记录发布者
  • L5-agent-communication-profiles: L5 智能体通信配置文件
  • L6-reliable-delegation-idempotency-correlation: L6 具备幂等性与关联性的可靠委托
  • L7-capability-negotiation: L7 能力协商

错误

已发布消息错误码

  • invalid_message: 无效消息
  • unknown_profile: 个人资料未知
  • capability_not_supported: 不支持的能力
  • auth_required: 需要身份验证
  • insufficient_trust: 信任不足
  • task_not_found: 未找到任务

发现表面

自动化应从当前的 UAIX 发现清单和标准目录开始。

发现

机器可读的标准发现

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

发现清单

.well-known 入口

使用 `.well-known` 清单进行持久站点发现;当你希望从 API 表面获取同样的数据时,可改用 REST discovery 路由。生产部署应从规范 HTTPS 源发布同一份清单。

发布版本
UAI-1
配置文件数
61
生成时间
2026-07-25T21:28:42+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 公开记录项
  • 领养套件: /wp-json/uaix/v1/adoption-kit
  • 模拟交流: /wp-json/uaix/v1/mock-exchange 公开记录项

下一步

验证器,然后将得到的证据带入实施轨道变更日志, 和新闻当结果影响公开发布时。