Agenten

Agent ändern

Einzelne Felder eines Agenten ändern, der Rest bleibt.

PATCHhttps://app.elunos.ai/api/v1/spaces/{space}/agents/{agent}

Ändert nur die Felder, die du mitschickst. behavior.values wird nach Block zusammengeführt: Schickst du nur tone, bleiben role und alle anderen Blöcke, wie sie sind. Listen wie tool_ids werden dagegen vollständig ersetzt.

Pfadparameter

spacestringPflicht

Slug des Space, z. B. `praxis-mueller`. Steht in der Antwort von `GET /spaces`.

agentuuidPflicht

ID des Agenten.

Felder

namestring

Anzeigename, 1 bis 80 Zeichen.

descriptionstring | null

Interne Beschreibung.

languagestring

Sprache des Gesprächs, z. B. `de`. Ohne Angabe gilt der Standard des Space.

voice_iduuid | null

Stimme aus [Stimmen auflisten](/de/docs/api-referenz/stimmen-auflisten). `null` nimmt die Standardstimme.

modelstring | null

`id` eines Modells aus `llm_options` in [Space abrufen](/de/docs/api-referenz/space-abrufen). `null` nimmt den Standard.

first_messageobject

Die Begrüßung: `text` und `interruptible` (ob der Anrufer sie unterbrechen darf).

behaviorobject

Verhalten aus Blöcken, siehe [Verhalten](/de/docs/api-referenz/verhalten).

tool_idsuuid[]

Tools, die der Agent in jedem Schritt aufrufen kann.

knowledge_idsuuid[]

Dokumente, die der Agent in jedem Schritt kennt.

knowledge_folder_idsuuid[]

Ordner der Wissensdatenbank. Der Agent kennt alle Dokumente darin, auch später hinzugefügte.

statusstring

`paused` nimmt sofort keine Gespräche mehr an, `active` wieder. `active` setzt einen veröffentlichten Stand voraus.

expected_updated_atdatetime

`updated_at` aus deinem letzten Lesen. Weicht der gespeicherte Wert ab, antwortet die API mit 409 `stale` und dem aktuellen Stand, statt eine fremde Änderung zu überschreiben.

Beispiel

curl -X PATCH https://app.elunos.ai/api/v1/spaces/praxis-mueller/agents/0199a3c2-7d4e-7b21-9f3a-2c5e8d1b4a70 \
  -H "Authorization: Bearer np_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "behavior": {
      "values": {
        "tone": {
          "closeness": "personal",
          "style": "brief"
        }
      }
    },
    "tool_ids": [
      "0199a3c4-1f2a-7c55-8e10-6b7d9a3e2f11"
    ],
    "expected_updated_at": "2026-09-21T10:15:00+02:00"
  }'

Antwort

{
  "data": {
    "id": "0199a3c2-7d4e-7b21-9f3a-2c5e8d1b4a70",
    "sync_status": "draft",
    "…": "…"
  },
  "changes": [
    {
      "path": "behavior.values.tone.closeness",
      "from": "formal",
      "to": "personal"
    }
  ],
  "sync": {
    "status": "draft",
    "error": null
  }
}

changes nennt jedes Feld, das sich wirklich geändert hat.

Änderungen gelten im Gespräch erst nach dem Veröffentlichen. Bis dahin spricht der Agent mit dem zuletzt veröffentlichten Stand.