Agenten

Agent abrufen

Ein Agent mit Verhalten, Ablauf und zugewiesenen Tools.

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

Liefert einen Agenten vollständig, also auch sein Verhalten und den Ablauf (workflow).

Pfadparameter

spacestringPflicht

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

agentuuidPflicht

ID des Agenten.

Beispiel

curl https://app.elunos.ai/api/v1/spaces/praxis-mueller/agents/0199a3c2-7d4e-7b21-9f3a-2c5e8d1b4a70 \
  -H "Authorization: Bearer np_xxxxxxxx"

Antwort

{
  "data": {
    "id": "0199a3c2-7d4e-7b21-9f3a-2c5e8d1b4a70",
    "space": "praxis-mueller",
    "name": "Empfang",
    "description": null,
    "status": "active",
    "language": "de",
    "voice_id": "0199a1f0-3c2b-7d1e-9a8b-7c6d5e4f3a21",
    "model": "standard",
    "first_message": {
      "text": "Praxis Dr. Müller, guten Tag. Wie kann ich helfen?",
      "interruptible": true
    },
    "behavior": {
      "blocks": [
        {
          "key": "role",
          "type": "role"
        },
        {
          "key": "company",
          "type": "company"
        },
        {
          "key": "tone",
          "type": "tone"
        }
      ],
      "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",
          "length": "two_three_sentences"
        }
      },
      "rendered_prompt": "…"
    },
    "workflow": {
      "start_node": "start",
      "nodes": {
        "…": "…"
      },
      "edges": {
        "…": "…"
      }
    },
    "tool_ids": [
      "0199a3c4-1f2a-7c55-8e10-6b7d9a3e2f11"
    ],
    "knowledge_ids": [
      "019f94f9-f54b-7303-a1b6-672be034af82"
    ],
    "knowledge_folder_ids": [
      "019f94f8-0a1b-7c2d-8e3f-4a5b6c7d8e9f"
    ],
    "phone_number_ids": [],
    "sync_status": "synced",
    "sync_error": null,
    "last_synced_at": "2026-09-21T10:16:02+02:00",
    "created_at": "2026-09-01T08:30:00+02:00",
    "updated_at": "2026-09-21T10:15:00+02:00"
  }
}

status: draft (noch nie veröffentlicht), active (nimmt Gespräche an) oder paused.
sync_status: draft, pending, synced oder error. Bei error steht der Grund in sync_error.
tool_ids, knowledge_ids, knowledge_folder_ids: was der Agent in jedem Schritt des Gesprächs erreicht.
behavior.rendered_prompt: der Prompt, den die Plattform aus den Blöcken baut. Nur lesbar.
workflow: der Gesprächsablauf mit Knoten und Übergängen. Den bearbeitest du in der Plattform.