工具

API 参考

面向当前 UAIX REST 表面的逐路由手册,包含起步请求、OpenAPI 导出以及面向验证器的机器入口。

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

文件状态

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

如何使用本页

使用本页检查实时 REST 路由、OpenAPI 文档、可复制的机器接口起步请求以及参考 mock exchange。

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

实时路由

目录发现接入套件 JSON公开记录项

机器表面

先从目录开始,再进入接入套件、OpenAPI、验证与实时 mock exchange

本页用于避免实现方反向推断 WordPress REST 表面。先在这里解析实时路由,再进入接入包、验证、mock 响应测试、问题详情处理或包组装,而无需猜测。生成的 .uai 包文件是本地记忆与交接记录,不是 API 端点或托管执行路由。

先解析

目录与发现

在发起任何具体路由调用之前,目录与发现路由会先告诉自动化系统当前公开表面是什么。

描述契约

OpenAPI 与起步请求

请使用这里的实时 OpenAPI 导出与起步请求模式,而不要依赖抓取来的页面文案或过时笔记。

继续推进

接入、验证与可复用证据

当路由清单直接进入接入包、验证器运行、实时 mock 响应,或可随发布评审一起传递的一致性数据包时,它的价值最大。

搜索边界

HTML 页面用于说明;JSON 路由用于执行

机器 JSON 路由标记为不可索引的执行表面,并带有明确缓存策略,因此搜索和引用应优先使用面向人类的文档页面。

HTTP 失败

Problem JSON 是恢复契约

路由查找失败、格式错误的公共 POST 正文、正文大小限制和速率限制都会返回 RFC 9457 风格的 application/problem+json,并包含 UAIX 代码、重试指引、证据标记和安全港链接。

实时路由

目录当前公开标准清单。发现面向机器的路由清单。接入套件 JSON用于首次证明运行的已发布接入包。公开记录项实时 OpenAPI 3.1 导出。验证用于一致性检查的机器 POST 目标。模拟交换用于获取实时合规响应信封的机器 POST 目标。一致性包 JSON在一次响应中返回可复用的启动数据包。

证明路径

验证器支持的证明路径

将公众阅读顺序与一个证据线索联系起来:配置文件、模式、示例、验证器结果和发布记录。

  1. 1选择消息配置文件。从已发布的 UAI-1 配置文件和与您需要证明的交换匹配的记录系列开始。
  2. 2将其与模式和示例进行比较。在写入或映射候选数据包之前解析架构、注册表项和一个测试样例。
  3. 3运行验证器证据。根据当前公共 UAI-1 记录验证键控、缩小键控或无键 JSON。
  4. 4将结果附加到实施或移交记录中。将导出的结果保存到一致性包、实施轨道、变更日志或项目移交证据中。
起步调用解析实时 REST 表面
curl -s https://uaix.org/wp-json/uaix/v1/catalog
curl -s https://uaix.org/wp-json/uaix/v1/discovery
curl -s https://uaix.org/wp-json/uaix/v1/adoption-kit
curl -s https://uaix.org/wp-json/uaix/v1/openapi.json
curl -s -X POST https://uaix.org/wp-json/uaix/v1/mock-exchange -H "Content-Type: application/json" -d @mock-exchange-request.json

先使用目录与发现路由,再拉取接入套件、检查 OpenAPI 文档,或直接请求一份实时 mock 响应。

此页面的用途

使用此页面作为实时 UAIX REST 表面的面向机器的手册。它将当前目录、发现、路线图、架构、注册表、示例、验证器、采用套件、OpenAPI、模拟交换和一致性包路由转换为人类可读的启动参考。

何时使用它

  • 当实施者想要精确的非区域设置 REST 基本路径和路由清单时。
  • 当工具构建者需要启动请求、采用包、前瞻性计划边界和 OpenAPI 文档而不是对站点进行逆向工程时。
  • 当发布审核者想要验证公共文档、面向机器的路线、路线图边界和验证器证据是否都指向同一版本时。

