Saltar al contenido
Volver al blog
Guías para desarrolladores6 min de lectura

Building Agentic Commerce #3: cómo interpretar Trust Score v4.1

Trust Score v4.1: tres dimensiones ponderadas, un bonus opcional y topes de confianza. Consulta el motor de cada respuesta; puede recurrir a v2.

Resumen ejecutivo

Trust Score v4.1 combina tres dimensiones ponderadas, un bonus opcional de aseguramiento externo y topes según confianza. Cada respuesta identifica el motor utilizado; algunas recurren a v2. El desglose legacy por componentes no explica una puntuación global producida por v4.1.

Publicado

2026-04-06

Actualizado: 2026-09-13

6 min de lectura

Autoría

Trusteed

Publicado por Trusteed

Escrito y mantenido por quienes construyen Trusteed. Las afirmaciones técnicas de estos artículos se respaldan en las superficies enlazadas desde cada pieza y en el registro de capacidades firmado en /.well-known/trusteed-capabilities.json, que es el árbitro cuando un artículo y una superficie de estado se contradicen.

Sobre Trusteed

Categoría

Guías para desarrolladores

building-agentic-commercetrust-scoreseidaskyaiverificación-merchantsguia-developeragentes-iaseguridadranking

Trust Score v4.1 combina tres dimensiones ponderadas, un bonus opcional de aseguramiento externo y topes según confianza. Cada respuesta identifica el motor utilizado; algunas recurren a v2. El desglose legacy por componentes no explica una puntuación global producida por v4.1.

Emitir un recibo no significa que se haya liquidado un pago. En la revisión del 2026-09-13, el registro público de comercios declaraba beta_closed, ningún comercio de producción y accepts_real_payments=false. Consulta /.well-known/merchant-index.json para conocer la disponibilidad actual; las demostraciones y vistas previas de checkout no acreditan compras reales.

Idea clave

Consulta el motor antes que el número

Consulta engines.overall y engines.breakdown antes de interpretar el número. overall usa 0–1; trust_score_v41 usa 0–100 cuando está disponible. Con engines.mixed=true, el desglose no explica overall. insufficient_data indica falta de evidencia utilizable, no un cero medido; la ruta pública puede devolver un resultado degradado de v2.

Un agente que consume scores de Trusteed puede usarlos como una señal de decisión. Otros agentes pueden usar reseñas, información visual u otras fuentes. Una puntuación no autoriza una compra, no sustituye el consentimiento ni garantiza la entrega.

Cómo se calcula v4.1

  • 1
    merchantReliabilityBase: evidencia operativa sobre el comercio.
  • 2
    agenticReadiness: preparación para atender a agentes.
  • 3
    agenticEvidence: evidencia de operaciones con agentes.
  • 4
    External Assurance: bonus opcional de hasta 10 puntos, sujeto a condiciones de evidencia. No es una cuarta dimensión ponderada.

Los pesos dependen de la confianza y se renormalizan entre las dimensiones aplicables. El bonus externo se aplica tras el score base y antes del tope del nivel. En el modelo base publicado, los topes son 65 para cold_start, 85 para human_established, 92 para agent_verified_thin y 100 para agent_verified. Consulta la metodología viva para los criterios y las extensiones habilitadas; el nombre de un nivel no es un certificado de identidad.

Falta de evidencia y fallback

Distingue verified, measured, proxy, self_declared, not_applicable y synthetic_blocked como calidades de evidencia diferentes. La ausencia de datos no debe presentarse como un cero medido. Si el overlay v4.1 está deshabilitado, falla o no produce un valor, la ruta pública puede servir v2. Un resultado degradado de v2 no es comparable con v4.1 como si exigieran la misma evidencia.

Consulta y verifica la respuesta API

GET https://api.trusteed.xyz/api/v1/stores/{slug}/trust-score devuelve el score público. Resuelve el comercio y su origen de datos desde /.well-known/merchant-index.json; no presupongas que la misma ruta en otro host lee la misma base de datos. Verifica la firma de la respuesta con el JWKS de confianza del emisor. Una firma válida autentica la respuesta, no la calidad de todos los datos de origen.

