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

# Unabhängige Agentenbewertungen

> Fordern Sie eine menschliche Überprüfung an, sammeln Sie unterschiedliche Entscheidungen und setzen Sie das Endergebnis in Ihrer Anwendung durch.

Agentengenehmigungen erfassen menschliche Entscheidungen über eine vorgeschlagene Agentenaktion in einer Arbeitsbereichsumgebung. Sie sind getrennt von Workflow-Engine-Genehmigungen, Berechtigungsvergaben, kryptografischen Aktionsbelegen und temporärer Ausführung.

## Bevor Sie beginnen

* Einen aktiven Agenten aus demselben Arbeitsbereich und derselben Umgebung wie Ihre Anmeldeinformationen verwenden.
* Anfragen mit einem Workspace-API-Schlüssel oder einem angemeldeten Workspace-Benutzer erstellen.
* Prüfer müssen aktive menschliche Workspace-Mitglieder mit der Workspace-Berechtigung `tenant:governance:approve` sein. Eine reine Organisationsrolle ist nicht ausreichend.
* Der Anfragende kann seine eigene Anfrage nicht genehmigen oder ablehnen. Jeder Prüfer kann einmal entscheiden. API-Schlüssel können keine menschlichen Stimmen abgeben.

Öffnen Sie in der Console **KI-Agenten → Agenten-Genehmigungen**. Die Antrags-, Überprüfungs- und Stornierungsformulare haben jeweils eine eigene Seite. Speichern Sie den Antragslink, um dorthin zurückzukehren, nachdem er die Warteschlange verlassen hat.

## Eine Anfrage erstellen

Dieses Beispiel fordert zwei unabhängige Genehmigungen innerhalb eines einstündigen Fensters an. Ersetzen Sie den Agent-Bezeichner durch einen vorhandenen Sandbox-Agenten; ein Produktions-Agent kann nicht mit einem Sandbox-Anmeldeinformationen verwendet werden.

```bash theme={null}
curl --fail-with-body https://sandbox-api.truthlocks.com/v1/approvals \
  -H "X-API-Key: $TRUTHLOCKS_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
    "agent_id": "YOUR_SANDBOX_AGENT_ID",
    "action": "publish reviewed report",
    "resource": "reports/quarterly-review",
    "scope": "reports:publish",
    "risk_level": "high",
    "justification": "The report has completed technical review. Confirm the approved version before publication.",
    "required_approvals": 2,
    "ttl_minutes": 60
  }'
```

Die `201`-Antwort enthält `id`, `requested_by`, `status: "pending"`, `current_approvals: 0` und `expires_at`. Speichern Sie `id`; die Erstellung veröffentlicht den Bericht nicht und erstellt keinen Hintergrund-Workflow.

## Überprüfung mit einer menschlichen Sitzung

Verwenden Sie die Console für interaktive Entscheidungen. Wenn Ihre Integration die API verwendet, geben Sie die kurzlebige Bearer-Sitzung des Prüfers für den Arbeitsbereich an. Ersetzen Sie keinen API-Schlüssel und betten Sie kein Sitzungstoken in den Quellcode ein.

```bash theme={null}
curl --fail-with-body "https://sandbox-api.truthlocks.com/v1/approvals/$APPROVAL_ID/approve" \
  -H "Authorization: Bearer $TRUTHLOCKS_REVIEWER_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"reason":"Reviewed the exact report version and its supporting evidence."}'
```

Die erste Genehmigung in diesem Beispiel gibt `status: "pending"` und `current_approvals: 1` zurück. Ein anderer autorisierter Prüfer muss die zweite Stimme abgeben. Die Wiederverwendung desselben Prüfers führt zu einem Konflikt. Eine Ablehnung ändert die Anfrage sofort in `rejected`, unabhängig von früheren Genehmigungen.

Der Dienst überprüft aktuelle Mitgliedschaftsberechtigungen, Anfragenbesitz, Ablauf und bestehende Abstimmungen innerhalb der Entscheidungstransaktion. Abstimmungen und das Audit-Ereignis werden zusammen festgeschrieben. Entscheidungen können über diese APIs nicht bearbeitet oder gelöscht werden.

## Ergebnis prüfen und durchsetzen

```bash theme={null}
curl --fail-with-body "https://sandbox-api.truthlocks.com/v1/approvals/$APPROVAL_ID" \
  -H "X-API-Key: $TRUTHLOCKS_API_KEY"
```

Die Detailantwort enthält die Prüferhistorie. Fahren Sie nur fort, wenn `status` `approved` ist und die Anfrage immer noch dem genauen Agenten, der Aktion, der Ressource und dem Umfang entspricht, die Ihre Anwendung verwenden möchte. Ihre Anwendung muss auch die aktuellen Zugriffsberechtigungen, den Agentenstatus und ihre eigenen Einmal- oder Wiederholungssteuerungen durchsetzen. Diese Genehmigungsdatensätze bieten keinen automatischen Ausführungs- oder Verbrauchsmechanismus.

| Status | Bedeutung |
| - | - |
| `pending` | Weitere unabhängige Genehmigungen sind erforderlich. |
| `approved` | Das konfigurierte Quorum wurde innerhalb des Überprüfungszeitraums erreicht. |
| `rejected` | Ein unabhängiger Prüfer hat die Anfrage abgelehnt. |
| `expired` | Eine ausstehende Anfrage hat ihre Überprüfungsfrist überschritten. |
| `cancelled` | Der ursprüngliche Anfragende hat sie storniert. |

Die Überprüfungsfrist begrenzt, wann Entscheidungen eingereicht werden können. Sie verwandelt eine bereits genehmigte Anfrage nicht in ein ablaufendes Zugriffstoken. Definieren Sie jede Ausführungsfrist in Ihrer eigenen Anwendung.

## Warteschlange, Stornierung und Fehler

`GET /v1/approvals` gibt ein Array von höchstens 100 ältesten ausstehenden, nicht abgelaufenen Anfragen zurück. Es hat keine Paginierung oder historischen Statusfilter. Die Warteschlange lässt die individuelle Entscheidungshistorie aus; rufen Sie eine Anfrage nach ID ab, um diese Historie zu erhalten.

Der ursprüngliche Anfragende kann `POST /v1/approvals/{approvalID}/cancel` mit einem nicht leeren `reason` senden. Eine Anfrage kann nach Stornierung, Ablehnung, Genehmigung oder Ablauf nicht wieder geöffnet werden. Erstellen Sie eine neue Anfrage, wenn sich die vorgeschlagene Aktion ändert.

| HTTP-Status | Was zu prüfen ist |
| - | - |
| `400` | Feldgrenzen, eine UUID-Anfrage-ID und ein nicht leerer Entscheidungsgrund. |
| `403` | Aktuelle Berechtigung des Arbeitsbereichsprüfers, Selbstprüfung des Anfragenden, API-Schlüssel-Abstimmung oder Eigentum an der Stornierung. |
| `404` | Anfrage oder aktiver Agent gehört zur ausgewählten Arbeitsbereichsumgebung. |
| `409` | Anfrage ist endgültig, abgelaufen, oder diese Person hat bereits abgestimmt. |

Diese Aufzeichnungen unterstützen Ihren Überprüfungsprozess; sie begründen keine SOC 2-Konformität, ISO-Zertifizierung, Verifizierung von Identitätsdokumenten oder die Korrektheit der eingereichten Nachweise.


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