通过现场表面的最快路线

  1. 解决当前/wp-json/uaix/v1/catalog路线第一。
  2. 从中获取一个模式或示例模式, 注册表, 和示例.
  3. 拉取发布的领养套件当您需要最短的可重复使用的入门包时。
  4. 提交验证器运行验证器或面向机器的/wp-json/uaix/v1/validate路线。
  5. 使用一致性包当该运行需要作为更广泛的发布证据进行传播时。
  6. 使用/wp-json/uaix/v1/roadmap当自动化也需要当前的未来工作边界时。

路线等级图

  • 发现 GET 路线:目录、发现、模式、注册表、字段注册表、示例、传输绑定、信任通道、错误注册表、一致性级别、路线图、OpenAPI、采用工具包和一致性包路由发布当前的机器可读记录。
  • 执行POST路线:验证和模拟交换路由接受候选 JSON 并且应被视为无存储执行表面,而不是可爬行的登陆页面。
  • 人类引用途径:当散文、边界和后续步骤很重要时,公共声明应引用以语言环境为前缀的页面,例如 UAI-1、验证器、接入套件、一致性包、路线图 和 变更日志。
  • 下载表格:可下载的 JSON 数据包是相同公共记录的便捷形式,而不是单独的权限。

此页面发布的内容

  • 面向机器的逐条路线参考。
  • 用于发现、配置文件查找、验证、入门包获取和路线图解析的入门请求示例。
  • 当前 OpenAPI 3.1 导出为实时 REST 表面。
  • 直接链接回规范的公共页面,以散文形式解释相同的记录。

路由级启动器调用

当您希望在curl、PowerShell、Python 或TypeScript 中进行实时目录、示例和验证器调用而不需要对路由表面进行逆向工程时,请使用下面的公共代码片段。

公开记录项

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

当你需要实时目录、示例、验证器和模拟响应调用,而不想反向解析 REST 表面时,使用这些片段。

起步片段使用实时公开路由,而不是私有 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

实时面向机器的参考

使用下面的参考作为路线布局、启动器调用和 OpenAPI 导出的当前公共源。

API参考

面向机器的上线表面

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

公开记录项

/wp-json/uaix/v1

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

公开记录项

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

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

公开记录项

公开记录项

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

公开记录项

目录 -> 路线图 -> Adoption kit -> 验证 -> Mock

先解析 catalog,检查未来工作边界,获取已发布的接入包,运行一次验证器检查,然后调用实时 mock exchange,再提出支持或兼容性声明。

