Agent Create API

​

Bevor du startest

• API-Key-Scope: Erfordert einen API-Schlüssel mit dem Agenten API-Scope. Erstellte Agenten werden automatisch mit dem API-Schlüssel geteilt, um sie in Chat-Completions zu verwenden.
• 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.

​

Basis-URL

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

​

Parameter

​

Zugriffskonfiguration

• Rollen - "user" erlaubt die Nutzung des Agenten; "editor" erlaubt die Bearbeitung. Setze role eines Eintrags auf null, um diese direkte Freigabe zu entfernen.
• Empfänger - Neue Benutzerfreigaben erfordern aktive Benutzer im selben Workspace. Gruppen müssen zum Workspace gehören und vom Schlüsselbesitzer verwaltet werden können, sofern die Workspace-Berechtigungen nicht das Teilen mit beliebigen Gruppen erlauben. IDs müssen innerhalb jedes Arrays eindeutig sein.
• Besitz - Besitzer- und API-Schlüssel-Freigaben können über access nicht geändert werden.

{
  "name": "Geteilter Agent",
  "access": {
    "users": [{ "id": "550e8400-e29b-41d4-a716-446655440001", "role": "editor" }],
    "workspace": "user"
  }
}

​

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)

​

Skills

• Übergib Skill-UUIDs aus der Skills API in skillIds.
• Der User, dem der API-Schlüssel gehört, muss jeden Skill anhängen können. Dateivorlagen werden abgelehnt.

​

Sub-Agenten

• Jedes Objekt braucht agentId. requiresConfirmation ist optional (Standard: false).
• Lass das Feld weg oder sende [], um nichts anzuhängen. Doppelte agentId-Werte behalten das erste Objekt.

​

Workflows

• Übergib Workflow-UUIDs in workflowIds.
• Lass das Feld weg oder sende [], um nichts anzuhängen. Doppelte IDs werden entfernt.

​

Eingabefelder-Konfiguration

• TEXT - Einzeilige Texteingabe
• MULTI_LINE_TEXT - Mehrzeiliger Textbereich
• NUMBER - Numerische Eingabe
• CHECKBOX - Boolean-Checkbox
• FILE - Datei-Upload
• SELECT - Dropdown-Auswahl
• MULTI_SELECT - Mehrfachauswahl
• DATE - Datumsauswahl
• EMAIL - E-Mail-Adresse

​

Anhangs-IDs abrufen

​

Beispiele

​

Einen einfachen Agenten erstellen

const axios = require("axios");

async function createBasicAgent() {
  const response = await axios.post(
    "https://api.langdock.com/agent/v1/create",
    {
      name: "Dokumentenanalyse",
      description: "Analysiert und fasst Dokumente zusammen",
      emoji: "📄",
      instruction: "Du bist ein hilfreicher Agent, der Dokumente analysiert und klare Zusammenfassungen der wichtigsten Informationen liefert.",
      creativity: 0.5,
      conversationStarters: [
        "Fasse dieses Dokument zusammen",
        "Was sind die wichtigsten Punkte?",
        "Extrahiere Aktionspunkte"
      ],
      webSearch: false
    },
    {
      headers: {
        Authorization: "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
      }
    }
  );

  console.log("Agent erstellt:", response.data.agent.id);
}

​

Validierungsregeln

• Modell - Muss in der Liste der aktiven Modelle deines Workspaces sein
• Actions - Müssen zu in deinem Workspace aktivierten Integrationen gehören
• Anhänge - Müssen in deinem Workspace existieren und nicht gelöscht sein
• Ordner - Müssen in deinem Workspace existieren und nicht gelöscht sein
• Skills - Jede ID muss ein Skill sein, den der User, dem der API-Schlüssel gehört, anhängen kann. Dateivorlagen werden abgelehnt
• Sub-Agenten - Jede agentId muss ein Agent in deinem Workspace sein, den der User, dem der API-Schlüssel gehört, nutzen kann. Agenten mit Nur direkt werden abgelehnt
• Workflows - Jede ID muss ein aktiver Workflow in deinem Workspace sein, den der User, dem der API-Schlüssel gehört, nutzen kann. Vorlagen werden abgelehnt. Ist die Liste nicht leer, muss Workflows für diesen User aktiviert sein
• Berechtigungen - Dein API-Schlüssel muss die createAgents Berechtigung haben
• Freigaben - Freigabeberechtigungen und Empfänger werden geprüft, bevor Änderungen gespeichert werden
• Icon - fileName ist optional und 1 bis 255 Zeichen lang. Der Typ wird aus dem Dateiinhalt gelesen. Ein Präfix data:<type>;base64, wird entfernt und zählt zur Zeichengrenze. Inhalt, der sich nicht als Bild lesen lässt, gibt 400 zurück
• Name - Muss zwischen 1-80 Zeichen sein
• Beschreibung - Maximal 800 Zeichen
• Instruktion - Maximal 50000 Zeichen
• Creativity - Muss zwischen 0 und 1 liegen

​

Wichtige Hinweise

• Erstellte Agenten werden automatisch mit deinem API-Schlüssel für die Verwendung in Chat-Completions geteilt
• Der User, dem der API-Schlüssel gehört, wird zum Eigentümer und kann den Agenten in der Benutzeroberfläche verwalten
• Anhänge sind bidirektional mit dem Agenten verknüpft
• createdBy und workspaceId werden automatisch aus deinem API-Schlüssel übernommen

​

Antwortformat

​

Erfolgreiche Antwort (201 Created)

{
  status: "success";
  message: "Agent created successfully";
  agent: {
    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;
      slug: string;
      options: string[];
      fileTypes: string | null;
      emailDomain: string | null;
    }>;
    attachments: string[];
    knowledgeFolderIds: string[];
    skillIds: string[];
    subAgents: Array<{
      agentId: string;
      requiresConfirmation: boolean;
    }>;
    workflowIds: string[];
    owner: {
      id: string;
      name: string | null;
      email: string;
    } | null;
    createdAt: string;
    updatedAt: string;
    access?: {
      users: Array<{ id: string; role: "user" | "editor" }>;
      groups: Array<{ id: string; role: "user" | "editor" }>;
      workspace: "user" | "editor" | null;
      sharingManagedByAdmin: boolean;
    };
  };
}

​

Fehlerbehandlung

try {
  const response = await axios.post('https://api.langdock.com/agent/v1/create', ...);
} catch (error) {
  if (error.response) {
    switch (error.response.status) {
      case 400:
        console.error('Ungültige Parameter oder Ressource nicht gefunden:', error.response.data.message);
        break;
      case 401:
        console.error('Ungültiger oder fehlender API-Schlüssel');
        break;
      case 403:
        console.error('Unzureichende Berechtigungen - erfordert den Agenten API-Scope');
        break;
      case 429:
        console.error('Rate Limit überschritten');
        break;
      case 500:
        console.error('Server-Fehler');
        break;
    }
  }
}