Einen neuen Assistenten programmatisch erstellen
AGENT_API Scope. Erstellte Assistenten werden automatisch mit dem API-Schlüssel geteilt, um sie in Chat-Completions zu verwenden.| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
name | string | Ja | Name des Assistenten (1-80 Zeichen) |
description | string | Nein | Beschreibung der Assistentenfunktion (max. 500 Zeichen) |
emoji | string | Nein | Emoji-Icon für den Assistenten (z.B. ”🤖“) |
instruction | string | Nein | Systemanweisung/Instruktionen für den Assistenten (max. 40000 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 Assistenten |
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: true)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 übernommenagentId statt assistantIdAPI 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