Agent Deaktivieren API

​

Bevor du startest

• Veraltete Assistants API: Dies ist die neue Agents API mit nativer Vercel AI SDK Kompatibilität. Wenn du die veraltete Assistants API verwendest, siehe den Migrations-Guide.
• Administrative Aktion: Dies ist eine administrative Aktion. Nur Workspace-Admins oder Nutzer mit entsprechenden Berechtigungen können Agenten aktivieren/deaktivieren.

​

Basis-URL

https://api.langdock.com/agent/v1/disable

​

Anwendungsfälle

• Temporär deaktivieren eines Agenten, der Wartung oder Updates benötigt
• Wieder aktivieren eines zuvor deaktivierten Agenten
• Verfügbarkeit steuern während Rollouts oder Tests

​

Parameter

​

Beispiel

const axios = require("axios");

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

  console.log(`Agent ${disabled ? 'deaktiviert' : 'aktiviert'}:`, response.data);
}

// Agent deaktivieren
toggleAgentStatus("550e8400-e29b-41d4-a716-446655440000", true);

// Agent wieder aktivieren
toggleAgentStatus("550e8400-e29b-41d4-a716-446655440000", false);

​

Antwort-Format

​

Erfolgreiche Antwort (200 OK)

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

​

Fehlerbehandlung

​

Verhalten

• Nutzer können keine neuen Konversationen mit dem Agenten starten
• Der Agent erscheint nicht in der Agenten-Bibliothek für normale Nutzer
• Bestehende Konversationen können noch einsehbar sein, aber der Agent kann nicht antworten
• Admins können den Agenten weiterhin sehen und verwalten
• Der Agent kann jederzeit wieder aktiviert werden