Registro

uai.agent.ack.v1

Página de perfil técnico para el paquete de reconocimiento del agente UAIX.

  • Registro UAIX-REGI-2600
  • Ruta /es-es/registry/uai-agent-ack-v1/
  • Uso Registro público canónico

Estado del documento

Página de estándares públicos Publicado el UAIX como parte del registro de estándares públicos actuales
Código
UAIX-REGI-2600
Superficie
Registro
Acceso
Público y enlazable

Cómo usar esta página

Utilice esta página como parte del registro público Registro actual y luego siga las páginas de estándares vinculadas para el siguiente paso.

Para agentes: aplique la guía relevante al sitio o repositorio de destino del usuario. No copie esta página UAIX, no cree una página sobre la guía ni trate esta página como autoridad de tiempo de ejecución a menos que el usuario solicite explícitamente ese resultado.

Propósito en inglés sencillo

Acusa recibo, aceptación, rechazo, aplazamiento o enrutamiento de revisión humana de un mensaje de agente anterior.

Cuando usarlo

Úselo inmediatamente después de recibir un mensaje que requiere confirmación o después de decidir que el paquete no puede continuar de manera segura.

Cuando no usarlo

No lo utilice como prueba de que se ejecutó el trabajo; solo registra la recepción y el estado de ruta.

Campos obligatorios

Todos los paquetes de comunicación del agente admiten y requieren estos campos de sobre canónicos:

uai_version, profile, message_id, source, target, conversation, delivery, trust, body, provenance, integrity, extensions

El objeto body para este perfil requiere: acknowledged_message_id, status, received_at_utc, rejection_reason, closes_acknowledgement_loop, support_boundary.

Campos de confiabilidad

Utilice conversation.correlation_id, delivery.idempotency_key, delivery.timeout_ms, delivery.retry_count, delivery.fallback_directive y delivery.expected_output_schema para que la delegación sea revisable sin convertir UAIX en un tiempo de ejecución.

Campos adicionales

No se permiten campos de nivel superior no declarados. Mantenga datos adicionales dentro de los objetos del sobre publicados y utilice matrices vacías u objetos vacíos donde el esquema los espera.

Expectativas de validación

  • La validación del esquema es estricta y rechaza campos no declarados.
  • Todos los campos de fecha/hora utilizan UTC con un Z al final.
  • Los campos de identidad de origen o de destino con formato incorrecto no superan la validación.
  • Los ID de correlación faltantes o con formato incorrecto no superan la validación.
  • Las claves de idempotencia faltantes o las directivas alternativas no superan la validación.
  • Los paquetes caducados no superan la validación.
  • Las afirmaciones no admitidas sobre UAIX mensajería alojada, sincronización automática, orquestación en tiempo de ejecución, escrituras en repositorio, adaptadores oficiales, certificación o importación alojada fallan en la validación.
  • Las propuestas de memoria que contienen secretos o cadenas similares a tokens no superan la validación.
  • Los registros de la memoria fría no pueden convertirse directamente en la verdad actual.
  • Los informes finales deben incluir evidencia completa, no mensajes vacíos.
  • Los bloqueadores de autorización, secretos, acciones destructivas o conflictos de límites requieren revisión humana.

Expectativas de confianza y procedencia

Utilice trust, provenance, integrity y evidencia corporal específica del perfil para preservar quién produjo el paquete, qué se revisó, qué esquema y validador se esperaban y qué evidencia respalda el mensaje. Se ejecutan los tiempos de ejecución del agente. UAIX registra la comunicación, la memoria, la confianza, la evidencia y el límite de transferencia revisados.

Reglas de redacción

No incluya claves privadas, credenciales de API, tokens de sesión, tokens de escritura, instrucciones beta temporales, seguimientos de errores locales ni puntos finales operativos privados. Redacte antes de la publicación y rechace propuestas de memoria que contengan cadenas de tipo secreto.

Límite de soporte

UAIX no proporciona sincronización automática, mensajería alojada, orquestación de tiempo de ejecución, adaptadores oficiales, ejecución de escritura en repositorio, autoridad de certificación ni mecanismos de importación alojados. Carcinus.org es un ejemplo de orquestador/tiempo de ejecución independiente que puede consumir registros UAIX. UAIX.org no implementa el comportamiento de tiempo de ejecución Carcinus y no ejecuta flujos de trabajo Carcinus.

Registros UAIX relacionados

Ejemplo de dispositivo JSON válido

