工具
UAIX 工具支持 UAI-1 的验证、检查、现场订单治理、传输和信任审查、夹具测试、机器可读发现和实施入门。
哪些工具应该有帮助
- 解析当前公共记录而不抓取页面文本。
- 在发布之前检查架构目标、配置文件 ID、字段顺序、固定装置、传输绑定、信任通道、错误代码和一致性期望。
- 在下游用户依赖它们之前,表面结构漂移、异步工作流程错误、跟踪上下文问题和信任策略差距。
- 将一致性结果导出为可审查的记录,这些记录可以记录到发行说明、CI 日志或审计证据中。
主要工具路径
大多数读者应该从验证器,然后返回到示例或转发到实施取决于下一个需要是调试还是发布证据。
WordPress 内存管理表面
UAI 内存管理是 UAIX.org WordPress 管理包,用于保持实时 .uai 内存、高级角色文件、现有 docs/ 和 wiki/ 内存表面、受保护的更新提示和项目切换导出保持一致。当 WordPress 站点需要人员和代理在漂移污染未来上下文之前查看陈旧、过大、重复或丢失的内存时,请使用它。
实验狗粮表面
UAIX 代理协议保留相同插件谱系、ZIP 预检检查、验证失败拒绝、清理和激活烟雾证据的旧版dogfood 记录。将这条路线视为历史证据;对当前公共管理插件表面使用 UAI 内存管理。
Hello-world 一致性路径
- 选择已发布的一项示例或者准备一条与已知公开资料相关的候选人信息。
- 在运行检查之前解析匹配的架构、注册表、字段顺序、传输、信任和错误记录,以便其他审阅者可以重现相同的数据包。
- 运行验证器并将结果导出为可审查的记录。
- 将该结果带入实施, 变更日志, 消息, 和参考文献和贡献者当支票支持公开发布或支持声明时。
- 每当架构、注册表映射、字段顺序、传输指南、错误代码、验证器行为或运行时映射发生更改时,请重复运行。
已发布的入门路径
当下一个任务是在没有私人助手的情况下将工具、脚本或 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.
{
"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.
curl -sS /wp-json/uaix/v1/catalogconst catalog = await fetch('/wp-json/uaix/v1/catalog').then((response) => response.json());$catalog = json_decode(file_get_contents('/wp-json/uaix/v1/catalog'), true, 512, JSON_THROW_ON_ERROR);catalog = requests.get('/wp-json/uaix/v1/catalog', timeout=10).json()发现和站点地图表面
自动化和公共 QA 应该能够从根发现表面和区域设置前缀的路由空间解析相同的页面清单。
- 使用
/.well-known/uaix.json作为首选的机器可读清单。 - 使用
/sitemap.xml和/sitemap.html作为持久的根爬网和目录表面。 - 使用
/en-us/sitemap.xml和/en-us/sitemap.html当本地化读者或工具需要通过英语路线空间进行相同的库存时。 - 即使以区域设置为前缀的站点地图路由也已上线并经过测试,也将根站点地图文件视为规范的公共 SEO 表面。
当前面向机器的路线
公共工具界面包括面向人的验证器页面以及面向机器的 REST 路由,用于自动化和发布检查。
/wp-json/uaix/v1/catalog和/wp-json/uaix/v1/discovery公开当前的标准目录和发现清单。/wp-json/uaix/v1/status和/wp-json/uaix/v1/modules公开运行时状态和模块库存。/wp-json/uaix/v1/schemas,/wp-json/uaix/v1/registry,/wp-json/uaix/v1/field-registry, 和/wp-json/uaix/v1/examples公开已发布的机器可读记录系列。/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/validate是 JSONPOST自动化验证端点;使用验证器当人们需要工作台体验时的页面。/wp-json/uaix/v1/roadmap揭示当前、下一步、计划和研究轨道工作的远期计划边界。
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+jsonhttps-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.
Discovery manifest
Well-known entry points
- Release
- UAI-1
- 模式
- 63
- Profiles
- 63
- 示例
- 63
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