Zum Hauptinhalt springen
Mit der Governance API liest du den Review- und Compliance-Status der Agenten in deinem Workspace und schaltest einen Agenten mit einer gespeicherten Begründung aus oder wieder ein. Nutze sie, wenn ein Ticket-System oder ein anderes System auf diesen Status reagieren soll. Die API liefert keine Anweisungen des Agenten, keine Konversationen, keine Dokumente und keine Aktionsergebnisse. Konversationsinhalte und Tool-Ergebnisse holst du über die Compliance API.

​
Bevor du startest

  • Governance ist an: Schalte Governance aktivieren unter Einstellungen > Workspace > Produkte > Governance ein.
  • API-Key-Scope: Ein Workspace-Admin legt einen Workspace-API-Key mit dem Scope GOVERNANCE_API unter Einstellungen > Workspace > Produkte > API an. Im Formular heißt der Scope Governance API und er ist nur sichtbar, wenn Governance an ist. Beim Einschalten bestätigt der Admin, dass jeder mit dem Key den Governance-Status lesen und Agenten deaktivieren kann, auch ohne Zugriff auf Governance. Ein persönlicher API-Key kann diesen Scope nicht haben.
Den Workspace nimmt die API aus dem API-Key. Du schickst keine Workspace-ID mit.

​
Basis-URL

Dedicated DeploymentsErsetze api.langdock.com durch <your-deployment-url>/api/public in allen Anfragen.

​
Authentifizierung

​
Verfügbare Endpoints

Archivierte Agenten und Agenten-Templates sind nicht enthalten. Ist Private Ressourcen in Governance ausblenden aktiv, fehlen auch Agenten, die mit niemandem sonst geteilt sind. Abrufen und Deaktivieren liefern für diese Agenten 404.

​
Das Agenten-Objekt

Auflisten, Abrufen und Deaktivieren liefern dasselbe Objekt. Die Liste steckt es in agents. Abrufen und Deaktivieren stecken ein Objekt in agent. reviewStatus ist pending_review, wenn noch niemand entschieden hat. Nach einer Entscheidung ist der Wert approved, internal_flag oder rejected. complianceStatus hat einen dieser Werte: RUNNING und ERROR sind keine Urteile. Sie allein setzen einen Agenten nicht auf high_risk oder potentially. Jeder Eintrag in complianceRules hat ruleId, ruleName, severity (LOW, MEDIUM, HIGH, CRITICAL), status (RUNNING, PASSING, FAILING, ERROR), reasoning und evaluatedAt. Deaktivierte und gelöschte Regeln fehlen. Du bekommst nur das letzte Ergebnis jeder Regel.

​
Abfragen

Es gibt keinen Webhook. Frage Agenten auflisten regelmäßig ab. updatedSince filtert auf updatedAt des Agenten. Eine Compliance-Regel kann später fertig werden, ohne diesen Zeitpunkt zu ändern. Eine Abfrage, die nur updatedSince nutzt, kann eine Regel als RUNNING sehen und das spätere FAILING verpassen.
  • Markierte Agenten. Rufe die Liste mit complianceStatus=high_risk,potentially und ohne updatedSince ab. Merke dir evaluatedAt jeder Regel, damit du nur einmal reagierst. Die API liefert das letzte Ergebnis jeder Regel. Ein Ergebnis, das zwischen zwei Abfragen ersetzt wurde, ist danach nicht mehr da.
  • Neue oder bearbeitete Agenten. Setze updatedSince auf den Start deines letzten Laufs. Ist eine gelieferte Regel RUNNING, rufe Agent abrufen auf, bis keine Regel mehr RUNNING ist.

​
Fehler

Langdock blockiert bewusst Browser-basierte Anfragen, um deinen API-Schlüssel zu schützen und die Sicherheit deiner Anwendungen zu gewährleisten. Weitere Informationen findest du in unserem Guide zu Best Practices für API-Schlüssel.