> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truthlocks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Puntuaciones de Confianza

> Evaluación continua de la confianza conductual para agentes de IA con factores de puntuación configurables.

# Puntuaciones de Confianza

Las puntuaciones de confianza proporcionan una **evaluación continua y en tiempo real** de la fiabilidad del comportamiento de un agente de IA. Cada agente en la plataforma Truthlocks recibe una puntuación de 0 a 100, actualizada después de cada acción.

## Cómo funciona

```
Agent Action → Event Logged → Score Recomputed → Policy Evaluated
                                    │
                              ┌─────┴─────┐
                              │ Score: 87  │
                              │ Trend: ↑   │
                              └────────────┘
                                    │
                        ┌───────────┼───────────┐
                        ▼           ▼           ▼
                    No Action   Alert Team   Suspend Agent
                   (score > 70) (50 < s < 70) (score < 50)
```

> [!TIP]
>
> Todos los endpoints de puntuación de confianza y testigo tienen un API playground interactivo. Abra cualquier endpoint en la referencia de la API [Confianza y Testigo](https://docs.truthlocks.com/es/api-reference/machine-identity/trust-scores/get.md) y haga clic en **Enviar** para probarlo en vivo.

## Factores de puntuación

| Factor | Peso predeterminado | Descripción |
| - | - | - |
| `behavioral_compliance` | 35% | Las acciones se mantienen dentro de los límites del alcance declarado |
| `scope_adherence` | 25% | No hay intentos de acceder a recursos no autorizados |
| `anomaly_score` | 20% | Desviación estadística de los patrones de comportamiento históricos |
| `peer_attestations` | 10% | Otros agentes en la red de testigos avalan el comportamiento |
| `session_hygiene` | 10% | Ciclo de vida de sesión adecuado (creación, renovación, terminación) |

## Lectura de puntuaciones de confianza

### Obtener puntuación actual

```bash theme={null}
curl https://api.truthlocks.com/v1/trust-scores/maip-agent:01JXXXX \
  -H "X-API-Key: $API_KEY"
```

```json theme={null}
{
  "agent_id": "maip-agent:01JXXXX",
  "score": 87,
  "factors": {
    "behavioral_compliance": 92,
    "scope_adherence": 95,
    "anomaly_score": 12,
    "peer_attestations": 78,
    "session_hygiene": 90
  },
  "trend": "stable",
  "computed_at": "2026-04-06T12:00:00Z"
}
```

### Obtener historial de puntuaciones

```bash theme={null}
curl "https://api.truthlocks.com/v1/trust-scores/maip-agent:01JXXXX/history?period=7d" \
  -H "X-API-Key: $API_KEY"
```

### Forzar recálculo

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/trust-scores/maip-agent:01JXXXX/compute \
  -H "X-API-Key: $API_KEY"
```

## Configuración de umbrales

| Umbral | Acción recomendada |
| - | - |
| 90-100 | Autonomía total — el agente opera sin intervención |
| 70-89 | Operación estándar — monitoreo normal |
| 50-69 | Monitoreo mejorado — alertar al equipo, aumentar la verbosidad del registro |
| 30-49 | Modo restringido — requiere aprobación humana para acciones críticas |
| 0-29 | Suspensión automática — interruptor de emergencia activado |

## Red de Testigos

Los agentes pueden participar en una **red de testigos** donde los pares dan fe del comportamiento de los demás.

### Crear una solicitud de testigo

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/witness/request \
  -H "X-API-Key: $API_KEY" \
  -d '{
    "subject_agent_id": "maip-agent:01JXXXX",
    "claim": "Completed invoice processing without errors",
    "evidence": { "task_id": "task_456", "records_processed": 150 }
  }'
```

### Atestiguar como testigo

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/witness/maip-witness:01JWWWW/attest \
  -H "X-API-Key: $API_KEY" \
  -d '{
    "attestor_agent_id": "maip-agent:01JBBBB",
    "verdict": "confirmed",
    "confidence": 0.95
  }'
```

### Consenso

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/witness/maip-witness:01JWWWW/consensus \
  -H "X-API-Key: $API_KEY"
```

```json theme={null}
{
  "witness_id": "maip-witness:01JWWWW",
  "consensus": "confirmed",
  "confidence": 0.91,
  "attestations": 4,
  "quorum_met": true
}
```

## Integración con Risk Engine

Las puntuaciones de confianza se incorporan directamente al motor de evaluación de riesgos de Truthlocks. Las puntuaciones de confianza bajas aumentan automáticamente la señal de riesgo para cualquier acción que realice el agente:

```
Trust Score < 50 → Risk Signal: HIGH → Action blocked or requires approval
```

## Medición de uso

Cada cálculo de puntuación de confianza bajo demanda incrementa el contador de uso de `maip.trust_computes` para su ciclo de facturación. Las actualizaciones de puntuación en segundo plano activadas por la plataforma (como después de las acciones del agente) también cuentan para esta métrica.

Puede monitorear su consumo con la [API de uso](https://docs.truthlocks.com/es/api-reference/billing/usage.md) o en la consola en **Configuración > Facturación > Uso** en la sección **MAIP**.

> [!NOTE]
>
> Las cuotas de cálculo de la puntuación de confianza varían según el nivel del plan. Consulte el [resumen de facturación](https://docs.truthlocks.com/es/billing/overview.md#metered-products) para obtener detalles sobre todos los productos medidos de MAIP.

## Próximos pasos

> [card] [Identidad de máquina](https://docs.truthlocks.com/guides/machine-identity.md)
>
> Descripción general completa del Protocolo de Identidad del Agente de Máquina.

> [card] [Delegación entre inquilinos](https://docs.truthlocks.com/guides/cross-tenant-delegation.md)
>
> Permitir que los agentes operen a través de los límites organizacionales.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.