AI Agent Governance API und MCP Dokumentation

Maetra ist ein Runtime Control-Flugzeug für KI-Agenten. Verwenden Sie den REST API- oder MCP-Server, um die Arbeit auf die Aufgabe des Benutzers abzustimmen, sensible Aktionen für Richtlinien oder menschliche Zustimmung zu unterbrechen, riskante Inhalte zu scannen und Beweise dafür zu erhalten, was nach der Genehmigung passiert ist.

Neu bei Maetra? Beginnen Sie mit dem Quickstart. Verbinden Sie einen Agenten oder Assistenten? Verwenden Sie die MCP Server Guide. Benötigen Sie nur einen Endpunkt? Jump to the API-Referenz.

Die drei Runtime Controls#

Task Guard

AI Agent Task Alignment. Verwandeln Sie das Ziel, die Einschränkungen, den Umfang und die Erfolgskriterien des Benutzers in einen aktiven Aufgabenvertrag. Vor einer materiellen Aktion prüft Task Guard, ob die Arbeit ausgerichtet ist, unterstützt, eine Erklärung benötigt, eine Benutzerbestätigung erfordert oder neu ausgerichtet werden sollte. Danach kann es erwartete und gemeldete Effekte vergleichen.

Govern

Human-in-the-Loop-Genehmigungen und Ausführungsbelege. Bevor ein Agent Geld bewegt, Daten löscht oder einem Kunden eine E-Mail schickt, ruft er Maetra an. Genaue Richtlinien oder Entscheidungsintelligenz können die Aktion genehmigen, blockieren oder an einen Menschen weiterleiten. Eine unterzeichnete Entscheidung ist an die genaue Aktionsnutzlast gebunden, und Ausführungsquittungen können diese Genehmigung mit Versuchen und dem beobachteten Ergebnis verknüpfen.

Secure

Laufzeit-Content-Scanning. Bildschirmaufforderungen, Toolaufrufe und Modellausgaben gegen Ihre Workspace-Regeln - sofortige Injektion, Datenexfiltration, unzulässige Tools - und erhalten Sie ein Urteil zurücksafe, flagged, Blockiert) und eine empfohlene Aktion. Alles, was markiert oder blockiert wird, wird zu einem Vorfall.

Zwei Wege zur Integration#

Beide werden von der gleichen Evaluation Engine unterstützt und mit dem gleichen Workspace-API-Schlüssel authentifiziert.

Was Sie bauen können#

• Zahlungsdienstleister und Finanzdienstleister die das genehmigte Konto, den genehmigten Betrag oder die genehmigte Währung nach Überprüfung nicht ändern können.
• Kundendienstmitarbeiter die vor Rückerstattungen, Kontoänderungen oder externen Nachrichten eine Pause einlegen.
• Langzeitassistenten die ihren Aufgabenvertrag vor wesentlichen Maßnahmen erneut überprüfen und anschließend die tatsächlichen Auswirkungen melden.
• MCP-vernetzte Agenten die nur die Task Guard-, Govern- und Secure-Tools entdecken, die für ihren Arbeitsbereich und API-Schlüssel aktiviert sind.

Genehmigung und Ausführung sind getrennte Tatsachen. Ein Entscheidungstoken beweist, was Maetra autorisiert hat; ein Ausführungseingang zeichnet auf, wie genau diese Aktion versucht wurde und welche Wirkung Beweise beobachtet wurden.

Gut zu wissen Sie müssen Ihre Agenten nicht zuerst registrieren. Jeder Endpunkt akzeptiert einen freien Text agent_name, so dass sie in minuten integrieren und agenten später für eine reichhaltigere berichterstattung registrieren können. Govern bewertet immer noch API-only und MCP-Agenten gegen organisationsweite Richtlinien; wenn agent_name oder agent_id Übereinstimmungen mit einem registrierten agenten, agenten-scoped richtlinien können gelten. Siehe Agenten.

Basis-URL#

Alle REST Endpunkte sind versioniert unter /v1. Der MCP-Server hat eine eigene Basis-URL - siehe MCP Überblick.

Nächste Schritte#

1. Erstellen Sie einen API Key im Armaturenbrett.
2. Führen Sie Ihren ersten Checkpoint und Scan, Verbinden Sie einen MCP-Client, oder Starten Sie eine Task Guard-Aufgabe.
3. Durchsuchen der Vollständige API Referenz.