Live-Call-Funktionen
Verbinden Sie Ihren AI-Agenten per MCP-Server mit externen Systemen. So nutzt er Live-Daten wie CRM-Infos oder Kalender-Verfügbarkeiten direkt im Gespräch.
Wie richte ich Live-Call-Funktionen für den AI-Agenten ein?
Für manche Anwendungsfälle benötigt Ihr AI-Agent während eines laufenden Calls aktuelle Daten aus externen Systemen – zum Beispiel Kundendaten aus Ihrem CRM oder Live-Verfügbarkeiten aus Ihrem Kalender. Die Live-Call-Funktionen ermöglichen genau das: Sie verbinden Ihren AI-Agenten über einen MCP-Server mit einem System Ihrer Wahl.
MCP steht für Model Context Protocol – eine standardisierte Schnittstelle, über die AI-Agenten mit externen Diensten kommunizieren können.
Voraussetzung: Sie benötigen einen erreichbaren MCP-Server.
Schritt 1: MCP-Server hinterlegen
Öffnen Sie in app.sipgate.com den gewünschten AI-Agenten.
Wechseln Sie zum Tab Integrationen.
Klicken Sie im Bereich Live-Call-Funktionen auf Hinzufügen.
Füllen Sie das Formular aus:
Name (optional): Ein interner Anzeigename für den Server.
URL: Die HTTPS-Adresse Ihres MCP-Servers.
Token (optional): Ein Authentifizierungstoken, falls Ihr Server eine Absicherung erfordert.
Klicken Sie auf Speichern. sipgate verbindet sich automatisch mit dem Server und prüft die Verbindung.
Achtung: Die URL muss mit https:// beginnen. Verbindungen ohne TLS werden nicht akzeptiert.
Schritt 2: Tools des MCP-Servers prüfen
Nach erfolgreicher Verbindung zeigt sipgate die vom Server bereitgestellten Tools in der Übersicht an. Prüfen Sie dort:
Toolname: Darf maximal 28 Zeichen lang sein. Längere Namen werden in der Übersicht als Fehler markiert und können dazu führen, dass der AI-Agent das Tool nicht zuverlässig nutzt.
Tool-Beschreibungen: Die Beschreibungen werden vom MCP-Server empfangen und übernommen. Je präziser die Beschreibung, desto besser erkennt der AI-Agent, wann er das Tool einsetzen soll. Passen Sie – wenn möglich – die Tool-Beschreibung seitens des MCP-Servers an.
Parameter: Jeder Parameter sollte ebenfalls eine aussagekräftige Beschreibung haben. Die Informationen in welchem Format (string, array, etc.) dieser vom MCP Server erwartet wird und ob dieser optional oder erforderlich sind für einen erfolgreichen Austausch zwischen Agent und MCP-Server entscheidend.
Tipp: Die Beschreibung ist der wichtigste Teil eines Tools – sie ist das einzige, woraus der Agent ableitet, wann und wie er das Tool einsetzt.
Eine gute Beschreibung:
nennt klar den Zweck des Tools
erklärt ggf. Einschränkungen (z.B. maximal 3 Ergebnisse, nur Werktage)
vermeidet technisches Implementierungs-Wissen (was im Hintergrund passiert, ist für den Agenten irrelevant)
Eine schlechte Beschreibung ist zu allgemein oder fehlt ganz. Der Agent wird das Tool dann falsch oder gar nicht einsetzen.
Schritt 3: MCP-Server in Ihr Playbook integrieren
Der AI-Agent arbeitet zielorientiert. Beschreiben Sie im Playbook, was er erreichen soll – nicht, wie er Schritt für Schritt vorgehen soll.
Gut: „Ermittle die Kundennummer des Anrufers anhand seiner Telefonnummer get_customer und begrüße ihn mit seinem Namen get_name."
Weniger gut: „1. Ruf das Tool get_customer auf. 2. Speichere die ID. 3. Ruf dann get_name auf …"
Der AI-Agent entscheidet selbst, welche Tools er in welcher Reihenfolge nutzt, um das Ziel zu erreichen.
Achtung: Geschäftslogik, Validierung und State-Management gehören nicht in das Playbook – das ist Aufgabe des MCP-Servers. Das Playbook beschreibt Ziele, der MCP-Server stellt die Werkzeuge bereit.
Beispiel: Playbook-Struktur für eine Terminbuchung
Bedigungen für das Playbook: Wenn der Nutzer einen Termin buchen möchte oder nach freien Terminen fragt.
1
Tageszeit erfragen
Frage den Nutzer, zu welchem Tagesabschnitt er den Termin bevorzugt. Die vier Optionen sind: vormittag, mittag, nachmittag oder abend. Merke dir die Antwort als preferred_timeslot für alle weiteren Tool-Aufrufe.
✅
2
Terminvorschläge holen
Rufe get_next_suggestions mit der gemerkten preferred_timeslot auf. Präsentiere dem Nutzer die zurückgegebenen Terminvorschläge mit Datum und Uhrzeit.
❌
3
Slot bestätigen oder Alternative
Frage den Nutzer: Passt einer der Vorschläge? Möchte er einen speziellen Tag nennen? Oder passt keiner der Vorschläge? • Slot gewählt → merke Termin, weiter zu Task 5 (Vorname erfassen) • Spezieller Tag → weiter zu Task 4 (Tag erfragen & Tagesvorschläge) '• Keiner passt → zurück zu Task 2 (Terminvorschläge holen)
✅
4
Tag erfragen & Tagesvorschläge
Frage nach dem gewünschten Datum. Rufe get_suggestions_for_day auf und präsentiere die Vorschläge. Kehre zur Logik von Task 3 zurück.
Fehlerbehandlung:
• invalid date format → Erkläre dem Nutzer, dass das Datum nicht erkannt wurde, und frage erneut nach einem gültigen Datum (Format: TT.MM.JJJJ)
• Datum zu weit in der Zukunft → Informiere den Nutzer, dass maximal 2 Monate im Voraus gebucht werden kann, und frage nach einem näheren Datum
• Sonstiger Fehler → Erkläre das Problem und kehre zu Task 3 (Slot bestätigen oder Alternative) zurück, damit der Nutzer einen anderen Tag wählen oder neue Vorschläge anfordern kann
❌
5
Vorname erfassen
FALLS der Vorname noch nicht bekannt ist: Frage gezielt danach. FALLS bereits bekannt: überspringe diesen Task.
✅
6
Nachname erfassen
FALLS der Nachname noch nicht bekannt ist: Frage gezielt danach. FALLS bereits bekannt: überspringe diesen Task.
✅
7
Telefonnummer erfassen
Die Rufnummer des Anrufers steht im Kontext unter „Nutzer mit der Rufnummer: …" — diese direkt verwenden, NICHT danach fragen. Nur falls dieser Eintrag fehlt oder der Anrufer anonym ist: Frage gezielt nach der Telefonnummer.
✅
8
Kontaktdaten bestätigen
Lies Vorname, Nachname und Telefonnummer noch einmal vor und bitte um Bestätigung. Falls der Nutzer eine Korrektur vornimmt: Übernimm die Korrektur und lies die Daten erneut vor.
❌
9
Termin buchen
Rufe book_appointment auf mit den Termin-Daten (start, end) und den Kontaktdaten (firstname, lastname, phone). FALLS Buchung erfolgreich (success: true): Bestätige die Buchung mit Datum und Uhrzeit und fahre mit Task 10 (Bedanken & verabschieden) fort.
Fehlerbehandlung:
• Slot vergeben (409 / „no longer available") → Informiere den Nutzer, dass der Slot inzwischen vergeben ist, und kehre zu Task 2 (Terminvorschläge holen) zurück
• Sonstiger Fehler → Erkläre dem Nutzer kurz, dass etwas schiefgelaufen ist, und frage ob er einen anderen Termin wählen möchte (zurück zu Task 3 – Slot bestätigen oder Alternative) oder ob er es später nochmals versuchen möchte
✅
10
Bedanken & verabschieden
Bedanke dich beim Nutzer für das Gespräch und wünsche ihm einen schönen Tag. Keine weiteren Angebote machen.
❌
Verbindung aktualisieren
Wenn Sie Ihren MCP-Server aktualisiert haben (z. B. neue Tools hinzugefügt), klicken Sie in der Live-Call-Funktionen-Übersicht ihres Agents unter Integrationen auf den Button ... → Aktualisieren und die aktuelle Tooliste wird neu abgerufen.
Live-Call-Funktionen testen
Es empfehlen sich manuelle Testanrufe, bei denen das Playbook aktiv genutzt wird. Dabei prüfen:
Triggert der Agent die richtigen Tools?
Werden die Parameter korrekt befüllt?
Reagiert der Agent sinnvoll auf Fehlermeldungen des Servers?
Sicherheitshinweise
Beachten Sie bei der Einrichtung Ihres MCP-Servers folgende Punkte:
Zugriffsrechte: Läuft Ihr MCP-Server mit Admin-Rechten auf ein Drittsystem, hat der AI-Agent potenziell weitreichenden Zugriff. Vergeben Sie nur die minimal notwendigen Berechtigungen.
Identitätsprüfung: Überlegen Sie, welche Informationen ein Anrufer abfragen kann – und ob eine zusätzliche Authentifizierung für sensible Operationen sinnvoll ist.
Eingabevalidierung: Validieren Sie alle Eingaben serverseitig. Verlassen Sie sich nicht darauf, dass der AI-Agent nur erwartete Werte übergibt.
Datenweitergabe: Stellen Sie sicher, dass Ihr Server keine Daten an unberechtigte Dritte ausgeben kann – z. B. durch ungeprüfte Rückgabewerte.
Zuletzt aktualisiert