工具

接入套件

已发布的首次证明包,包含起步文件、可直接提交到验证器的载荷、mock-response 交接以及实施下一步。

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

文件状态

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

如何使用本页

使用本页获取已发布的接入包、起步文件与首次证明交接数据包。

相关页面

开始使用验证器API 参考一致性包

首次证明包

当一份由验证器背书的数据包需要清晰流转时,从这里开始

接入套件是当前最短的已发布接入表面。它把起步文件、可直接提交到验证器的载荷、mock-exchange 示例、实施证据清单、一致性 fixture 包以及实施下一步集中在一起,让团队无需手工拼装路由地图,就能从第一次阅读走到第一份可复用证明数据包。

包含内容

起步文件与多语言调用

当你需要一份已经包含首个验证请求、mock 交接包以及可复制客户端片段的公开数据包时,请使用此套件。

如何证明

验证器与 mock exchange 联合使用

当这个套件真正产出一份由验证器背书的数据包和一份实时 mock 响应,而不是只停留在只读示例时,它才最有价值。

下一步去向

证据清单与 fixture 包

把首次证明数据包带到 Implementations 中的具名支持轨道;在一致性包进入启动评审前,先运行 fixture 包并填写证据清单。

相关页面

开始使用此处说明当前公开记录、证据路径和支持边界。验证器面向人工的证明运行与结果导出。API 参考完整路由清单与 OpenAPI 契约。一致性包用于启动评审的更完整发布证据包。实施轨道用于继续推进该数据包的具名发布轨道。
起步运行获取数据包、验证一份消息,再测试响应交接
curl -s http://uiax.org/wp-json/uaix/v1/adoption-kit
curl -OJ "http://uiax.org/wp-json/uaix/v1/adoption-kit?download=1"
curl -s -X POST http://uiax.org/wp-json/uaix/v1/validate -H "Content-Type: application/json" -d @validate-request.json
curl -s -X POST http://uiax.org/wp-json/uaix/v1/mock-exchange -H "Content-Type: application/json" -d @mock-exchange-request.json

把 adoption-kit 路由作为接入流程中的机器可读交接点,然后在扩展证据包之前,对同一份数据包完成验证与 mock 测试。

本页用途

把本页作为针对实时 UAI-1 表面的最短公开接入包。它把起步文件、可直接提交到验证器的载荷、mock exchange 示例、实施证据清单、一致性 fixture 包以及实施下一步集中在一个公开数据包里。

套件包含的内容

  • 可直接复制的首条消息、验证请求与发布评审交接文件。
  • 适用于 curl、PowerShell、Python 与 TypeScript 的多语言起步调用。
  • 一份参考 mock-exchange 数据包、一份实施证据清单、一份包含正向与反向验证器用例的一致性 fixture 包,以及回到模式、注册表、示例和实施轨道的直接链接。

何时使用

  1. 当团队需要从阅读 UAI-1 直接走到一个可复用、由验证器背书的首次数据包时,从这里开始。
  2. 当第一次证明需要进入发布评审时,运行 fixture 包,并填写实施名称、版本、profile 范围、验证器结果、fixture 引用、变更日志链接和支持边界。
  3. 当你需要完整路由清单与 OpenAPI 契约时,转到 API 参考。
  4. 当该数据包需要扩展为启动评审或回归检查所用的更完整证据包时,转到 一致性包。

已发布的接入包

使用下面的接入套件获取当前首次证明数据包,并把精确起步文件、证据清单和 fixture 包保持在一起。

公开记录项

公开记录项

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

公开记录项

公开记录项

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

公开记录项

公开记录项

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

公开记录项

公开记录项

  1. 先打开已发布的采用工具包页面或 JSON 路由,让入门从当前公开数据包开始,而不是从私有笔记开始。
  2. 解析一个起步配置文件,然后把它的模式、注册表条目和示例 fixture 一起保留为首次证明包。
  3. 运行验证器,并把生成的一致性记录附在评审时使用的准确起步数据包旁边。
  4. 当运行时轨道尚未发布自身实现、但你需要一个实时一致响应包时,把同一数据包提交到模拟交换。
  5. 在从首次证明推进到公开发布或支持表述前,填写实现证据清单。
  6. 在扩大发布数据包前,使用一致性 fixture 包检查当前正向和反向验证器行为。
  7. 当候选实现需要展示 A2A、MCP、OpenAPI、DID/VC 或 Trace Context 证据如何映射到 UAI-1 记录时,使用桥接证据包。
  8. 在对外提出支持声明前,把证明包带入已命名实现轨道、一致性包和发布轨迹。
