Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.langdock.com/llms.txt

Use this file to discover all available pages before exploring further.

Die Assistants API wird am 30. April 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.