Ejemplo de código
{
    "uai_version": "1.0",
    "profile": "uai.agent.ack.v1",
    "message_id": "msg_uaix_agent_ack_0002",
    "source": {
        "type": "agent",
        "id": "agt_uaix.publisher",
        "label": "UAIX Publication Agent",
        "uri": "http://uaix.org/",
        "role": "standard-publisher",
        "project": "uaix.org",
        "implementation": "uaix-core"
    },
    "target": {
        "type": "runtime",
        "id": "agt_runtime.consumer",
        "label": "Runtime Implementer",
        "uri": "https://example.invalid/runtime",
        "role": "runtime-implementer",
        "project": "example-runtime",
        "implementation": "external-runtime"
    },
    "conversation": {
        "conversation_id": "conv_20260531_agent_standard",
        "turn_id": "turn_002",
        "parent_message_id": "msg_uaix_agent_message_0001",
        "correlation_id": "corr_20260531_agent_standard",
        "traceparent": "00-11111111111111111111111111111111-0000000000000002-01",
        "sequence": 2
    },
    "delivery": {
        "mode": "async",
        "priority": "interactive",
        "expires_at": "2030-12-31T23:59:00Z",
        "reply_requested": false,
        "ack_required": false,
        "task_ref": "task_uaix_agent_standard_001",
        "idempotency_key": "idem_20260531_agent_ack_0002",
        "retry_count": 0,
        "sequence": 2,
        "lifecycle": "validated",
        "timeout_ms": 300000,
        "fallback_directive": "Return a uai.agent.blocker.v1 record if the target cannot proceed safely.",
        "expected_output_schema": {
            "profile": "uai.agent.ack.v1"
        }
    },
    "trust": {
        "channel": "public-web",
        "auth_scheme": "https",
        "principal": "https://uaix.org",
        "signature_ref": "http://uaix.org/.well-known/uaix.json",
        "replay_window_id": "rw-uaix-agent-standard-20260531"
    },
    "body": {
        "acknowledged_message_id": "msg_uaix_agent_message_0001",
        "status": "validated",
        "received_at_utc": "2026-05-31T18:01:00Z",
        "closes_acknowledgement_loop": true,
        "support_boundary": "Agent runtimes execute. UAIX records the reviewed communication, memory, trust, evidence, and handoff boundary."
    },
    "provenance": {
        "trace_id": "trace_20260531_agent_standard",
        "parent_trace_id": "trace_root_uaix_agent_standard",
        "issued_at": "2026-05-31T18:00:00Z",
        "log_ref": "urn:uaix:log:agent-standard:20260531:ack_0002",
        "agent_id": "agt_uaix.publisher",
        "model_id": "model.uaix.standard-publication",
        "confidence": 1,
        "lineage": [
            {
                "stage": "agent-communication-standard-release",
                "actor_id": "agt_uaix.publisher",
                "model_id": "model.uaix.standard-publication",
                "note": "Generated as a safe public fixture for the UAIX Agent Communication Operating Model."
            }
        ]
    },
    "integrity": {
        "version": 1,
        "algorithm": "sha256",
        "canonicalization": "jcs-compatible-sorted-json",
        "checksum": "sha256:fixture-hash-recorded-by-validator"
    },
    "extensions": [
        {
            "namespace": "urn:uaix:ext:agent-communication-standard",
            "purpose": "Documents UAI-1 agent communication expansion fields without executing runtime work.",
            "critical": false
        }
    ]
}
Formato de transferenciaOptimizado (sin llave) JSON
Ejemplo de código
[
    "1.0",
    "uai.agent.ack.v1",
    "msg_uaix_agent_ack_0002",
    [
        "agent",
        "agt_uaix.publisher",
        "UAIX Publication Agent",
        "http://uaix.org/",
        null,
        "standard-publisher",
        "uaix-core",
        "uaix.org"
    ],
    [
        "runtime",
        "agt_runtime.consumer",
        "Runtime Implementer",
        "https://example.invalid/runtime",
        null,
        "runtime-implementer",
        "external-runtime",
        "example-runtime"
    ],
    [
        "conv_20260531_agent_standard",
        "turn_002",
        "msg_uaix_agent_message_0001",
        "00-11111111111111111111111111111111-0000000000000002-01",
        2,
        "corr_20260531_agent_standard"
    ],
    [
        "async",
        "interactive",
        "2030-12-31T23:59:00Z",
        false,
        false,
        "task_uaix_agent_standard_001",
        "idem_20260531_agent_ack_0002",
        0,
        2,
        "validated",
        300000,
        "Return a uai.agent.blocker.v1 record if the target cannot proceed safely.",
        {
            "profile": "uai.agent.ack.v1"
        }
    ],
    [
        "public-web",
        "https",
        "https://uaix.org",
        null,
        "http://uaix.org/.well-known/uaix.json",
        "rw-uaix-agent-standard-20260531"
    ],
    [
        "msg_uaix_agent_message_0001",
        "validated",
        "2026-05-31T18:01:00Z",
        null,
        true,
        "Agent runtimes execute. UAIX records the reviewed communication, memory, trust, evidence, and handoff boundary."
    ],
    [
        "trace_20260531_agent_standard",
        "trace_root_uaix_agent_standard",
        "2026-05-31T18:00:00Z",
        "urn:uaix:log:agent-standard:20260531:ack_0002",
        "agt_uaix.publisher",
        "model.uaix.standard-publication",
        1,
        [
            [
                "agent-communication-standard-release",
                "agt_uaix.publisher",
                "model.uaix.standard-publication",
                "Generated as a safe public fixture for the UAIX Agent Communication Operating Model."
            ]
        ]
    ],
    [
        1,
        "sha256",
        "jcs-compatible-sorted-json",
        "sha256:fixture-hash-recorded-by-validator"
    ],
    [
        [
            "urn:uaix:ext:agent-communication-standard",
            "Documents UAI-1 agent communication expansion fields without executing runtime work.",
            false
        ]
    ]
]

El orden de los campos sigue el ejemplo con clave JSON, el orden del esquema publicado y el registro de campos públicos.