Creates a new agent
Agents API
Agent Create API
Einen neuen Agenten programmatisch erstellen
POST
Creates a new agent
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.
⚠️ Du nutzt unsere API in einem Dedicated Deployment? Ersetze einfach
api.langdock.com durch die Base URL deines Deployments: <deployment-url>/api/publicDies ist die neue Agents API mit nativer Vercel AI SDK Kompatibilität. Wenn du die veraltete Assistants API verwendest, siehe den Migrations-Guide.
Erfordert einen API-Schlüssel mit dem
AGENT_API Scope. Erstellte Agenten werden automatisch mit dem API-Schlüssel geteilt, um sie in Chat-Completions zu verwenden.Anfrageparameter
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
name | string | Ja | Name des Agenten (1-80 Zeichen) |
description | string | Nein | Beschreibung der Agentenfunktion (max. 500 Zeichen) |
emoji | string | Nein | Emoji-Icon für den Agenten (max. 16 Zeichen, z.B. ”🤖“) |
instruction | string | Nein | Systemanweisung/Instruktionen für den Agenten (max. 40000 Zeichen) |
inputType | string | Nein | Eingabetyp: “PROMPT” oder “STRUCTURED” (Standard: “PROMPT”) |
model | string | Nein | Modell-ID (Deployment-Name von der Models API). Verwendet Workspace-Standard wenn nicht angegeben |
creativity | number | Nein | Temperatur zwischen 0-1 (Standard: 0.3) |
conversationStarters | string[] | Nein | Array von vorgeschlagenen Prompts zum Einstieg (max. 20, je 1-255 Zeichen) |
actions | array | Nein | Array von Action-Objekten für benutzerdefinierte Integrationen |
inputFields | array | Nein | Array von Formularfeld-Definitionen (für STRUCTURED Eingabetyp) |
attachments | string[] | Nein | Array von Anhang-UUIDs für den Agenten |
webSearch | boolean | Nein | Websuche-Fähigkeit aktivieren (Standard: false) |
imageGeneration | boolean | Nein | Bildgenerierungs-Fähigkeit aktivieren (Standard: false) |
dataAnalyst | boolean | Nein | Code-Interpreter-Fähigkeit aktivieren (Standard: false) |
canvas | boolean | Nein | Canvas-Fähigkeit aktivieren (Standard: false) |
extendedThinking | boolean | Nein | Extended-Thinking-Modus aktivieren (Standard: false) |
Actions-Konfiguration
Jede Action imactions Array sollte enthalten:
actionId(erforderlich) - UUID der Action aus einer aktivierten IntegrationrequiresConfirmation(optional) - Ob vor der Ausführung eine Benutzerbestätigung erforderlich ist (Standard: true)
Nur Actions von in deinem Workspace aktivierten Integrationen können verwendet werden.
Eingabefelder-Konfiguration
Bei Verwendung voninputType: "STRUCTURED" kannst du Formularfelder im inputFields Array definieren:
| Feld | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
slug | string | Ja | Eindeutiger Bezeichner für das Feld |
type | string | Ja | Feldtyp (siehe unterstützte Typen unten) |
label | string | Ja | Anzeigebezeichnung für das Feld |
description | string | Nein | Hilfetext für das Feld |
required | boolean | Nein | Ob das Feld erforderlich ist (Standard: false) |
order | number | Ja | Anzeigereihenfolge (0-indiziert) |
options | string[] | Nein | Optionen für SELECT-Feldtypen |
fileTypes | string | Nein | Erlaubte Dateitypen für FILE-Feldtypen (nullable) |
emailDomain | string | Nein | Erlaubte E-Mail-Domain für EMAIL-Feldtypen |
TEXT- Einzeilige TexteingabeMULTI_LINE_TEXT- Mehrzeiliger TextbereichNUMBER- Numerische EingabeCHECKBOX- Boolean-CheckboxFILE- Datei-UploadSELECT- Dropdown-AuswahlDATE- DatumsauswahlEMAIL- E-Mail-Adresse
Anhangs-IDs abrufen
Um Anhänge in deinen Agenten einzubinden, lade zuerst Dateien mit der Upload Attachment API hoch. Dies gibt Anhang-UUIDs zurück, die du imattachments Array verwenden kannst.
Beispiele
Einen einfachen Agenten erstellen
Validierungsregeln
Die API wendet mehrere Validierungsregeln an:- 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
- Berechtigungen - Dein API-Schlüssel muss die
createAgentsBerechtigung haben - Name - Muss zwischen 1-80 Zeichen sein
- Beschreibung - Maximal 500 Zeichen
- Instruktion - Maximal 40000 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 Ersteller des API-Schlüssels wird zum Eigentümer und kann den Agenten in der Benutzeroberfläche verwalten
- Anhänge sind bidirektional mit dem Agenten verknüpft
- Der Agent-Typ wird auf
AGENTgesetzt (nichtWORKFLOWoderPROJECT) createdByundworkspaceIdwerden automatisch aus deinem API-Schlüssel übernommen
Antwortformat
Erfolgreiche Antwort (201 Created)
Fehlerbehandlung
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.
Autorisierungen
API key as Bearer token. Format "Bearer YOUR_API_KEY"
Body
application/json
Maximum string length:
64Maximum string length:
16384Maximum string length:
256Erforderlicher Bereich:
0 <= x <= 1Maximum string length:
64Array of UUID strings identifying attachments for this message