Zum Hauptinhalt springen
Die Assistants API wird schrittweise eingestellt. Verwende für neue Implementierungen bitte die Agents API. Details findest du in unserem Migrations-Guide.
Nutzt du unsere API über ein Dedicated Deployment? Ersetze einfach api.langdock.com mit der Basis-URL deines Deployments: <deployment-url>/api/public
Aktiviert oder deaktiviert einen Assistenten in deinem Workspace. Deaktivierte Assistenten können von Workspace-Mitgliedern nicht verwendet werden, bis sie wieder aktiviert werden.
Dies ist eine administrative Aktion. Nur Workspace-Admins oder Nutzer mit entsprechenden Berechtigungen können Assistenten deaktivieren/aktivieren.

​
Anwendungsfälle

  • Vorübergehend deaktivieren eines Assistenten, der Wartung oder Updates benötigt
  • Wieder aktivieren eines zuvor deaktivierten Assistenten
  • Verfügbarkeit steuern von Assistenten während Rollouts oder Tests

​
Anfrageparameter

ParameterTypErforderlichBeschreibung
assistantIdstringJaUUID des zu aktivierenden/deaktivierenden Assistenten
disabledbooleanJatrue zum Deaktivieren, false zum Aktivieren

​
Beispiel

const axios = require("axios");

async function toggleAssistantStatus(assistantId, disabled) {
  const response = await axios.patch(
    "https://api.langdock.com/assistant/v1/disable",
    {
      assistantId: assistantId,
      disabled: disabled
    },
    {
      headers: {
        Authorization: "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
      }
    }
  );

  console.log(`Assistant ${disabled ? 'disabled' : 'enabled'}:`, response.data);
}

// Disable an assistant
toggleAssistantStatus("550e8400-e29b-41d4-a716-446655440000", true);

// Re-enable an assistant
toggleAssistantStatus("550e8400-e29b-41d4-a716-446655440000", false);

​
Antwortformat

​
Erfolgreiche Antwort (200 OK)

{
  status: "success";
  message: "Assistant disabled successfully" | "Assistant enabled successfully";
}

​
Fehlerbehandlung

Status CodeBeschreibung
400Ungültige Parameter (fehlende assistantId oder disabled)
401Ungültiger oder fehlender API-Schlüssel
403Unzureichende Berechtigungen zum Deaktivieren von Assistenten
404Assistent nicht gefunden oder API-Schlüssel hat keinen Zugriff
429Rate Limit überschritten

​
Verhalten

Wenn ein Assistent deaktiviert ist:
  • Nutzer können keine neuen Konversationen mit dem Assistenten starten
  • Der Assistent erscheint nicht in der Assistenten-Bibliothek für reguläre Nutzer
  • Bestehende Konversationen können weiterhin angezeigt werden, aber der Assistent kann nicht antworten
  • Admins können den Assistenten weiterhin einsehen und verwalten
  • Der Assistent kann jederzeit wieder aktiviert werden
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.