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"
Name of the agent
1 - 255Description of what the agent does
256Emoji icon for the agent (e.g., "🤖")
System prompt/instructions for the agent
16384Input type for the agent
PROMPT, STRUCTURED Model UUID to use (uses workspace default if not provided)
Temperature for response generation
0 <= x <= 1Array of suggested prompts to help users get started
Array of action objects for custom integrations
Array of form field definitions (for STRUCTURED input type)
Array of attachment UUIDs to include with the agent
Enable web search capability
Enable image generation capability
Enable code interpreter capability
Enable canvas capability