Agenten & Assistent
KI-Anruf-Agenten, Agent-Vorlagen, Prompt-Generierung sowie die Werkzeuge des
Assistenten zur Terminbuchung. Alle /api-Endpunkte erfordern ein gültiges
Bearer-JWT und sind auf die
project_id des Tokens beschränkt.
Das Call Outcome nach einem Anruf wählt eine eigene KI, die den Agent-Prompt
nicht sieht. Outcome-Regeln gehören in das Feld configuration.postCallPrompt.
Siehe Post-Call-Outcomes: wie die Zuordnung funktioniert.
Agenten
| Methode | Pfad | Beschreibung |
|---|---|---|
| GET | /api/agents | Listet Agenten auf. |
| GET | /api/agents/{id} | Ruft einen Agenten ab. |
| POST | /api/agents | Erstellt einen Agenten. |
| PUT | /api/agents/{id} | Aktualisiert einen Agenten. |
| DELETE | /api/agents/{id} | Löscht einen Agenten. |
| GET | /api/agent-templates | Listet Agent-Vorlagen auf. |
| GET | /api/agent-templates/{id} | Ruft eine Agent-Vorlage ab. |
Assistent & Prompts
| Methode | Pfad | Beschreibung |
|---|---|---|
| POST | /api/assistant/create | Erstellt einen Assistenten. |
| POST | /api/generate-prompt | Generiert einen Agent-Prompt aus Eingaben. |
| POST | /api/assistent/appointment | Bucht einen Termin (Assistent-Werkzeug). |
| POST | /api/assistent/tool | Calendly-Werkzeugaufruf (Assistent). |
| POST | /api/assistent/call | Assistent-Anruf-Auslöser. |
| POST | /api/calender/free-slots | Gibt freie Kalender-Slots für die Buchung zurück. |
Terminbuchung konfigurieren
Die Buchung wird im configuration-Objekt des Agenten unter tools.calendly
abgelegt — der Schlüssel heißt aus historischen Gründen so, deckt aber alle
drei Anbieter ab: Calendly, YouCanBookMe und iClosed. Pro Kalender wählt das
Feld provider den Anbieter: "calendly", "ycbm" oder "iclosed".
Ein Kalendereintrag ohne provider wird als Calendly gelesen. Für
YouCanBookMe und iClosed muss provider deshalb immer explizit gesetzt werden,
sonst bucht der Agent nicht (bzw. wird fälschlich an die Calendly-API geleitet).
Pro Kalender:
provider—"calendly","ycbm"oder"iclosed".event_type_uri— anbieterspezifisch. Calendly: die vollständige Event-Type-URI (https://api.calendly.com/event_types/…). YouCanBookMe: die Subdomain der Buchungsseite (z. B.max-mustermann). iClosed: der Event-linkPrefix(z. B.talk2kids/talk2kids-erstgespraech-2); der enthaltene Schrägstrich ist Teil des Werts, eine vollständige URL wird akzeptiert und auf den Prefix reduziert.integration_id— Id der verbundenen Integration (GET /api/integrations?provider=iclosed); deren Anbieter muss zuproviderpassen.location_kind— nur Calendly; YouCanBookMe und iClosed ignorieren das Feld.
iClosed-Grenzen: keine Stornierung/Verschiebung über die API; Zusatzfragen
(secondaryQuestions) werden nicht ausgefüllt; fehlt die Zeitzone, fallen die
Slot-Zeiten auf Europe/Berlin zurück; Rate-Limit 20 Anfragen / 10 s pro Endpunkt.