Observado el 2026-09-13 en demo-store, una tienda sandbox; es un ejemplo fechado, no su score actual: ```json { "overall": 0.447, "trust_score_v41": 44.7, "confidence_level": "cold_start", "engines": { "overall": "v4.1", "breakdown": "v2", "mixed": true } } ```

Ranking de búsqueda y políticas de checkout

La elegibilidad de búsqueda, el ranking y los controles de checkout son decisiones separadas. Consulta el contrato del endpoint y la configuración del comercio. El score público puede proceder de un motor distinto al valor almacenado que usa la búsqueda. Etiquetas como VERIFIED son bandas de puntuación, no pruebas de identidad ni permiso para omitir la confirmación.

La confianza del comercio y del agente son distintas

El Trust Score del comercio describe al comercio. La confianza del agente comprador y vendedor corresponde a otros actores y a sus controles. No uses el score del comercio como autorización del agente ni copies umbrales entre esas políticas.

Legacy v2: desglose por componentes

El modelo legacy v2 es una suma ponderada en escala 0–1, programada cada 6 horas. Sus componentes pueden aparecer junto a una puntuación global v4.1 cuando engines.mixed=true. Usa este desglose para explicar un número solo si engines.overall identifica v2. El endpoint de metodología publica los pesos y marca este alcance como legacy_v2.

  • 1
    Señales de catálogo: lo completos, lo frescos y lo exactos que son los datos del comercio en precio y disponibilidad.
  • 2
    Señales operativas: qué cubren las políticas publicadas del comercio, y cómo han ido de verdad sus checkouts, sus entregas y sus disputas.
  • 3
    Señales de posventa y coherencia, añadidas en v2 sobre las ocho originales.
  • 4
    Este artículo nombra los grupos, no los campos. GET /api/v1/trust/methodology devuelve cada componente con su peso y etiqueta este ámbito como legacy_v2: esa lista es la que no puede quedarse vieja, y una copia en un artículo es la primera que se queda.

Comprobaciones para integrar el score

  • 1
    Consulta juntos el host del comercio, engines, escalas, confianza y fecha.
  • 2
    Si la respuesta es mixta, no reconstruyas el score v4.1 con componentes v2.
  • 3
    Trata la evidencia ausente y el fallback v2 de forma explícita en tu política.
  • 4
    Consulta las reglas y la autorización por separado del score.
  • 5
    Comprueba la disponibilidad de pagos reales antes de tratar una vista previa o demo como una compra.

Preguntas frecuentes

¿Cómo se calcula el Trust Score actual?

Trust Score v4.1 combina tres dimensiones ponderadas, un bonus opcional de aseguramiento externo y topes según confianza. Cada respuesta identifica el motor utilizado; algunas recurren a v2. El desglose legacy por componentes no explica una puntuación global producida por v4.1.

¿Por qué la API muestra 0–1 y 0–100?

Consulta engines.overall y engines.breakdown antes de interpretar el número. overall usa 0–1; trust_score_v41 usa 0–100 cuando está disponible. Con engines.mixed=true, el desglose no explica overall. insufficient_data indica falta de evidencia utilizable, no un cero medido; la ruta pública puede devolver un resultado degradado de v2.

¿Cada cuánto se recalcula?

El job legacy v2 está programado cada 6 horas. El overlay público v4.1 puede ejecutarse por petición. Consulta juntos motor y fecha, sobre todo en respuestas mixtas.

¿Un score alto autoriza un pago?

No. La autorización, las reglas del comercio y la disponibilidad de pagos requieren comprobaciones separadas. Un score no garantiza liquidación ni entrega.

Fuentes y referencias

Artículos relacionados

Building Agentic Commerce #3: cómo interpretar Trust Score v4.1 | Trusteed | Trusteed