# Task Guard API

Task Guard hält vernetzte KI-Agenten auf die aktive benutzerautorisierte Aufgabe ausgerichtet. Es verwandelt das Ziel, die Einschränkungen, den Umfang, die Entscheidungen und die Erfolgskriterien in einen versionierten Aufgabenvertrag und bewertet dann wesentliche Aktionen gegen diesen Vertrag, bevor sie ausgeführt werden.

Task Guard ist sowohl über die REST API als auch über die [Maetra MCP Server](https://maetra.io/de/docs/mcp-server/tools-reference).

### Was Task Guard kontrolliert

1. **Starten Sie die Aufgabe.** Erstellen Sie einen aktiven Aufgabenvertrag aus einer direkten Benutzeranweisung.
2. **Refresh Kontext.** Holen Sie den aktuellen Vertrag nach einer neuen Wende, einem Neustart oder einer Kontextverdichtung ab.
3. **Maßnahmen überprüfen.** Bewerten Sie, ob jede wesentliche Aktion ausgerichtet, unterstützend, mehrdeutig, eine Änderung des Umfangs oder nicht verwandt ist.
4. **Ungewissheit beseitigen.** Erklären Sie eine unterstützende Beziehung oder bitten Sie den Sitzungsbenutzer, eine wesentliche Aufgabenänderung zu bestätigen.
5. **Verifizieren Sie die Auswirkungen.** Vergleichen Sie, was eine erlaubte Aktion erwartet wurde, mit dem, was tatsächlich passiert ist.
6. **Fortschritt aufzeichnen und abschließen.** Halten Sie die Aufgabe aktuell und schließen Sie die Aufgabe, wenn die Erfolgskriterien erfüllt sind.

> **Important**
> Die Bestätigung von Task Guard ist keine Govern-Zustimmung. Task Guard fragt, ob die Arbeit zur aktiven Aufgabe des Benutzers gehört. [Govern](https://maetra.io/de/docs/govern-api) entscheidet, ob eine Folgemaßnahme eine Bewertung der Politik oder eine menschliche Zustimmung erfordert. Wenn beides zutrifft, sind beide Kontrollen zu erfüllen.


### Beratung und erzwungene Integration

| Modus | Verhalten |
| ---- | --------- |
| `ADVISORY` | Der Gastgeber ruft Task Guard an und folgt dem erwiderten Urteil und `next_action`. |
| `ENFORCED` | Der Host muss vertrauenswürdige User-Event-Übergänge verwenden und kann ein kurzlebiges Alignment-Token benötigen, um die genaue Aktion vor der Ausführung abzugleichen. |

Verwendung `CUSTOM_API` für eine benutzerdefinierte REST Integration, `CUSTOM_MCP` für Ihren eigenen MCP-Host oder die First Party `CODEX` / `CLAUDE` Host-Typen.

### Anwendungsbereiche von Task Guard

| Anwendungsbereich | Verwendet für |
| ----- | -------- |
| `task_guard:tasks:write` | Aufgaben starten, Fortschritt aufzeichnen, Zustand des Übergangslebenszyklus und Aufgaben abschließen. |
| `task_guard:tasks:read` | Aufgabenkontext abrufen. |
| `task_guard:checks:write` | Überprüfen Sie die Ausrichtung, erklären Sie Beziehungen und überprüfen Sie die Ausrichtungstoken. |
| `task_guard:effects:write` | Tatsächliche Aktionseffekte melden. |
| `task_guard:confirmations:write` | Senden Sie vertrauenswürdige Host-Benutzerereignisse und Benutzerbestätigungen. |

Siehe [Authentifizierung](https://maetra.io/de/docs/getting-started/authentication) für Platzhalterbereiche und vertrauenswürdige Bestätigungsnachweise.

### Nutzung und Abrechnung

Jede authentifizierte Task Guard REST- oder MCP-Toolanforderung verbraucht eine Task Guard-Anfrage aus dem Arbeitsbereich. Die kostenlose Testversion umfasst 50 Anfragen; Go beinhaltet 1.500 pro Monat; Starter beinhaltet 3.000; Team umfasst 15.000; und Business umfasst 60.000. Paid-Pläne können die Pay-as-you-go-Nutzungsabrechnung ermöglichen, nachdem die enthaltene Zulage erschöpft ist.

Wiederholen Sie eine Anfrage mit dem gleichen `Idempotency-Key` Header oder derselbe Körper `idempotency_key` wenn unterstützt, um zu vermeiden, dass eine andere Einheit für eine idempotente Wiederholung verbraucht wird.

### REST Ressourcen

Die REST API stellt zweckgerichtete Aufgaben-, Kontext-, Ausrichtungs-, Effekt-, Bestätigungs- und Lifecycle-Endpunkte unter:

```
https://api.maetra.io/v1/task-guard
```

Das Generikum `POST /v1/task-guard/tools/{tool}` endpoint akzeptiert auch den gleichen Request-Body wie jedes der sieben Task Guard-Tools:

```
start_task
get_task_context
check_task_alignment
explain_task_relationship
record_task_progress
record_action_effect
complete_task
```

Für normale REST-Integrationen bevorzugen Sie die zweckgebundenen Endpunkte, die in [Aufgaben und Kontext](https://maetra.io/de/docs/task-guard-api/tasks-and-context) und [Ausrichtung und Auswirkungen](https://maetra.io/de/docs/task-guard-api/alignment-and-effects).