公开记录项 公开记录项
代码示例
curl -sS /wp-json/uaix/v1/catalog
公开记录项 公开记录项 example-record.json
代码示例
curl -sS /wp-json/uaix/v1/schemas/uai.intent.request.v1
curl -sS /wp-json/uaix/v1/examples/uai.intent.request.v1
领养套件 获取已发布的入门数据包 uai-adoption-kit.json
代码示例
curl -sS /wp-json/uaix/v1/adoption-kit -o uai-adoption-kit.json
路线图 解析前进计划边界 uai-1-roadmap.json
代码示例
curl -sS /wp-json/uaix/v1/roadmap -o uai-1-roadmap.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
公开记录项 公开记录项 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
            }
        ]
    },
    "normalization_mode": "keyed-json",
    "format": "result"
}
公开记录项 公开记录项 uai-conformance-result.json
代码示例
{
    "valid": true,
    "checked_at": "2026-07-28T14:12:08+00:00",
    "profile": "uai.intent.request.v1",
    "current_release": "UAI-1",
    "uai_version": "1.0",
    "schema_route_url": "/wp-json/uaix/v1/schemas/uai.intent.request.v1",
    "registry_route_url": "/wp-json/uaix/v1/registry/uai.intent.request.v1",
    "issue_count": 0,
    "error_count": 0,
    "warning_count": 0,
    "errors": [],
    "warnings": [],
    "status": "pass",
    "normalization": {
        "mode": "keyed-json",
        "status": "current",
        "supported": true,
        "input_shape": "json-object",
        "normalized": false,
        "registry_release": "UAI-1",
        "registry_release_date": "2026-06-02",
        "field_registry_url": "/wp-json/uaix/v1/field-registry",
        "canonicalization": "jcs-compatible-sorted-json",
        "canonical_hash": "sha256:df1471b14bfab5649ab461956640cfe8201aab274f3db190bc621dc195dc2abd",
        "byte_count": 2665
    },
    "conformance_record": {
        "uai_version": "1.0",
        "profile": "uai.conformance.result.v1",
        "message_id": "msg-20260728T141208Z-7cdcc56bcab0",
        "source": {
            "type": "service",
            "id": "uaix.validator",
            "label": "UAIX 验证器",
            "uri": "/en-us/tools/validator/",
            "did": "did:web:uaix.org",
            "role": "conformance-checker",
            "implementation": "uaix-core-3.188.0"
        },
        "target": {
            "type": "message",
            "id": "msg-2026-04-22-0001",
            "label": "uai.intent.request.v1",
            "uri": "/wp-json/uaix/v1/examples/uai.intent.request.v1",
            "did": "did:web:uaix.org",
            "role": "checked-record",
            "implementation": "uai.intent.request.v1"
        },
        "conversation": {
            "conversation_id": "conv-2026-04-22-uaix-001",
            "turn_id": "turn-validator-7cdcc56bcab0",
            "parent_message_id": "msg-2026-04-22-0001",
            "sequence": 2,
            "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01"
        },
        "delivery": {
            "mode": "sync",
            "priority": "routine",
            "expires_at": "2026-08-04T14:12:08+00:00",
            "reply_requested": false,
            "ack_required": false
        },
        "trust": {
            "channel": "signed-envelope",
            "auth_scheme": "validator-record",
            "principal": "did:web:uaix.org",
            "credential_ref": "/.well-known/uai.json",
            "signature_ref": "/en-us/tools/validator/",
            "replay_window_id": "rw-conformance-20260728-7cdcc56bcab0"
        },
        "body": {
            "status": "pass",
            "checked_profile": "uai.intent.request.v1",
            "issues": [],
            "summary": {
                "error_count": 0,
                "warning_count": 0,
                "checked_at": "2026-07-28T14:12:08+00:00"
            },
            "artifacts": {
                "catalog_url": "/wp-json/uaix/v1/catalog",
                "schema_url": "/wp-json/uaix/v1/schemas/uai.intent.request.v1",
                "registry_url": "/wp-json/uaix/v1/registry/uai.intent.request.v1",
                "example_url": "/wp-json/uaix/v1/examples/uai.intent.request.v1",
                "field_registry_url": "/wp-json/uaix/v1/field-registry",
                "transport_bindings_url": "/wp-json/uaix/v1/transport-bindings",
                "trust_channels_url": "/wp-json/uaix/v1/trust-channels",
                "conformance_levels_url": "/wp-json/uaix/v1/conformance-levels",
                "error_registry_url": "/wp-json/uaix/v1/error-registry",
                "validate_url": "/wp-json/uaix/v1/validate"
            },
            "target_message_ref": "msg-2026-04-22-0001"
        },
        "provenance": {
            "trace_id": "trace-7f3a2d",
            "issued_at": "2026-07-28T14:12:08+00:00",
            "log_ref": "urn:uaix:log:2026:0001",
            "agent_id": "uaix.validator",
            "model_id": "model.uaix.validator-1",
            "confidence": 1,
            "lineage": [
                {
                    "stage": "conformance-export",
                    "actor_id": "uaix.validator",
                    "model_id": "model.uaix.validator-1",
                    "note": "生成时间 a validator-backed evidence record for the checked message using keyed-json normalization."
                }
            ],
            "parent_trace_id": "trace-7f3a2d"
        },
        "integrity": {
            "version": 2,
            "algorithm": "sha256",
            "canonicalization": "jcs",
            "checksum": "sha256:d5c3fef11e65c44dcd91b164df0ce15c03cf39c8b69ced323dcdab8c7da7d07d"
        },
        "extensions": [
            {
                "namespace": "urn:uaix:ext:evidence",
                "purpose": "Links conformance output to the exact 公开制品 used during validation.",
                "critical": false
            }
        ]
    },
    "download_filename": "msg-20260728T141208Z-7cdcc56bcab0.json"
}
公开记录项 公开记录项 uai-adoption-kit-manifest.json
代码示例
{
    "adoption_kit_url": "/wp-json/uaix/v1/adoption-kit",
    "download_url": "/wp-json/uaix/v1/adoption-kit?download=1",
    "current_release": "UAI-1",
    "starter_files": 9,
    "language_starters": 4,
    "first_packet_profile": "uai.intent.request.v1",
    "use": "Fetch the adoption_kit_url for the complete starter files and proof artifacts."
}
公开记录项 公开记录项 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
            }
        ]
    }
}
公开记录项 公开记录项 uai-mock-exchange.json
代码示例
{
    "kind": "uaix.mock.exchange.result.v1",
    "generated_at": "2026-07-28T14:12:08+00:00",
    "route_url": "/wp-json/uaix/v1/mock-exchange",
    "scenario": "accepted-task",
    "http_status": 202,
    "summary": "The reference surface accepted the request and returned a conforming async handoff using `uai.intent.response.v1`.",
    "request": {
        "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
                }
            ]
        },
        "validation": {
            "valid": true,
            "checked_at": "2026-07-28T14:12:08+00:00",
            "profile": "uai.intent.request.v1",
            "current_release": "UAI-1",
            "uai_version": "1.0",
            "schema_route_url": "/wp-json/uaix/v1/schemas/uai.intent.request.v1",
            "registry_route_url": "/wp-json/uaix/v1/registry/uai.intent.request.v1",
            "issue_count": 0,
            "error_count": 0,
            "warning_count": 0,
            "errors": [],
            "warnings": [],
            "status": "pass",
            "normalization": {
                "mode": "keyed-json",
                "status": "current",
                "supported": true,
                "input_shape": "json-object",
                "normalized": false,
                "registry_release": "UAI-1",
                "registry_release_date": "2026-06-02",
                "field_registry_url": "/wp-json/uaix/v1/field-registry",
                "canonicalization": "jcs-compatible-sorted-json",
                "canonical_hash": "sha256:df1471b14bfab5649ab461956640cfe8201aab274f3db190bc621dc195dc2abd",
                "byte_count": 2665
            },
            "conformance_record": {
                "uai_version": "1.0",
                "profile": "uai.conformance.result.v1",
                "message_id": "msg-20260728T141208Z-7cdcc56bcab0",
                "source": {
                    "type": "service",
                    "id": "uaix.validator",
                    "label": "UAIX 验证器",
                    "uri": "/en-us/tools/validator/",
                    "did": "did:web:uaix.org",
                    "role": "conformance-checker",
                    "implementation": "uaix-core-3.188.0"
                },
                "target": {
                    "type": "message",
                    "id": "msg-2026-04-22-0001",
                    "label": "uai.intent.request.v1",
                    "uri": "/wp-json/uaix/v1/examples/uai.intent.request.v1",
                    "did": "did:web:uaix.org",
                    "role": "checked-record",
                    "implementation": "uai.intent.request.v1"
                },
                "conversation": {
                    "conversation_id": "conv-2026-04-22-uaix-001",
                    "turn_id": "turn-validator-7cdcc56bcab0",
                    "parent_message_id": "msg-2026-04-22-0001",
                    "sequence": 2,
                    "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01"
                },
                "delivery": {
                    "mode": "sync",
                    "priority": "routine",
                    "expires_at": "2026-08-04T14:12:08+00:00",
                    "reply_requested": false,
                    "ack_required": false
                },
                "trust": {
                    "channel": "signed-envelope",
                    "auth_scheme": "validator-record",
                    "principal": "did:web:uaix.org",
                    "credential_ref": "/.well-known/uai.json",
                    "signature_ref": "/en-us/tools/validator/",
                    "replay_window_id": "rw-conformance-20260728-7cdcc56bcab0"
                },
                "body": {
                    "status": "pass",
                    "checked_profile": "uai.intent.request.v1",
                    "issues": [],
                    "summary": {
                        "error_count": 0,
                        "warning_count": 0,
                        "checked_at": "2026-07-28T14:12:08+00:00"
                    },
                    "artifacts": {
                        "catalog_url": "/wp-json/uaix/v1/catalog",
                        "schema_url": "/wp-json/uaix/v1/schemas/uai.intent.request.v1",
                        "registry_url": "/wp-json/uaix/v1/registry/uai.intent.request.v1",
                        "example_url": "/wp-json/uaix/v1/examples/uai.intent.request.v1",
                        "field_registry_url": "/wp-json/uaix/v1/field-registry",
                        "transport_bindings_url": "/wp-json/uaix/v1/transport-bindings",
                        "trust_channels_url": "/wp-json/uaix/v1/trust-channels",
                        "conformance_levels_url": "/wp-json/uaix/v1/conformance-levels",
                        "error_registry_url": "/wp-json/uaix/v1/error-registry",
                        "validate_url": "/wp-json/uaix/v1/validate"
                    },
                    "target_message_ref": "msg-2026-04-22-0001"
                },
                "provenance": {
                    "trace_id": "trace-7f3a2d",
                    "issued_at": "2026-07-28T14:12:08+00:00",
                    "log_ref": "urn:uaix:log:2026:0001",
                    "agent_id": "uaix.validator",
                    "model_id": "model.uaix.validator-1",
                    "confidence": 1,
                    "lineage": [
                        {
                            "stage": "conformance-export",
                            "actor_id": "uaix.validator",
                            "model_id": "model.uaix.validator-1",
                            "note": "生成时间 a validator-backed evidence record for the checked message using keyed-json normalization."
                        }
                    ],
                    "parent_trace_id": "trace-7f3a2d"
                },
                "integrity": {
                    "version": 2,
                    "algorithm": "sha256",
                    "canonicalization": "jcs",
                    "checksum": "sha256:d5c3fef11e65c44dcd91b164df0ce15c03cf39c8b69ced323dcdab8c7da7d07d"
                },
                "extensions": [
                    {
                        "namespace": "urn:uaix:ext:evidence",
                        "purpose": "Links conformance output to the exact 公开制品 used during validation.",
                        "critical": false
                    }
                ]
            },
            "download_filename": "msg-20260728T141208Z-7cdcc56bcab0.json"
        }
    },
    "response_profile": "uai.intent.response.v1",
    "response_message": {
        "uai_version": "1.0",
        "profile": "uai.intent.response.v1",
        "message_id": "msg-mock-accepted-597a626a1d45",
        "source": {
            "type": "service",
            "id": "uaix.mock.exchange",
            "label": "UAIX 模拟交换",
            "uri": "/wp-json/uaix/v1/mock-exchange",
            "did": "did:web:uaix.org",
            "role": "reference-server",
            "implementation": "uaix-core-3.188.0"
        },
        "target": {
            "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"
        },
        "conversation": {
            "conversation_id": "conv-2026-04-22-uaix-001",
            "turn_id": "turn-mock-597a626a1d45",
            "parent_message_id": "msg-2026-04-22-0001",
            "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-550702a0f1ed2653-01",
            "sequence": 2
        },
        "delivery": {
            "mode": "async",
            "priority": "interactive",
            "expires_at": "2026-04-22T16:05:00+00:00",
            "reply_requested": false,
            "ack_required": true,
            "task_ref": "task-mock-597a626a1d45"
        },
        "trust": {
            "channel": "signed-envelope",
            "auth_scheme": "jws",
            "principal": "did:web:uaix.org",
            "credential_ref": "/.well-known/uai.json",
            "signature_ref": "/wp-json/uaix/v1/mock-exchange#signature-597a626a1d45",
            "replay_window_id": "rw-mock-597a626a1d45"
        },
        "body": {
            "status": "accepted",
            "subject": "uai.task.status.v1",
            "request_message_id": "msg-2026-04-22-0001",
            "result": {
                "task_id": "task-mock-597a626a1d45",
                "status_profile": "uai.task.status.v1",
                "status_example_url": "/wp-json/uaix/v1/examples/uai.task.status.v1",
                "response_profile": "uai.intent.response.v1",
                "follow_up_scenarios": [
                    "completed-response",
                    "typed-error"
                ],
                "field_registry_url": "/wp-json/uaix/v1/field-registry",
                "mock_exchange_url": "/wp-json/uaix/v1/mock-exchange"
            },
            "notices": [
                "accepted-task-started",
                "use-task-status-example-for-shape-checks",
                "reference-surface-response"
            ],
            "task_ref": "task-mock-597a626a1d45"
        },
        "provenance": {
            "trace_id": "trace-7f3a2d",
            "issued_at": "2026-04-22T16:00:03+00:00",
            "log_ref": "urn:uaix:log:mock:20260728:597a626a1d45",
            "agent_id": "uaix.mock.exchange",
            "model_id": "model.uaix.mock.exchange-1",
            "confidence": 1,
            "lineage": [
                {
                    "stage": "mock-acceptance",
                    "actor_id": "uaix.mock.exchange",
                    "model_id": "model.uaix.mock.exchange-1",
                    "note": "Accepted the request and published a deterministic async handoff from the UAIX mock exchange surface."
                }
            ],
            "parent_trace_id": "trace-7f3a2d"
        },
        "integrity": {
            "version": 2,
            "algorithm": "sha256",
            "canonicalization": "jcs",
            "checksum": "sha256:2414b52708fa6f402ab1bfda68977b8c9ef1161aeb1b4a217cdbaaaed2425b38"
        },
        "extensions": [
            {
                "namespace": "urn:uaix:ext:mock-exchange",
                "purpose": "Marks this envelope as a deterministic response from the UAIX live reference surface for scenario `accepted-task`.",
                "critical": false
            }
        ]
    },
    "response_validation": {
        "valid": true,
        "checked_at": "2026-07-28T14:12:08+00:00",
        "profile": "uai.intent.response.v1",
        "current_release": "UAI-1",
        "uai_version": "1.0",
        "schema_route_url": "/wp-json/uaix/v1/schemas/uai.intent.response.v1",
        "registry_route_url": "/wp-json/uaix/v1/registry/uai.intent.response.v1",
        "issue_count": 0,
        "error_count": 0,
        "warning_count": 0,
        "errors": [],
        "warnings": [],
        "status": "pass",
        "normalization": {
            "mode": "keyed-json",
            "status": "current",
            "supported": true,
            "input_shape": "json-object",
            "normalized": false,
            "registry_release": "UAI-1",
            "registry_release_date": "2026-06-02",
            "field_registry_url": "/wp-json/uaix/v1/field-registry",
            "canonicalization": "jcs-compatible-sorted-json",
            "canonical_hash": "sha256:0f7e89e7c20edbc5f1bb0dfeef66e3c8ecf5ab70f284e9ef13e6a425a51a8268",
            "byte_count": 2709
        },
        "conformance_record": {
            "uai_version": "1.0",
            "profile": "uai.conformance.result.v1",
            "message_id": "msg-20260728T141208Z-a28792f1f54c",
            "source": {
                "type": "service",
                "id": "uaix.validator",
                "label": "UAIX 验证器",
                "uri": "/en-us/tools/validator/",
                "did": "did:web:uaix.org",
                "role": "conformance-checker",
                "implementation": "uaix-core-3.188.0"
            },
            "target": {
                "type": "message",
                "id": "msg-mock-accepted-597a626a1d45",
                "label": "uai.intent.response.v1",
                "uri": "/wp-json/uaix/v1/examples/uai.intent.response.v1",
                "did": "did:web:uaix.org",
                "role": "checked-record",
                "implementation": "uai.intent.response.v1"
            },
            "conversation": {
                "conversation_id": "conv-2026-04-22-uaix-001",
                "turn_id": "turn-validator-a28792f1f54c",
                "parent_message_id": "msg-mock-accepted-597a626a1d45",
                "sequence": 3,
                "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-550702a0f1ed2653-01"
            },
            "delivery": {
                "mode": "sync",
                "priority": "routine",
                "expires_at": "2026-08-04T14:12:08+00:00",
                "reply_requested": false,
                "ack_required": false
            },
            "trust": {
                "channel": "signed-envelope",
                "auth_scheme": "validator-record",
                "principal": "did:web:uaix.org",
                "credential_ref": "/.well-known/uai.json",
                "signature_ref": "/en-us/tools/validator/",
                "replay_window_id": "rw-conformance-20260728-a28792f1f54c"
            },
            "body": {
                "status": "pass",
                "checked_profile": "uai.intent.response.v1",
                "issues": [],
                "summary": {
                    "error_count": 0,
                    "warning_count": 0,
                    "checked_at": "2026-07-28T14:12:08+00:00"
                },
                "artifacts": {
                    "catalog_url": "/wp-json/uaix/v1/catalog",
                    "schema_url": "/wp-json/uaix/v1/schemas/uai.intent.response.v1",
                    "registry_url": "/wp-json/uaix/v1/registry/uai.intent.response.v1",
                    "example_url": "/wp-json/uaix/v1/examples/uai.intent.response.v1",
                    "field_registry_url": "/wp-json/uaix/v1/field-registry",
                    "transport_bindings_url": "/wp-json/uaix/v1/transport-bindings",
                    "trust_channels_url": "/wp-json/uaix/v1/trust-channels",
                    "conformance_levels_url": "/wp-json/uaix/v1/conformance-levels",
                    "error_registry_url": "/wp-json/uaix/v1/error-registry",
                    "validate_url": "/wp-json/uaix/v1/validate"
                },
                "target_message_ref": "msg-mock-accepted-597a626a1d45"
            },
            "provenance": {
                "trace_id": "trace-7f3a2d",
                "issued_at": "2026-07-28T14:12:08+00:00",
                "log_ref": "urn:uaix:log:mock:20260728:597a626a1d45",
                "agent_id": "uaix.validator",
                "model_id": "model.uaix.validator-1",
                "confidence": 1,
                "lineage": [
                    {
                        "stage": "conformance-export",
                        "actor_id": "uaix.validator",
                        "model_id": "model.uaix.validator-1",
                        "note": "生成时间 a validator-backed evidence record for the checked message using keyed-json normalization."
                    }
                ],
                "parent_trace_id": "trace-7f3a2d"
            },
            "integrity": {
                "version": 2,
                "algorithm": "sha256",
                "canonicalization": "jcs",
                "checksum": "sha256:521a24a222e7bfca086a63e5e408ac48145b214d0c38a479486e7115f1c99489"
            },
            "extensions": [
                {
                    "namespace": "urn:uaix:ext:evidence",
                    "purpose": "Links conformance output to the exact 公开制品 used during validation.",
                    "critical": false
                }
            ]
        },
        "download_filename": "msg-20260728T141208Z-a28792f1f54c.json"
    },
    "links": {
        "catalog_url": "/wp-json/uaix/v1/catalog",
        "validate_url": "/wp-json/uaix/v1/validate",
        "field_registry_url": "/wp-json/uaix/v1/field-registry",
        "response_example_url": "/wp-json/uaix/v1/examples/uai.intent.response.v1",
        "task_status_example_url": "/wp-json/uaix/v1/examples/uai.task.status.v1"
    }
}

