Einen vorhandenen Agenten programmatisch aktualisieren
AGENT_API Scope und Zugriff auf den Agenten, den du aktualisieren möchtest.actions, inputFields, conversationStarters und attachments ersetzen bei Angabe vollständig die vorhandenen Werte[] um alle Actions/Felder/Anhänge zu entfernennull für emoji, description oder instruction um sie zu löschenassistantId:
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
assistantId | string | Ja | UUID des zu aktualisierenden Agenten |
name | string | Nein | Aktualisierter Name (1-255 Zeichen) |
description | string | Nein | Aktualisierte Beschreibung (max. 256 Zeichen, null zum Löschen) |
emoji | string | Nein | Aktualisiertes Emoji-Icon (null zum Löschen) |
instruction | string | Nein | Aktualisierte Systemanweisung (max. 16384 Zeichen, null zum Löschen) |
model | string | Nein | Aktualisierte Modell-UUID |
creativity | number | Nein | Aktualisierte Temperatur zwischen 0-1 |
conversationStarters | string[] | Nein | Aktualisiertes Array von vorgeschlagenen Prompts (ersetzt vorhandene) |
actions | array | Nein | Aktualisiertes Array von Actions (ersetzt vorhandene) |
inputFields | array | Nein | Aktualisiertes Array von Formularfeldern (ersetzt vorhandene) |
attachments | string[] | Nein | Aktualisiertes Array von Anhang-UUIDs (ersetzt vorhandene) |
webSearch | boolean | Nein | Aktualisierte Websuche-Einstellung |
imageGeneration | boolean | Nein | Aktualisierte Bildgenerierungs-Einstellung |
dataAnalyst | boolean | Nein | Aktualisierte Code-Interpreter-Einstellung |
canvas | boolean | Nein | Aktualisierte Canvas-Einstellung |
actions Array sollte enthalten:
actionId (erforderlich) - UUID der Action aus einer aktivierten IntegrationrequiresConfirmation (optional) - Ob vor der Ausführung eine Benutzerbestätigung erforderlich istinputFields Array-Struktur, siehe die Agent Create API Dokumentation.
actions oder attachments aktualisierst, füge immer vorhandene Elemente ein, die du behalten möchtest, da das gesamte Array ersetzt wird.API key as Bearer token. Format "Bearer YOUR_API_KEY"
UUID of the agent to update
Updated name
1 - 255Updated description (null to clear)
256Updated emoji icon (null to clear)
Updated system prompt (null to clear)
16384Updated input type for the agent
PROMPT, STRUCTURED Updated model UUID
Updated temperature
0 <= x <= 1Updated array of suggested prompts (replaces existing)
Updated array of actions (replaces existing)
Updated array of form fields (replaces existing)
Updated array of attachment UUIDs (replaces existing)
Updated web search capability setting
Updated image generation capability setting
Updated code interpreter capability setting
Updated canvas capability setting