工具

工具

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

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

文档状态

公共标准页面 作为当前公共标准记录的一部分发布在 UAIX 上
代码
UAIX-TOOL-0059
页面类型
工具
访问
公开且可链接

如何使用此页面

将此页面用作 工具 及其标准内容的规范公共参考。

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

工具

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

哪些工具应该有帮助

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

主要工具路径

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

WordPress 内存管理表面

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

实验狗粮表面

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

Hello-world 一致性路径

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

已发布的入门路径

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

First message

Run one reproducible UAI-1 proof

Start with a published fixture, validate the exact profile, then keep the result with release evidence.

Step 1

Read the catalog and select a published profile.

Step 2

Download its schema and example record.

Step 3

Validate a keyed message before transport.

Step 4

Use the Mock Exchange for a deterministic reference response.

Starter packetuai-first-packet.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 Gateway",
        "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
        }
    ]
}

Client examples

Start from the same public catalog

Use the same public catalog from shell, browser, server, or automation clients.

Shelluai-catalog.sh
代码示例
curl -sS /wp-json/uaix/v1/catalog
JavaScriptuai-catalog.mjs
代码示例
const catalog = await fetch('/wp-json/uaix/v1/catalog').then((response) => response.json());
PHPuai-catalog.php
代码示例
$catalog = json_decode(file_get_contents('/wp-json/uaix/v1/catalog'), true, 512, JSON_THROW_ON_ERROR);
Pythonuai_catalog.py
代码示例
catalog = requests.get('/wp-json/uaix/v1/catalog', timeout=10).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

已发布的操作界面参考

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

Operating surface

Transport, trust, errors, and conformance

These records keep delivery, trust posture, typed failure semantics, and support claims explicit.

Transport

Published bindings

  • https-json-envelope.v1: application/vnd.uaix.uai+json
  • https-json-keyless.v1: application/vnd.uaix.uai-keyless+json

Trust

Published trust channels

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

Conformance

Published level ladder

  • 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 能力协商

Errors

Published message error codes

  • invalid_message: 无效消息
  • unknown_profile: 个人资料未知
  • capability_not_supported: 不支持的能力
  • auth_required: 需要身份验证
  • insufficient_trust: 信任不足
  • task_not_found: 未找到任务
  • task_expired: 任务已过期
  • replay_window_violation: 重播窗口违规
  • rate_limited: 速率有限
  • upstream_unavailable: 上游不可用
  • conformance_failed: 一致性失败
  • idempotency_required: 需要幂等性

发现表面

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

发现

Machine-readable standards discovery

Resolve the current UAI-1 records from stable public endpoints without scraping page copy.

Public routes

Current machine-facing surface

  • 目录: /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
  • Validate (POST JSON): /wp-json/uaix/v1/validate
  • 领养套件: /wp-json/uaix/v1/adoption-kit
  • 模拟交流: /wp-json/uaix/v1/mock-exchange

下一步

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