目录

/wp-json/uaix/v1/catalog

GET

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

发现

/wp-json/uaix/v1/discovery

GET

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

模式

/wp-json/uaix/v1/schemas

GET

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

注册表

/wp-json/uaix/v1/registry

GET

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

字段注册表

/wp-json/uaix/v1/field-registry

GET

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

传输绑定

/wp-json/uaix/v1/transport-bindings

GET

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

信任通道

/wp-json/uaix/v1/trust-channels

GET

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

一致性级别

/wp-json/uaix/v1/conformance-levels

GET

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

错误注册表

/wp-json/uaix/v1/error-registry

GET

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

示例

/wp-json/uaix/v1/examples

GET

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

验证

/wp-json/uaix/v1/validate

POST

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

领养套件

/wp-json/uaix/v1/adoption-kit

GET

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

路线图

/wp-json/uaix/v1/roadmap

GET

在复述未来支持声明之前,先解析当前、下一步、已计划和研究轨道的路线图边界。

公开记录项

/wp-json/uaix/v1/mock-exchange

GET

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

模拟交流

/wp-json/uaix/v1/mock-exchange

POST

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

公开记录项

/wp-json/uaix/v1/openapi.json

GET

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

一致性包

/wp-json/uaix/v1/conformance-pack

GET

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