公开记录项 此处说明当前公开记录、证据路径和支持边界。 uai-adoption-kit-manifest.json
{
    "adoption_kit_url": "http://uiax.org/wp-json/uaix/v1/adoption-kit",
    "download_url": "http://uiax.org/wp-json/uaix/v1/adoption-kit?download=1",
    "starter_files": [
        {
            "label": "Starter message",
            "filename": "starter-message.json",
            "top_level_keys": [
                "uai_version",
                "profile",
                "message_id",
                "source",
                "target",
                "conversation",
                "delivery",
                "trust",
                "body",
                "provenance",
                "integrity",
                "extensions"
            ]
        },
        {
            "label": "Validation request",
            "filename": "validate-request.json",
            "top_level_keys": [
                "message",
                "normalization_mode",
                "format"
            ]
        },
        {
            "label": "Mock exchange request",
            "filename": "mock-exchange-request.json",
            "top_level_keys": [
                "scenario",
                "format",
                "message"
            ]
        },
        {
            "label": "一致性 record",
            "filename": "uai-conformance-record.json",
            "top_level_keys": [
                "uai_version",
                "profile",
                "message_id",
                "source",
                "target",
                "conversation",
                "delivery",
                "trust",
                "body",
                "provenance",
                "integrity",
                "extensions"
            ]
        },
        {
            "label": "Implementation evidence checklist",
            "filename": "implementation-evidence-checklist.json",
            "top_level_keys": [
                0,
                1,
                2,
                3,
                4,
                5
            ]
        },
        {
            "label": "一致性 fixture pack",
            "filename": "conformance-fixture-pack.json",
            "top_level_keys": [
                "kind",
                "generated_at",
                "current_release",
                "uai_version",
                "profile_id",
                "purpose",
                "fixture_count",
                "positive_count",
                "negative_count",
                "coverage",
                "canonical_hash_equivalence",
                "route_contract",
                "cases"
            ]
        },
        {
            "label": "Bridge evidence pack",
            "filename": "bridge-evidence-pack.json",
            "top_level_keys": [
                "kind",
                "generated_at",
                "standard_family",
                "current_release",
                "uai_version",
                "release_date",
                "description",
                "support_boundary",
                "case_count",
                "validated_case_count",
                "adjacent_standard_count",
                "adjacent_standards",
                "uai_profiles",
                "available_in",
                "verification",
                "cases"
            ]
        }
    ],
    "use": "Fetch the adoption kit JSON for the full starter file contents."
}
公开记录项 公开记录项 uai-mock-exchange.json
{
    "kind": "uaix.mock.exchange.result.v1",
    "generated_at": "2026-04-26T20:12:12+00:00",
    "route_url": "http://uiax.org/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": "https://uaix.org/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"
            },
            "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-04-26T20:12:12+00:00",
            "profile": "uai.intent.request.v1",
            "current_release": "UAI-1",
            "uai_version": "1.0",
            "schema_route_url": "http://uiax.org/wp-json/uaix/v1/schemas/uai.intent.request.v1",
            "registry_route_url": "http://uiax.org/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-04-22",
                "field_registry_url": "http://uiax.org/wp-json/uaix/v1/field-registry",
                "canonicalization": "jcs-compatible-sorted-json",
                "canonical_hash": "sha256:ea001827f8204b5282544b0306c596aca64923bd76cc7ed77f252c2b2084062b",
                "byte_count": 2112
            },
            "conformance_record": {
                "uai_version": "1.0",
                "profile": "uai.conformance.result.v1",
                "message_id": "msg-20260426T201212Z-c61fc93cb5a3",
                "source": {
                    "type": "service",
                    "id": "uaix.validator",
                    "label": "UAIX 验证器",
                    "uri": "http://uiax.org/en-us/tools/validator/",
                    "did": "did:web:uaix.org",
                    "role": "conformance-checker",
                    "implementation": "uaix-core-0.9.11"
                },
                "target": {
                    "type": "message",
                    "id": "msg-2026-04-22-0001",
                    "label": "uai.intent.request.v1",
                    "uri": "http://uiax.org/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-c61fc93cb5a3",
                    "parent_message_id": "msg-2026-04-22-0001",
                    "sequence": 2,
                    "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01"
                },
                "delivery": {
                    "mode": "sync",
                    "priority": "routine",
                    "expires_at": "2026-05-03T20:12:12+00:00",
                    "reply_requested": false,
                    "ack_required": false
                },
                "trust": {
                    "channel": "signed-envelope",
                    "auth_scheme": "validator-record",
                    "principal": "did:web:uaix.org",
                    "credential_ref": "http://uiax.org/.well-known/uai.json",
                    "signature_ref": "http://uiax.org/en-us/tools/validator/",
                    "replay_window_id": "rw-conformance-20260426-c61fc93cb5a3"
                },
                "body": {
                    "status": "pass",
                    "checked_profile": "uai.intent.request.v1",
                    "issues": [],
                    "summary": {
                        "error_count": 0,
                        "warning_count": 0,
                        "checked_at": "2026-04-26T20:12:12+00:00"
                    },
                    "artifacts": {
                        "catalog_url": "http://uiax.org/wp-json/uaix/v1/catalog",
                        "schema_url": "http://uiax.org/wp-json/uaix/v1/schemas/uai.intent.request.v1",
                        "registry_url": "http://uiax.org/wp-json/uaix/v1/registry/uai.intent.request.v1",
                        "example_url": "http://uiax.org/wp-json/uaix/v1/examples/uai.intent.request.v1",
                        "field_registry_url": "http://uiax.org/wp-json/uaix/v1/field-registry",
                        "transport_bindings_url": "http://uiax.org/wp-json/uaix/v1/transport-bindings",
                        "trust_channels_url": "http://uiax.org/wp-json/uaix/v1/trust-channels",
                        "conformance_levels_url": "http://uiax.org/wp-json/uaix/v1/conformance-levels",
                        "error_registry_url": "http://uiax.org/wp-json/uaix/v1/error-registry",
                        "validate_url": "http://uiax.org/wp-json/uaix/v1/validate"
                    },
                    "target_message_ref": "msg-2026-04-22-0001"
                },
                "provenance": {
                    "trace_id": "trace-7f3a2d",
                    "issued_at": "2026-04-26T20:12:12+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:fb31e0116d019906346c03551112ae98ff39c9dc874b4f199629296b3888d9e3"
                },
                "extensions": [
                    {
                        "namespace": "urn:uaix:ext:evidence",
                        "purpose": "Links conformance output to the exact 公开制品 used during validation.",
                        "critical": false
                    }
                ]
            },
            "download_filename": "msg-20260426T201212Z-c61fc93cb5a3.json"
        }
    },
    "response_profile": "uai.intent.response.v1",
    "response_message": {
        "uai_version": "1.0",
        "profile": "uai.intent.response.v1",
        "message_id": "msg-mock-accepted-529a0c03c1bb",
        "source": {
            "type": "service",
            "id": "uaix.mock.exchange",
            "label": "UAIX 模拟交换",
            "uri": "http://uiax.org/wp-json/uaix/v1/mock-exchange",
            "did": "did:web:uaix.org",
            "role": "reference-server",
            "implementation": "uaix-core-0.9.11"
        },
        "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-529a0c03c1bb",
            "parent_message_id": "msg-2026-04-22-0001",
            "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-55e4155501e108df-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-529a0c03c1bb"
        },
        "trust": {
            "channel": "signed-envelope",
            "auth_scheme": "jws",
            "principal": "did:web:uaix.org",
            "credential_ref": "http://uiax.org/.well-known/uai.json",
            "signature_ref": "http://uiax.org/wp-json/uaix/v1/mock-exchange#signature-529a0c03c1bb",
            "replay_window_id": "rw-mock-529a0c03c1bb"
        },
        "body": {
            "status": "accepted",
            "subject": "uai.task.status.v1",
            "request_message_id": "msg-2026-04-22-0001",
            "result": {
                "task_id": "task-mock-529a0c03c1bb",
                "status_profile": "uai.task.status.v1",
                "status_example_url": "http://uiax.org/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": "http://uiax.org/wp-json/uaix/v1/field-registry",
                "mock_exchange_url": "http://uiax.org/wp-json/uaix/v1/mock-exchange"
            },
            "notices": [
                "accepted-task-started",
                "use-task-status-example-for-shape-checks",
                "reference-surface-response"
            ],
            "task_ref": "task-mock-529a0c03c1bb"
        },
        "provenance": {
            "trace_id": "trace-7f3a2d",
            "issued_at": "2026-04-22T16:00:03+00:00",
            "log_ref": "urn:uaix:log:mock:20260426:529a0c03c1bb",
            "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:240f1ecaa3662482c7d9a62199db94ce09f206d80a1e657a3e039aad6328e066"
        },
        "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-04-26T20:12:12+00:00",
        "profile": "uai.intent.response.v1",
        "current_release": "UAI-1",
        "uai_version": "1.0",
        "schema_route_url": "http://uiax.org/wp-json/uaix/v1/schemas/uai.intent.response.v1",
        "registry_route_url": "http://uiax.org/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-04-22",
            "field_registry_url": "http://uiax.org/wp-json/uaix/v1/field-registry",
            "canonicalization": "jcs-compatible-sorted-json",
            "canonical_hash": "sha256:90acf6cfc9e1527bf23eddde96c80128d9153a8c79af30055eb19fdaf89c2b62",
            "byte_count": 2702
        },
        "conformance_record": {
            "uai_version": "1.0",
            "profile": "uai.conformance.result.v1",
            "message_id": "msg-20260426T201212Z-94536e29bf33",
            "source": {
                "type": "service",
                "id": "uaix.validator",
                "label": "UAIX 验证器",
                "uri": "http://uiax.org/en-us/tools/validator/",
                "did": "did:web:uaix.org",
                "role": "conformance-checker",
                "implementation": "uaix-core-0.9.11"
            },
            "target": {
                "type": "message",
                "id": "msg-mock-accepted-529a0c03c1bb",
                "label": "uai.intent.response.v1",
                "uri": "http://uiax.org/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-94536e29bf33",
                "parent_message_id": "msg-mock-accepted-529a0c03c1bb",
                "sequence": 3,
                "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-55e4155501e108df-01"
            },
            "delivery": {
                "mode": "sync",
                "priority": "routine",
                "expires_at": "2026-05-03T20:12:12+00:00",
                "reply_requested": false,
                "ack_required": false
            },
            "trust": {
                "channel": "signed-envelope",
                "auth_scheme": "validator-record",
                "principal": "did:web:uaix.org",
                "credential_ref": "http://uiax.org/.well-known/uai.json",
                "signature_ref": "http://uiax.org/en-us/tools/validator/",
                "replay_window_id": "rw-conformance-20260426-94536e29bf33"
            },
            "body": {
                "status": "pass",
                "checked_profile": "uai.intent.response.v1",
                "issues": [],
                "summary": {
                    "error_count": 0,
                    "warning_count": 0,
                    "checked_at": "2026-04-26T20:12:12+00:00"
                },
                "artifacts": {
                    "catalog_url": "http://uiax.org/wp-json/uaix/v1/catalog",
                    "schema_url": "http://uiax.org/wp-json/uaix/v1/schemas/uai.intent.response.v1",
                    "registry_url": "http://uiax.org/wp-json/uaix/v1/registry/uai.intent.response.v1",
                    "example_url": "http://uiax.org/wp-json/uaix/v1/examples/uai.intent.response.v1",
                    "field_registry_url": "http://uiax.org/wp-json/uaix/v1/field-registry",
                    "transport_bindings_url": "http://uiax.org/wp-json/uaix/v1/transport-bindings",
                    "trust_channels_url": "http://uiax.org/wp-json/uaix/v1/trust-channels",
                    "conformance_levels_url": "http://uiax.org/wp-json/uaix/v1/conformance-levels",
                    "error_registry_url": "http://uiax.org/wp-json/uaix/v1/error-registry",
                    "validate_url": "http://uiax.org/wp-json/uaix/v1/validate"
                },
                "target_message_ref": "msg-mock-accepted-529a0c03c1bb"
            },
            "provenance": {
                "trace_id": "trace-7f3a2d",
                "issued_at": "2026-04-26T20:12:12+00:00",
                "log_ref": "urn:uaix:log:mock:20260426:529a0c03c1bb",
                "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:fdc11523fdef9866b9e3860282494f2b7c283c8b1bc651f99966f791a5c1c021"
            },
            "extensions": [
                {
                    "namespace": "urn:uaix:ext:evidence",
                    "purpose": "Links conformance output to the exact 公开制品 used during validation.",
                    "critical": false
                }
            ]
        },
        "download_filename": "msg-20260426T201212Z-94536e29bf33.json"
    },
    "links": {
        "catalog_url": "http://uiax.org/wp-json/uaix/v1/catalog",
        "validate_url": "http://uiax.org/wp-json/uaix/v1/validate",
        "field_registry_url": "http://uiax.org/wp-json/uaix/v1/field-registry",
        "response_example_url": "http://uiax.org/wp-json/uaix/v1/examples/uai.intent.response.v1",
        "task_status_example_url": "http://uiax.org/wp-json/uaix/v1/examples/uai.task.status.v1"
    }
}

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

路由级起步请求

当你希望用 curl、PowerShell、Python 或 TypeScript 直接请求同一份数据包时,请使用下面的公开示例。

公开记录项

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

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

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

curl

普通 shell

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

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

下一步

当首次证明运行需要落到一个具名发布轨道时,继续前往 实施轨道;当你需要人工工作台流程时,返回 验证器;当你需要接入套件背后的更广机器契约时,转到 API 参考。