Herramientas

Kit de adopción

Published first-proof bundle with starter files, validator-ready payloads, mock-response handoff, and implementation next steps.

  • Record UAIX-TOOL-0063
  • Path /es-es/tools/adoption-kit/
  • Use Canonical public record

Document status

Public standards page Published on UAIX as part of the current public standards record
Code
UAIX-TOOL-0063
Surface
Herramientas
Access
Public and linkable

如何使用本页

Use this page to fetch the published onboarding bundle, starter files, and first-proof handoff packet.

Related surfaces

ComenzarValidadorReferencia APIPaquete de conformidad

First-Proof Bundle

Start here when one validator-backed packet needs to travel cleanly

The adoption kit is the shortest published onboarding surface. It keeps starter files, validator-ready payloads, mock-exchange examples, the implementation evidence checklist, conformance fixture pack, and implementation next steps together so teams can move from first read to first reusable proof packet without assembling the route map by hand.

What ships

Starter files and multi-language calls

Use the kit when you want one public packet that already includes the first validator request, mock handoff packet, and copyable client snippets.

How to prove it

Validator and mock exchange together

The kit matters most when it feeds one validator-backed packet and one live mock response instead of remaining a read-only sample.

Where it goes next

Evidence checklist and fixture pack

Carry the first-proof packet into Implementations for named support lanes, then run the fixture pack and fill the evidence checklist before the conformance pack travels into launch review.

Related surfaces

ComenzarHuman-facing onboarding path into the bundle.ValidadorHuman-facing proof run and result export.Referencia APIFull route inventory and OpenAPI contract.Paquete de conformidadBroader release-evidence bundle for launch review.ImplementacionesNamed release lanes for carrying the packet forward.

Proof path

Validator-backed proof path

Keep the public reading order tied to one evidence trail: profile, schema, example, validator result, and release record.

  1. 1Pick a message profile.Start with a published UAI-1 profile and the record family that matches the exchange you need to prove.
  2. 2Compare it with schemas and examples.Resolve the schema, registry entry, and one fixture before writing or mapping your candidate packet.
  3. 3Run validator evidence.Validate keyed, minified-keyed, or keyless JSON against the current public UAI-1 records.
  4. 4Attach the result to implementation or handoff records.Carry the exported result into Conformance Pack, 实施轨道, changelog, or Project Handoff evidence.
Starter runFetch the bundle, validate one packet, then test the response handoff
curl -s https://uaix.org/wp-json/uaix/v1/adoption-kit
curl -OJ "https://uaix.org/wp-json/uaix/v1/adoption-kit?download=1"
curl -s -X POST https://uaix.org/wp-json/uaix/v1/validate -H "Content-Type: application/json" -d @validate-request.json
curl -s -X POST https://uaix.org/wp-json/uaix/v1/mock-exchange -H "Content-Type: application/json" -d @mock-exchange-request.json

Use the adoption-kit route as the machine-readable handoff for onboarding, then validate and mock the same packet before widening the evidence bundle.

What this page is for

Use this page as the shortest published onboarding bundle for a first proof run against the live UAI-1 surface. It keeps the starter files, validator-ready payloads, mock-exchange examples, an implementation-evidence checklist, conformance fixture pack, and implementation next steps in one public packet.

包含内容 in the kit

  • Copyable starter files for the first message, validator request, and release-review handoff.
  • Multi-language starter calls for curl, PowerShell, Python, and TypeScript.
  • One implementation-evidence checklist covering identity, supported profile scope, validator output, machine-route and cache posture, trust and threat boundaries, locale and accessibility QA, fixtures, release trail, and support boundary.
  • One conformance fixture pack with current positive keyed/minified/keyless cases, canonical-hash equivalence metadata, and negative missing-profile, missing-required-field, undeclared-field, invalid-traceparent, DID/VC trust-evidence, keyless-shape, keyless-overflow, and unsupported-alias cases.
  • One reference mock-exchange packet plus direct links back to schemas, registry, examples, and 实施轨道.

When to use it

  1. Start here when a team needs the shortest route from reading UAI-1 to producing one reusable validator-backed packet.
  2. Complete the checklist and run the fixture pack before turning a first proof into public release or support language.
  3. Move to API 参考 when you need the full route inventory and OpenAPI contract.
  4. Move to 一致性包 when the packet needs the broader release-evidence bundle for launch review or regression work.

Definition of done for a first proof

  • The message declares one published profile and passes the matching schema and validator policy checks.
  • The evidence packet names the schema, registry entry, field registry, example or fixture, validator result, and checked route URLs.
  • The implementation names exactly what it supports and what it does not support before any public support language is used.
  • Machine-route posture, POST guardrails, trust-channel assumptions, and release-trail links are captured beside the packet.
  • The proof can be rerun by another reviewer from public UAIX routes without private notes.

Published onboarding bundle

Use the adoption kit below to fetch the current first-proof packet and keep the exact starter files, checklist, and fixture pack together.

Adoption kit

已发布的首次证明数据包

当你需要一个从公开契约开始、携带可验证请求、包含一致性记录并指向下一条发布路径的机器可读入门包时,使用此数据包,无需私有背景。

随包一起发布的内容

最小公开证明包

  • 起步消息、验证请求、一致性记录和模拟交换请求。
  • 第一个起步配置文件的模式、注册表、示例和机器路由链接。
  • WordPress 和 .NET 发布路径的实现轨道入口。
  • 另一位评审者无需私有设置说明即可复用的可下载 JSON。

最佳用途

把团队从阅读带到证明