公开记录项

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

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

X-Content-Type-Options

nosniff

防止公开标准页面和机器可读路由发生内容类型嗅探。

应用于: 公开 HTML、JSON、XML 以及类似的 WordPress 渲染响应。

Referrer-Policy

strict-origin-when-cross-origin

在保留同源调试上下文的同时,进一步收窄跨源 referrer 泄露。

应用于: 可能产生外部请求的公开文档和 API 响应。

Permissions-Policy

accelerometer=(), browsing-topics=(), camera=(), geolocation=(), gyroscope=(), magnetometer=(), microphone=(), payment=(), usb=()

明确声明启动表面不依赖特权浏览器能力,也不依赖基于 Topics 的广告功能。

应用于: 公开 WordPress 渲染页面与面向机器的路由。

X-Frame-Options

SAMEORIGIN

在保留同源编辑与预览流程的同时,阻止第三方框架嵌入。

应用于: 公开 WordPress 渲染页面与 JSON 响应。

Content-Security-Policy

frame-ancestors 'self'

在现代浏览器中明确框架边界,而不提前声称已经具备更广泛的全站 CSP。

应用于: 公开 WordPress 渲染页面与面向机器的路由。

Strict-传输-Security

max-age=31536000; includeSubDomains

把浏览器后续访问固定到规范上线主机的 HTTPS,而不只依赖政策文案。

