Wie funktioniert die KI-Integration?
- Waar vind ik dit
- Configuratie > AI instellingen
Der MCP-Server spricht JSON-RPC 2.0 und macht i-Reserve für externe KI-Agenten nutzbar: Chatbots, Sprachassistenten und andere automatisierte Clients können die Verfügbarkeit abfragen und - nach entsprechender Verifizierung - Reservierungen ändern oder stornieren.
Authentifizierung
Ein KI-Agent authentifiziert sich mit demselben lizenzweiten API-Schlüssel wie die reguläre REST-API - es gibt kein separates Schlüsselsystem pro Agent. Siehe Wie funktioniert ein API-Schlüssel? für das Erstellen und Verwalten dieses Schlüssels. Erforderliches Recht: menu_config_api.
Kanäle
Es wird unterschieden zwischen dem MCP-Kanal (ein externer Agent oder das eigene KI-Widget) und der internen Nutzung durch i-Reserve selbst. Bei jeder Reservierung wird festgehalten, über welchen Kanal sie entstanden oder geändert ist.
Was ein Agent immer darf, ohne Verifizierung
Ohne dass die Identität des Kunden festgestellt wurde, darf ein Agent unter anderem: Verfügbarkeit und Objekte abfragen, Events suchen und sich dafür anmelden, einen Kunden suchen oder anlegen, eine neue Reservierung anlegen, die Stornobedingungen abfragen und - falls eingerichtet - an einen Mitarbeiter weiterleiten.
Vertrauensstufen
| Stufe | Nachweis | Beispiel erlaubter Aktion |
|---|---|---|
| L0 | keiner | Verfügbarkeit und Bedingungen erklären |
| L1 | Kanalabgleich (Rufnummererkennung/Linkklick) | eigene Reservierung zusammenfassen |
| L2 | Einmalcode (OTP) per SMS oder E-Mail | Reservierung verschieben, Teilnehmer ändern |
| L3 | OTP + etwas, das nur zur Reservierung gehört (z. B. Reservierungsnummer) | Stornieren mit Rückerstattung |
Rufnummererkennung oder ein Linkklick sind fälschbar und zählen daher nur als L1: Das bestimmt lediglich, an welche Nummer oder Adresse ein Verifizierungscode geht, und verleiht selbst keine zusätzlichen Rechte.
Verifizierungsablauf
Um eine Reservierung zu ändern oder zu stornieren, fordert der Agent zuerst einen Einmalcode an. Der Kunde erhält diesen Code selbst per SMS oder E-Mail und gibt ihn an den Agenten weiter. i-Reserve stellt anschließend ein kurzlebiges, an die Reservierung gebundenes Token aus - der Agent bekommt den Code selbst nie zu sehen.
Ändern und Stornieren: immer in zwei Schritten
Eine Änderung oder Stornierung erfolgt nie in einem Schritt. Zuerst berechnet i-Reserve unverbindlich, was die Änderung bedeutet (neues Datum, ein etwaiger Preisunterschied oder der Rückerstattungsbetrag). Erst nachdem der Kunde dies ausdrücklich bestätigt hat, wird die Änderung tatsächlich durchgeführt. Dieselbe Bestätigung erneut einzureichen führt die Änderung nicht ein zweites Mal aus.
Missbrauchsschutz
Bei einem unbekannten Kontaktdatum reagiert der Agent identisch wie bei einem bekannten, sodass keine Information darüber durchsickert, wer Kunde ist und wer nicht. Zudem besteht ein eingebauter Schutz gegen ungewöhnliche Spitzen bei Stornierungen.
Protokollierung
Bei Tool-Aufrufen wird festgehalten, welche Aktion über welchen Agenten ausgeführt wurde, sodass dies im Nachhinein nachvollziehbar ist.
Weiterlesen
Stornierungsbedingungen konfigurieren
Die oben von der Agentin abgefragten Stornierungsbedingungen werden konfiguriert unter: Stornierungs-Rückerstattungsstaffeln konfigurieren.
Wo Sie all das einstellen, steht in Wo finde ich die KI-Einstellungen?.