Use the adoption kit for first-day onboarding, launch QA, evaluator handoff, or internal pairing when a teammate needs the shortest public route from the spec to one reviewable packet.

Starter sequence

真实首次使用时如何使用此工具包

  1. 先打开已发布的采用工具包页面或 JSON 路由,让入门从当前公开数据包开始,而不是从私有笔记开始。
  2. 解析一个起步配置文件,然后把它的模式、注册表条目和示例 fixture 一起保留为首次证明包。
  3. 运行验证器,并把生成的一致性记录附在评审时使用的准确起步数据包旁边。
  4. 当运行时轨道尚未发布自身实现、但你需要一个实时一致响应包时,把同一数据包提交到模拟交换。
  5. 在从首次证明推进到公开发布或支持表述前,填写实现证据清单。
  6. 在扩大发布数据包前,使用一致性 fixture 包检查当前正向和反向验证器行为。
  7. 当候选实现需要展示 A2A、MCP、OpenAPI、DID/VC 或 Trace Context 证据如何映射到 UAI-1 记录时,使用桥接证据包。
  8. 在对外提出支持声明前,把证明包带入已命名实现轨道、一致性包和发布轨迹。
Starter file manifest Fetch starter files from the adoption kit JSON uai-adoption-kit-manifest.json
Code example
{
    "adoption_kit_url": "/wp-json/uaix/v1/adoption-kit",
    "download_url": "/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,
                6,
                7,
                8,
                9
            ]
        },
        {
            "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"
            ]
        },
        {
            "label": "Capability profile starter",
            "filename": "capability-profile.json",
            "top_level_keys": [
                "uai_version",
                "profile",
                "message_id",
                "source",
                "target",
                "conversation",
                "delivery",
                "trust",
                "body",
                "provenance",
                "integrity",
                "extensions"
            ]
        },
        {
            "label": "Capability negotiation starter",
            "filename": "capability-negotiation.json",
            "top_level_keys": [
                "uai_version",
                "profile",
                "message_id",
                "source",
                "target",
                "conversation",
                "delivery",
                "trust",
                "body",
                "provenance",
                "integrity",
                "extensions"
            ]
        }
    ],
    "use": "Fetch the adoption kit JSON for the full starter file contents."
}
模拟交换响应 已接收任务参考包 uai-mock-exchange.json
Code example
{
    "kind": "uaix.mock.exchange.result.v1",
    "generated_at": "2026-06-11T06:19:38+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-06-11T06:19:38+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-08",
                "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-20260611T061938Z-5ca61c838b79",
                "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.88.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-5ca61c838b79",
                    "parent_message_id": "msg-2026-04-22-0001",
                    "sequence": 2,
                    "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01"
                },
                "delivery": {
                    "mode": "sync",
                    "priority": "routine",
                    "expires_at": "2026-06-18T06:19:38+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-20260611-5ca61c838b79"
                },
                "body": {
                    "status": "pass",
                    "checked_profile": "uai.intent.request.v1",
                    "issues": [],
                    "summary": {
                        "error_count": 0,
                        "warning_count": 0,
                        "checked_at": "2026-06-11T06:19:38+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-06-11T06:19:38+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-20260611T061938Z-5ca61c838b79.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.88.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:20260611: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:4a47fb9d3e7771504ba41ed7388fb792c977387ac57dee9a8c76639948880bf4"
        },
        "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-06-11T06:19:38+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-08",
            "field_registry_url": "/wp-json/uaix/v1/field-registry",
            "canonicalization": "jcs-compatible-sorted-json",
            "canonical_hash": "sha256:a707cab98243e3a0695246e828bd02083a2585f15114931e9b79aba33095e081",
            "byte_count": 2708
        },
        "conformance_record": {
            "uai_version": "1.0",
            "profile": "uai.conformance.result.v1",
            "message_id": "msg-20260611T061938Z-3dcb0aad395c",
            "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.88.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-3dcb0aad395c",
                "parent_message_id": "msg-mock-accepted-597a626a1d45",
                "sequence": 3,
                "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-550702a0f1ed2653-01"
            },
            "delivery": {
                "mode": "sync",
                "priority": "routine",
                "expires_at": "2026-06-18T06:19:38+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-20260611-3dcb0aad395c"
            },
            "body": {
                "status": "pass",
                "checked_profile": "uai.intent.response.v1",
                "issues": [],
                "summary": {
                    "error_count": 0,
                    "warning_count": 0,
                    "checked_at": "2026-06-11T06:19:38+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-06-11T06:19:38+00:00",
                "log_ref": "urn:uaix:log:mock:20260611: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:1b81cf08e71cd0fd5849b2500ec1f416dfbbb80637c9a6452edd3c6d220dfeea"
            },
            "extensions": [
                {
                    "namespace": "urn:uaix:ext:evidence",
                    "purpose": "Links conformance output to the exact 公开制品 used during validation.",
                    "critical": false
                }
            ]
        },
        "download_filename": "msg-20260611T061938Z-3dcb0aad395c.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"
    }
}

Keep the starter packet, validator record, mock response, and named implementation lane together. That bundle is the public adoption handoff the site now publishes directly.

路由-level starter calls

Use the route and language examples below when you want the same packet in curl, PowerShell, Python, or TypeScript.

Client examples

curl、PowerShell、Python 和 TypeScript 的路由级起步请求

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

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

curl

普通 shell

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

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

下一步 step

Continue to Implementations when the proof run needs a named release lane, return to 验证器 when you want the workbench workflow, or use API 参考 when you need the broader machine contract behind the kit.