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.
Was Task Guard kontrolliert#
- Starten Sie die Aufgabe. Erstellen Sie einen aktiven Aufgabenvertrag aus einer direkten Benutzeranweisung.
- Refresh Kontext. Holen Sie den aktuellen Vertrag nach einer neuen Wende, einem Neustart oder einer Kontextverdichtung ab.
- Maßnahmen überprüfen. Bewerten Sie, ob jede wesentliche Aktion ausgerichtet, unterstützend, mehrdeutig, eine Änderung des Umfangs oder nicht verwandt ist.
- Ungewissheit beseitigen. Erklären Sie eine unterstützende Beziehung oder bitten Sie den Sitzungsbenutzer, eine wesentliche Aufgabenänderung zu bestätigen.
- Verifizieren Sie die Auswirkungen. Vergleichen Sie, was eine erlaubte Aktion erwartet wurde, mit dem, was tatsächlich passiert ist.
- Fortschritt aufzeichnen und abschließen. Halten Sie die Aufgabe aktuell und schließen Sie die Aufgabe, wenn die Erfolgskriterien erfüllt sind.
Wichtig Die Bestätigung von Task Guard ist keine Govern-Zustimmung. Task Guard fragt, ob die Arbeit zur aktiven Aufgabe des Benutzers gehört. Govern 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 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 und Ausrichtung und Auswirkungen.