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

# Vertrauens-Scores

> Kontinuierliche Verhaltensvertrauensbewertung für KI-Agenten mit konfigurierbaren Bewertungsfaktoren.

# Vertrauenswerte

Vertrauens-Scores bieten eine **kontinuierliche, Echtzeit-Bewertung** der Verhaltenszuverlässigkeit eines KI-Agenten. Jeder Agent in der Truthlocks-Plattform erhält einen Score von 0 bis 100, der nach jeder Aktion aktualisiert wird.

## Funktionsweise

```
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]
>
> Alle Trust Score- und Witness-Endpunkte verfügen über einen interaktiven API-Playground. Öffnen Sie einen beliebigen Endpunkt in der [Trust & Witness](https://docs.truthlocks.com/de/api-reference/machine-identity/trust-scores/get.md) API-Referenz und klicken Sie auf **Senden**, um ihn live zu testen.

## Bewertungsfaktoren

| Faktor | Standardgewicht | Beschreibung |
| - | - | - |
| `behavioral_compliance` | 35% | Aktionen bleiben innerhalb der deklarierten Bereichsgrenzen |
| `scope_adherence` | 25% | Keine Versuche, auf nicht autorisierte Ressourcen zuzugreifen |
| `anomaly_score` | 20% | Statistische Abweichung von historischen Verhaltensmustern |
| `peer_attestations` | 10% | Andere Agenten im Zeugennetzwerk bürgen für das Verhalten |
| `session_hygiene` | 10% | Korrekter Sitzungslebenszyklus (Erstellung, Erneuerung, Beendigung) |

## Vertrauenswerte lesen

### Aktuellen Score abrufen

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

### Score-Historie abrufen

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

### Neuberechnung erzwingen

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

## Schwellenwerte konfigurieren

| Schwellenwert | Empfohlene Aktion |
| - | - |
| 90-100 | Volle Autonomie – Agent arbeitet ohne Eingriff |
| 70-89 | Standardbetrieb – normale Überwachung |
| 50-69 | Erweiterte Überwachung – Team alarmieren, Ausführlichkeit der Protokollierung erhöhen |
| 30-49 | Eingeschränkter Modus – menschliche Genehmigung für kritische Aktionen erforderlich |
| 0-29 | Automatische Sperrung – Notschalter ausgelöst |

## Witness-Netzwerk

Agenten können an einem **Zeugennetzwerk** teilnehmen, in dem sich Peers gegenseitig das Verhalten bestätigen.

### Erstellen einer Zeugenanfrage

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

### Als Zeuge attestieren

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

### Konsens

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

## Integration mit Risk Engine

Vertrauens-Scores fließen direkt in die Truthlocks-Risikobewertungs-Engine ein. Niedrige Vertrauens-Scores erhöhen automatisch das Risikosignal für jede Aktion, die der Agent ausführt:

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

## Nutzungsabrechnung

Jede On-Demand-Vertrauensbewertung erhöht den Nutzungszähler `maip.trust_computes` für Ihren Abrechnungszyklus. Hintergrund-Score-Updates, die von der Plattform ausgelöst werden (z. B. nach Agentenaktionen), zählen ebenfalls zu dieser Metrik.

Sie können Ihren Verbrauch mit der [Nutzungs-API](https://docs.truthlocks.com/de/api-reference/billing/usage.md) oder in der Konsole unter **Einstellungen > Abrechnung > Nutzung** im Abschnitt **MAIP** überwachen.

> [!NOTE]
>
> Die Quoten für die Berechnung des Vertrauensscores variieren je nach Planstufe. Details zu allen MAIP-Produkten finden Sie in der [billing overview](https://docs.truthlocks.com/de/billing/overview.md#metered-products).

## Nächste Schritte

> [card] [Maschinenidentität](https://docs.truthlocks.com/guides/machine-identity.md)
>
> Vollständige Übersicht über das Machine Agent Identity Protocol.

> [card] [Mandantenübergreifende Delegation](https://docs.truthlocks.com/guides/cross-tenant-delegation.md)
>
> Ermöglichen Sie Agenten, organisationsübergreifend zu agieren.


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