Zum Hauptinhalt springen
Schaltet einen Agenten als Governance-Aktion aus oder wieder ein. Ein deaktivierter Agent kann nicht verwendet werden, bis du ihn wieder einschaltest. Die Antwort ist der aktualisierte Agent, mit denselben Feldern wie bei Agent abrufen. Die Agent Deaktivieren API ist ein anderer Aufruf. Sie nutzt den Scope ASSISTANT_API und erreicht nur einen Agenten, den dieser Key bearbeiten darf. Dieser Aufruf verlangt nicht, dass der Agent mit dem Key geteilt ist.

​
Basis-URL

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

​
Voraussetzungen

  • API-Key mit dem Scope GOVERNANCE_API
  • Governance aktivieren ist an
  • agentId ist die UUID des Agenten

​
Request Body

Leerzeichen am Anfang und Ende von disabledReason werden entfernt. Eine leere Begründung wird als null gespeichert. Alle, die den Agenten sehen können, sehen die Begründung am Badge Deaktiviert. Inhaber und Bearbeitende sehen sie zusätzlich im Agenten-Editor. Wenn du den Agenten wieder einschaltest, werden disabledReason und disabledAt gelöscht, auch wenn die Anfrage noch eine Begründung mitschickt. Der Nutzer des API-Keys wird als die Person gespeichert, die den Agenten deaktiviert hat. Die Antwort enthält diese ID nicht.

​
Verhalten

  • Ausgeschaltet: disabled ist true, disabledReason ist die gespeicherte Begründung und disabledAt ist gesetzt.
  • Wieder eingeschaltet: disabled ist false, disabledReason und disabledAt sind null.
  • Agent nicht verfügbar? Liefert 404 mit der Meldung Agent not found.
  • disabled fehlt, oder die Begründung ist länger als 500 Zeichen? Liefert 400.
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.