> ## 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.

# Scores de confiance

> Évaluation continue de la confiance comportementale pour les agents IA avec des facteurs de score configurables.

# Scores de confiance

Les scores de confiance fournissent une **évaluation continue et en temps réel** de la fiabilité comportementale d'un agent IA. Chaque agent de la plateforme Truthlocks reçoit un score de 0 à 100, mis à jour après chaque action.

## Comment ça marche

```
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]
>
> Tous les points de terminaison de score de confiance et de témoin disposent d'un API playground interactif. Ouvrez n'importe quel point de terminaison dans la référence de l'API [Confiance et témoin](https://docs.truthlocks.com/fr/api-reference/machine-identity/trust-scores/get.md) et cliquez sur **Envoyer** pour l'essayer en direct.

## Facteurs de notation

| Facteur | Poids par défaut | Description |
| - | - | - |
| `behavioral_compliance` | 35% | Les actions restent dans les limites de la portée déclarée |
| `scope_adherence` | 25% | Aucune tentative d'accès à des ressources non autorisées |
| `anomaly_score` | 20% | Déviation statistique par rapport aux modèles de comportement historiques |
| `peer_attestations` | 10% | D'autres agents du réseau de témoins garantissent le comportement |
| `session_hygiene` | 10% | Cycle de vie de session approprié (création, renouvellement, terminaison) |

## Lecture des scores de confiance

### Obtenir le score actuel

```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"
}
```

### Obtenir l'historique des scores

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

### Forcer le recalcul

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

## Configuration des seuils

| Seuil | Action recommandée |
| - | - |
| 90-100 | Autonomie complète — l'agent opère sans intervention |
| 70-89 | Opération standard — surveillance normale |
| 50-69 | Surveillance améliorée — alerter l'équipe, augmenter la verbosité des journaux |
| 30-49 | Mode restreint — nécessite une approbation humaine pour les actions critiques |
| 0-29 | Suspension automatique — interrupteur d'arrêt déclenché |

## Réseau de témoins

Les agents peuvent participer à un **réseau de témoins** où les pairs attestent du comportement de chacun.

### Créer une demande de témoin

```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 }
  }'
```

### Attester en tant que témoin

```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
  }'
```

### Consensus

```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
}
```

## Intégration avec Risk Engine

Les scores de confiance alimentent directement le moteur d'évaluation des risques de Truthlocks. Des scores de confiance faibles augmentent automatiquement le signal de risque pour toute action entreprise par l'agent :

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

## Mesure de l'utilisation

Chaque calcul de score de confiance à la demande incrémente le compteur d'utilisation `maip.trust_computes` pour votre cycle de facturation. Les mises à jour de score en arrière-plan déclenchées par la plateforme (comme après les actions de l'agent) comptent également pour cette métrique.

Vous pouvez surveiller votre consommation avec l'[API d'utilisation](https://docs.truthlocks.com/fr/api-reference/billing/usage.md) ou dans la console sous **Paramètres > Facturation > Utilisation** dans la section **MAIP**.

> [!NOTE]
>
> Les quotas de calcul du score de confiance varient selon le niveau du plan. Consultez l'[aperçu de la facturation](https://docs.truthlocks.com/fr/billing/overview.md#metered-products) pour plus de détails sur tous les produits mesurés par MAIP.

## Prochaines étapes

> [card] [Identité machine](https://docs.truthlocks.com/guides/machine-identity.md)
>
> Vue d'ensemble complète du protocole d'identité de l'agent machine.

> [card] [Délégation inter-locataires](https://docs.truthlocks.com/guides/cross-tenant-delegation.md)
>
> Permettre aux agents d'opérer au-delà des frontières organisationnelles.


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