工具
UAIX 工具支持 UAI-1 的验证、检查、现场订单治理、传输和信任审查、夹具测试、机器可读发现和实施入门。
哪些工具应该有帮助
- 解析当前公共记录而不抓取页面文本。
- 在发布之前检查架构目标、配置文件 ID、字段顺序、测试样例、传输绑定、信任通道、错误代码和一致性期望。
- 在下游用户依赖它们之前,表面结构漂移、异步工作流程错误、跟踪上下文问题和信任策略差距。
- 将一致性结果导出为可审查的记录,这些记录可以记录到发行说明、CI 日志或审计证据中。
主要工具路径
大多数读者应该从验证器,然后返回到示例或转发到实施轨道取决于下一个需要是调试还是发布证据。
WordPress 内存管理表面
UAI 内存管理是 UAIX.org WordPress 管理包,用于保持实时 .uai 内存、高级角色文件、现有 docs/ 和 wiki/ 内存表面、受保护的更新提示和项目切换导出保持一致。当 WordPress 站点需要人员和代理在漂移污染未来上下文之前查看陈旧、过大、重复或丢失的内存时,请使用它。
实验狗粮表面
UAIX 代理协议保留相同插件谱系、ZIP 预检检查、验证失败拒绝、清理和激活烟雾证据的旧版dogfood 记录。将这条路线视为历史证据;对当前公共管理插件表面使用 UAI 内存管理。
入门示例 一致性路径
- 选择已发布的一项示例或者准备一条与已知公开资料相关的候选人信息。
- 在运行检查之前解析匹配的架构、注册表、字段顺序、传输、信任和错误记录,以便其他审阅者可以重现相同的数据包。
- 运行验证器并将结果导出为可审查的记录。
- 将该结果带入实施轨道, 变更日志, 新闻, 和参考资料与贡献者当支票支持公开发布或支持声明时。
- 每当架构、注册表映射、字段顺序、传输指南、错误代码、验证器行为或运行时映射发生更改时,请重复运行。
已发布的入门路径
当下一个任务是在没有私人助手的情况下将工具、脚本或 QA 流程加载到实时公共界面时,请使用下面的公共验证运行和客户端调用。
第 1 步 此处说明当前公开记录、证据路径和支持边界。 第 2 步 此处说明当前公开记录、证据路径和支持边界。 第 3 步 此处说明当前公开记录、证据路径和支持边界。 第 4 步 此处说明当前公开记录、证据路径和支持边界。 第 5 步 此处说明当前公开记录、证据路径和支持边界。 第 6 步 此处说明当前公开记录、证据路径和支持边界。 此处说明当前公开记录、证据路径和支持边界。 起步片段使用实时公开路由,而不是私有 SDK 或未发布的辅助层。公开记录项
公开记录项
公开记录项
公开记录项
公开记录项
公开记录项
/wp-json/uaix/v1/catalog
模式
/wp-json/uaix/v1/schemas/uai.intent.request.v1
示例
/wp-json/uaix/v1/examples/uai.intent.request.v1
验证
/wp-json/uaix/v1/validate
领养套件
/wp-json/uaix/v1/adoption-kit
模拟交流
/wp-json/uaix/v1/mock-exchange
{
"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
}
]
}{
"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"
}{
"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
}
]
}
}curl -sS "/wp-json/uaix/v1/adoption-kit" -o uai-adoption-kit.jsoncurl -sS "/wp-json/uaix/v1/catalog"curl -sS "/wp-json/uaix/v1/examples/uai.intent.request.v1" -o example-record.jsoncurl -sS -X POST "/wp-json/uaix/v1/validate" \
-H "Content-Type: application/json" \
-d @validate-request.jsoncurl -sS -X POST "/wp-json/uaix/v1/mock-exchange" \
-H "Content-Type: application/json" \
-d @mock-exchange-request.jsonInvoke-RestMethod -Uri "/wp-json/uaix/v1/adoption-kit" | ConvertTo-Json -深度 20 | Set-Content .\uai-adoption-kit.jsonInvoke-RestMethod -Uri "/wp-json/uaix/v1/catalog"Invoke-RestMethod -Uri "/wp-json/uaix/v1/examples/uai.intent.request.v1" | ConvertTo-Json -深度 20 | Set-Content .\example-record.json$message = (Get-Content -Raw .\example-record.json | ConvertFrom-Json).message
$body = @{ message = $message; format = "result" } | ConvertTo-Json -深度 20
Invoke-RestMethod -Method Post -Uri "/wp-json/uaix/v1/validate" -ContentType "application/json" -Body $body$message = (Get-Content -Raw .\example-record.json | ConvertFrom-Json).message
$body = @{ scenario = "accepted-task"; format = "exchange"; message = $message } | ConvertTo-Json -深度 20
Invoke-RestMethod -Method Post -Uri "/wp-json/uaix/v1/mock-exchange" -ContentType "application/json" -Body $bodyimport json, urllib.request
kit = json.load(urllib.request.urlopen("/wp-json/uaix/v1/adoption-kit"))import json, urllib.request
catalog = json.load(urllib.request.urlopen("/wp-json/uaix/v1/catalog"))example_record = json.load(urllib.request.urlopen("/wp-json/uaix/v1/examples/uai.intent.request.v1"))
message = example_record.get("message", example_record)payload = json.dumps({"message": message, "format": "result"}).encode("utf-8")
request = urllib.request.Request("/wp-json/uaix/v1/validate", data=payload, headers={"Content-Type": "application/json"}, method="POST")
result = json.load(urllib.request.urlopen(request))payload = json.dumps({"scenario": "accepted-task", "format": "exchange", "message": message}).encode("utf-8")
request = urllib.request.Request("/wp-json/uaix/v1/mock-exchange", data=payload, headers={"Content-Type": "application/json"}, method="POST")
exchange = json.load(urllib.request.urlopen(request))const kit = await fetch("/wp-json/uaix/v1/adoption-kit").then((response) => response.json());const catalog = await fetch("/wp-json/uaix/v1/catalog").then((response) => response.json());const exampleRecord = await fetch("/wp-json/uaix/v1/examples/uai.intent.request.v1").then((response) => response.json());
const message = exampleRecord.message ?? exampleRecord;const result = await fetch("/wp-json/uaix/v1/validate", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ message, format: "result" }),
}).then((response) => response.json());const exchange = await fetch("/wp-json/uaix/v1/mock-exchange", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ scenario: "accepted-task", format: "exchange", message }),
}).then((response) => response.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。
已发布的操作界面参考
下面的记录是实时机器可读协议表面的一部分,在评估互操作性或支持声明时应附带架构和示例解决方案。
传输
已发布绑定
- 默认
- https-json-envelope.v1
- 绑定数
- 2
https-json-envelope.v1:application/vnd.uaix.uai+jsonhttps-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公开记录项