Einen neuen Agenten programmatisch erstellen
AGENT_API Scope. Erstellte Agenten werden automatisch mit dem API-Schlüssel geteilt, um sie in Chat-Completions zu verwenden.| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
name | string | Ja | Name des Agenten (1-255 Zeichen) |
description | string | Nein | Beschreibung der Agentenfunktion (max. 256 Zeichen) |
emoji | string | Nein | Emoji-Icon für den Agenten (z.B. ”🤖“) |
instruction | string | Nein | Systemanweisung/Instruktionen für den Agenten (max. 16384 Zeichen) |
inputType | string | Nein | Eingabetyp: “PROMPT” oder “STRUCTURED” (Standard: “PROMPT”) |
model | string | Nein | Zu verwendende Modell-UUID (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 |
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) |
actions Array sollte enthalten:
actionId (erforderlich) - UUID der Action aus einer aktivierten IntegrationrequiresConfirmation (optional) - Ob vor der Ausführung eine Benutzerbestätigung erforderlich ist (Standard: false)inputType: "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 |
TEXT - Einzeilige TexteingabeMULTI_LINE_TEXT - Mehrzeiliger TextbereichNUMBER - Numerische EingabeCHECKBOX - Boolean-CheckboxFILE - Datei-UploadSELECT - Dropdown-AuswahlDATE - Datumsauswahlattachments Array verwenden kannst.
createAssistants Berechtigung habenAGENT gesetzt (nicht WORKFLOW oder PROJECT)createdBy und workspaceId werden automatisch aus deinem API-Schlüssel übernommenAPI key as Bearer token. Format "Bearer YOUR_API_KEY"
64163842560 <= x <= 164Array of UUID strings identifying attachments for this message