Assistant Update API

​

Aktualisierungsverhalten

• Partielle Updates - Nur in der Anfrage enthaltene Felder werden aktualisiert; ausgelassene Felder bleiben unverändert
• Array-Felder ersetzen - actions, inputFields, conversationStarters, attachments und knowledgeFolderIds ersetzen bei Angabe vollständig die vorhandenen Werte
• Leere Arrays - Sende [] um alle Actions/Felder/Anhänge zu entfernen
• Null-Behandlung - Sende null für emoji um es zu löschen. Für description und instruction sende einen leeren String "" zum Löschen
• Unveränderte Felder - Felder, die nicht in der Anfrage enthalten sind, behalten ihre aktuellen Werte

​

Anfrageparameter

​

Actions-Konfiguration

• actionId (erforderlich) - UUID der Action aus einer aktivierten Integration
• requiresConfirmation (optional) - Ob vor der Ausführung eine Benutzerbestätigung erforderlich ist (Standard: true)

​

Eingabefelder-Konfiguration

​

Beispiele

​

Grundlegende Eigenschaften aktualisieren

const axios = require("axios");

async function updateAssistantName() {
  const response = await axios.patch(
    "https://api.langdock.com/assistant/v1/update",
    {
      assistantId: "550e8400-e29b-41d4-a716-446655440000",
      name: "Erweiterter Dokumentenanalyst",
      description: "Analysiert Dokumente mit erweiterten Fähigkeiten",
      creativity: 0.7
    },
    {
      headers: {
        Authorization: "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
      }
    }
  );

  console.log("Assistent aktualisiert:", response.data.message);
}

​

Validierungsregeln

• Assistenten-Zugriff - Dein API-Schlüssel muss Zugriff auf den Assistenten haben
• Workspace-Übereinstimmung - Der Assistent muss zum selben Workspace wie dein API-Schlüssel gehören
• Modell - Falls angegeben, muss es in der Liste der aktiven Modelle deines Workspaces sein
• Actions - Falls angegeben, müssen sie zu in deinem Workspace aktivierten Integrationen gehören
• Anhänge - Falls angegeben, müssen sie in deinem Workspace existieren und nicht gelöscht sein
• Ordner - Falls angegeben, müssen sie in deinem Workspace existieren und nicht gelöscht sein
• Name - Falls angegeben, muss zwischen 1-80 Zeichen sein
• Beschreibung - Falls angegeben, maximal 800 Zeichen
• Instruktion - Falls angegeben, maximal 50000 Zeichen
• Creativity - Falls angegeben, muss zwischen 0 und 1 liegen

​

Antwortformat

​

Erfolgreiche Antwort (200 OK)

{
  status: "success";
  message: "Assistant updated successfully";
  assistant: {
    id: string;
    name: string;
    description: string | null;
    instruction: string | null;
    emojiIcon: string | null;
    model: string | null;
    temperature: number;
    conversationStarters: string[];
    inputType: "PROMPT" | "STRUCTURED" | "INTEGRATION" | "SCHEDULED" | "WEBHOOK";
    webSearchEnabled: boolean;
    imageGenerationEnabled: boolean;
    canvasEnabled: boolean;
    extendedThinking: boolean;
    actions: Array<{
      actionId: string;
      requiresConfirmation: boolean;
    }>;
    inputFields: Array<{
      type: "TEXT" | "MULTI_LINE_TEXT" | "NUMBER" | "CHECKBOX" | "FILE" | "SELECT" | "MULTI_SELECT" | "DATE" | "EMAIL";
      label: string;
      description: string | null;
      required: boolean;
      order: number;
    }>;
    attachments: string[];
    knowledgeFolderIds: string[];
    createdAt: string;
    updatedAt: string;
  };
}

​

Fehlerbehandlung

try {
  const response = await axios.patch('https://api.langdock.com/assistant/v1/update', ...);
} catch (error) {
  if (error.response) {
    switch (error.response.status) {
      case 400:
        console.error('Ungültige Parameter:', error.response.data.message);
        break;
      case 401:
        console.error('Ungültiger oder fehlender API-Schlüssel');
        break;
      case 403:
        console.error('Unzureichende Berechtigungen - kein Zugriff auf diesen Assistenten');
        break;
      case 404:
        console.error('Assistent nicht gefunden oder Ressource nicht gefunden (Modell, Action, Anhang)');
        break;
      case 500:
        console.error('Server-Fehler');
        break;
    }
  }
}

​

Best Practices

1. Vor dem Update abrufen - Wenn du vorhandene Array-Werte beibehalten musst, rufe zuerst die aktuelle Assistenten-Konfiguration ab
2. Inkrementelle Updates - Aktualisiere nur die Felder, die geändert werden müssen
3. Anhänge validieren - Stelle sicher, dass Anhang-UUIDs gültig sind, bevor du sie einfügst
4. Actions testen - Überprüfe, dass Actions zu aktivierten Integrationen gehören, bevor du aktualisierst
5. Fehler elegant behandeln - Implementiere eine ordnungsgemäße Fehlerbehandlung für Validierungsfehler

​

Migration zur Agents API

• Agent Update API - Verwendet agentId statt assistantId