应用于: 请求通过 HTTPS 提供时的公开 WordPress 渲染 HTML 和 REST 响应。

当前已生效

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

  • X-Pingback 已从公开响应中移除。
  • 如果启动环境在 WordPress 执行后仍附加主机级或代理级版本头,这些头仍需要在服务器侧抑制。
  • 这些响应头现在会随公开 WordPress 渲染的 HTML 与 REST 响应一同交付,而不再只是路线图文案中的计划。

部署缺口

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

  • HTTP 到 HTTPS 重定向以及直接提供的静态文件的 HSTS 覆盖仍属于上线主机或 CDN 边缘层,因为本地 Studio 环境使用普通 HTTP。
  • 任何直接提供的静态根文件都应在服务器或边缘层检查,以确保其响应头与 WordPress 渲染的信任姿态保持一致。
  • 凡是部署栈在 WordPress 之外附加的主机级版本暴露,例如代理或 PHP 签名头,都应在相应层面被抑制。
  • 更广泛的 CSP 指令应在面向生产的资源与嵌入行为相对于启动主机验证通过之后再添加。

范围边界: 当前响应头层适用于公开的 WordPress 前端和 REST 响应,包括验证器和面向机器的评审路由;HSTS 只在 HTTPS 请求上发送。

下一步

继续领养套件如果您需要已发布的第一证明捆绑包,一致性包如果您需要更广泛的可重用 JSON 数据包,请打开/wp-json/uaix/v1/roadmap如果自动化需要未来工作边界,或者返回到验证器当下一个任务正在运行或导出一个具体的验证检查时。