Agenten

Verhalten

Die Blöcke, aus denen der Prompt eines Agenten entsteht.

Das Verhalten eines Agenten besteht aus Blöcken. Jeder Block deckt einen Aspekt ab, etwa Rolle, Tonfall oder wann an einen Menschen übergeben wird. Aus den Blöcken baut die Plattform den Prompt, den der Agent im Gespräch bekommt. Du schreibst also keinen langen Prompt, sondern füllst Felder.

Aufbau

{
  "blocks": [
    {
      "key": "role",
      "type": "role"
    },
    {
      "key": "tone",
      "type": "tone"
    },
    {
      "key": "custom-1",
      "type": "custom"
    }
  ],
  "values": {
    "role": {
      "text": "Du bist der Empfang der Zahnarztpraxis Dr. Müller."
    },
    "tone": {
      "closeness": "formal",
      "style": "brief",
      "length": "two_three_sentences"
    },
    "custom-1": {
      "title": "Notfälle",
      "text": "Bei Schmerzen am selben Tag einen Termin anbieten."
    }
  },
  "rendered_prompt": "…"
}

blocks: welche Blöcke es gibt, in dieser Reihenfolge.
values: der Inhalt je Block, nach key.
rendered_prompt: der daraus gebaute Prompt. Nur lesbar.

Beim Ändern reicht values mit den Blöcken, die sich ändern. Die übrigen bleiben.

Blöcke

Typ	Felder
`role`	`text`: wer der Agent ist. Pflicht und nicht leer.
`company`	`name`, `industry`, `hours`, `exceptions`, `address`, `directions`, `phone`, `web`
`tone`	`closeness`: `formal` oder `personal` · `style`: `balanced`, `brief` oder `detailed` · `length`: `two_three_sentences`, `one_sentence` oder `as_needed`
`personality`	`preset`: `friendly_professional`, `relaxed`, `formal_precise` oder `calm_patient` · `text`
`task`	`text`: was der Agent erreichen soll.
`flow`	`text`: die Schritte des Gesprächs, nummeriert.
`limits`	`text`: was der Agent nicht tut.
`ambiguity`	`behavior`: `ask_once`, `ask_twice` oder `hand_over` · `then`: `human`, `callback` oder `end`
`examples`	`text`: Beispielsätze und -antworten.
`escalation`	`when`: `on_request`, `complaints` oder `out_of_scope` · `target`: wohin übergeben wird
`custom`	`title`, `text`. Mehrfach möglich, Schlüssel `custom-<name>`.

Unbekannte Typen oder Werte lehnt die API mit 422 und dem Pfad des Feldes ab, etwa behavior.values.tone.closeness.

Eigene Blöcke

Mit custom-Blöcken ergänzt du Regeln, für die es keinen eigenen Typ gibt. Der Schlüssel beginnt mit custom-, danach ein Name deiner Wahl:

{
  "behavior": {
    "values": {
      "custom-shop-notes": {
        "title": "Hinweise des Shops",
        "text": "Versand ab 50 Euro kostenlos."
      }
    }
  }
}

Was in Blöcke gehört und was nicht

Fakten wie Preise, Kataloge oder lange Regelwerke gehören in die Wissensdatenbank, nicht in Blöcke. Der Prompt kostet bei jedem Gesprächsschritt Rechenzeit, ein Dokument nur, wenn es gebraucht wird. Ausnahme ist company: kurz und so oft gefragt, dass es in den Prompt gehört.