Agenten

Agent anlegen

Einen neuen Agenten anlegen, leer oder aus einer Vorlage.

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

Legt einen Agenten als Entwurf an. Er nimmt noch keine Gespräche an, bis du ihn veröffentlichst.

Pfadparameter

spacestringPflicht

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

Felder

template_idstring

Vorlage aus [Vorlagen auflisten](/de/docs/api-referenz/vorlagen-auflisten). Bringt Verhalten und Ablauf mit, deine übrigen Felder überschreiben die der Vorlage.

namestringPflicht

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.

Beispiel

curl -X POST https://app.elunos.ai/api/v1/spaces/praxis-mueller/agents \
  -H "Authorization: Bearer np_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Empfang",
    "language": "de",
    "first_message": {
      "text": "Praxis Dr. Müller, guten Tag. Wie kann ich helfen?",
      "interruptible": true
    },
    "behavior": {
      "values": {
        "role": {
          "text": "Du bist der Empfang der Zahnarztpraxis Dr. Müller."
        },
        "company": {
          "name": "Zahnarztpraxis Dr. Müller",
          "hours": "Mo bis Fr, 8 bis 17 Uhr"
        },
        "tone": {
          "closeness": "formal",
          "style": "brief"
        }
      }
    }
  }'

Antwort

201 mit dem neuen Agenten. warnings weist auf Lücken hin, die das Anlegen nicht verhindern.

{
  "data": {
    "id": "0199a3c2-7d4e-7b21-9f3a-2c5e8d1b4a70",
    "status": "draft",
    "sync_status": "draft",
    "…": "…"
  },
  "warnings": [
    {
      "path": "behavior",
      "code": "no_escalation",
      "message": "No escalation block and no transfer node."
    }
  ]
}

Ohne template_id bekommt der Agent einen einfachen Ablauf: Begrüßung, ein Gesprächsschritt, Ende. Für alles Weitere ist eine Vorlage der schnellere Start.