Übersicht
Aktionen verwandeln deine KI-Agenten von reinen Gesprächsassistenten in leistungsstarke Tools zur Geschäftsautomatisierung. Über das Beantworten von Fragen hinaus können deine Agenten Termine planen, Anrufe weiterleiten, Systeme aktualisieren und sich in deine bestehenden Geschäftsabläufe integrieren - alles während sie einen natürlichen Gesprächsfluss aufrechterhalten. Stelle sich Aktionen als Werkzeugkasten deines Agenten vor. So wie ein menschlicher Mitarbeiter verschiedene Tools zur Erledigung von Aufgaben nutzt, führt dein KI-Agent Aktionen aus, um während Kundeninteraktionen echte Arbeit zu leisten.Aktionen werden automatisch basierend auf dem Gesprächskontext und den Anweisungen ausgeführt, die du in der Aufforderung deines Agenten angibst. Du definierst wann und wie Aktionen verwendet werden sollten durch Prompt Engineering.
Was sind Aktionen?
Aktionen sind vorkonfigurierte Tools, die dein Agent während Gesprächen aufrufen kann, um bestimmte Aufgaben zu erledigen. Wenn ein Kunde etwas anfordert, das eine Aktion erfordert - wie die Buchung eines Termins oder das Gespräch mit einem Spezialisten - kann dein Agent die entsprechende Aktion nahtlos ausführen.Wie Aktionen funktionieren
Während Gesprächen entscheidet dein Agent autonom, ob er direkt antworten oder eine Aktion ausführen soll: Der Agent verwendet Aktionsnamen und Beschreibungen, um zu verstehen, was jede Aktion tut. Diese sind entscheidend dafür, dass das LLM das richtige Tool auswählt. Best Practices:- Gib Aktionen klare, beschreibende Namen (z.B. “termin_buchen” nicht “aktion1”)
- Schreibe detaillierte Beschreibungen, die erklären, was die Aktion tut
- Füge explizite Anweisungen in deinen Agentenanweisungen (System-Prompt) hinzu, wann jede Aktion verwendet werden soll
Während Aktionsnamen und Beschreibungen dem Agenten mitteilen, was eine Aktion tut, sollten deine Agentenanweisungen (System-Prompt) angeben, wann sie verwendet werden soll. Zum Beispiel: “Wenn ein Kunde darum bittet, mit einem Menschen zu sprechen, verwende die Aktion transfer_to_support.”
Aktionskategorien
Aktionen sind im Dashboard in zwei Kategorien organisiert:Anrufsteuerung
Anruf weiterleiten
Weiterleiten an einen anderen KI-Agenten, eine Telefonnummer oder SIP-Adresse
Gespräch beenden
Lasse den Agenten das Gespräch mit einer benutzerdefinierten Nachricht beenden
Integration
Benutzerdefinierte Aktion
Erstelle eine benutzerdefinierte API- oder Webhook-Aktion
Kalenderbuchung
Plane Termine mit Cal.com-Integration
Wann Aktionen ausgeführt werden
Aktionen werden während des Gesprächs ausgeführt, wenn sie von deinem Agenten basierend auf seinen Anweisungen ausgelöst werden. Im Gegensatz zu traditionellen IVR-Systemen, die starren Skripten folgen, nutzen KI-Agenten kontextuelles Verständnis, um zu bestimmen, wann Aktionen angemessen sind.Auslösemechanismen
Anweisungsbasierte Auslöser:Aktionen konfigurieren
Die gesamte Aktionskonfiguration erfolgt im Agenteneditor unter dem Tab Fähigkeiten → Aktionen.Aktionstyp wählen
Durchsuche die Kategorien Anrufsteuerung und Integration und klicke auf Hinzufügen bei der Aktion, die du konfigurieren möchtest
Aktion konfigurieren
Fülle das aktionsspezifische Konfigurationsformular aus:
- Name: Gib deiner Aktion einen klaren, beschreibenden Namen
- Beschreibung: Erkläre, was diese Aktion tut
- Aktionsspezifische Einstellungen: Konfiguriere Parameter basierend auf dem Aktionstyp
Aktionsstatusanzeigen
Nach dem Hinzufügen von Aktionen siehst du diese im Aktionen-Tab deines Agenten mit Statusanzeigen aufgelistet:Konfiguriert
Aktion ist ordnungsgemäß konfiguriert und einsatzbereit
Unvollständig
Fehlende erforderliche Konfiguration oder Anmeldeinformationen
Fehler
Konfigurationsfehler oder Authentifizierungsfehler
Aktionen in Anweisungen referenzieren
Um Aktionen zu verwenden, referenziere diese mit dem exakten Namen in den Anweisungen deines Agenten:Direkte Referenz
Mit Bedingungen
Mit Parametern
Aktionsnamen sind case-sensitive und müssen genau wie konfiguriert übereinstimmen. Wenn du eine Aktion umbenennst, aktualisiere alle Referenzen in deinen Anweisungen.
Best Practices für die Konfiguration
Einfach beginnen
Einfach beginnen
Beginne mit grundlegenden Aktionen, bevor du komplexe Integrationen hinzufügen. Füge eine Aktion nach der anderen hinzu, teste gründlich, dann füge die nächste hinzu.Beispiel-Reihenfolge:
- Aktion “Gespräch beenden” hinzufügen
- Aktion “Transfer zum Support” hinzufügen
- Buchungsaktion hinzufügen
- Benutzerdefinierte API-Aktionen hinzufügen
Verwende klare, beschreibende Namen
Verwende klare, beschreibende Namen
Aktionsnamen sind entscheidend - das LLM verwendet sie, um zu verstehen, was jedes Tool tut. Verwende beschreibende, aktionsorientierte Namen, die den Zweck der Funktion klar vermitteln.Warum dies wichtig ist: Das Modell verlässt sich auf Funktionsnamen und Beschreibungen, um zu erkennen, wann eine Funktion aufgerufen werden muss und das richtige Tool für die Aufgabe auszuwählen.Gute Namen:
- “Kundenkonto abrufen” - Klares Aktionsverb + spezifisches Ziel
- “Transfer zur Abrechnungsabteilung” - Spezifisches Ziel enthalten
- “30-Minuten-Beratung buchen” - Enthält relevante Details
- “Aktion 1” - Kein Kontext darüber, was sie tut
- “Transfer” - Zu allgemein, unklar wohin
- “API-Aufruf” - Beschreibt die Aktion nicht
Schreibe detaillierte Beschreibungen
Schreibe detaillierte Beschreibungen
Aktionsbeschreibungen helfen dem LLM zu verstehen, was die Aktion tut. Die Beschreibung sollte den Zweck der Aktion, was sie zurückgibt und welche Parameter sie verwendet, erklären.Best Practices von OpenAI function calling:Hinweis: Beschreibe was die Aktion in der Beschreibung tut. Gib wann sie verwendet werden soll in deinen Agentenanweisungen (System-Prompt) an.
- Beschreibe klar, was die Aktion tut und was sie zurückgibt
- Erkläre, welche Parameter oder Daten sie verwendet
- Verwende präzise Sprache, die das Verständnis des Modells leitet
- Halte es prägnant und dennoch umfassend
Gründlich testen
Gründlich testen
Teste jede Aktion in der Agenten-Testoberfläche, bevor du live gehen:
- Überprüfe, ob die Aktion korrekt ausgeführt wird
- Teste Erfolgsszenarien
- Teste Fehlerszenarien
- Überprüfe die Fehlerbehandlung
- Überprüfe den Gesprächsfluss
Fehler elegant behandeln
Fehler elegant behandeln
Konfiguriere Fallback-Verhaltensweisen für den Fall, dass Aktionen fehlschlagen. Weise deinen Agenten an, was zu tun ist, wenn Aktionen nicht funktionieren.
Sammle zuerst Informationen
Sammle zuerst Informationen
Stelle sicher, dass Agenten erforderliche Daten sammeln, bevor sie Aktionen ausführen. Versuche nicht, Termine ohne E-Mail-Adressen zu buchen oder Anrufe weiterzuleiten, ohne zu erklären warum.
Anmeldeinformationen sichern
Anmeldeinformationen sichern
Verwende geeignete Authentifizierung für alle benutzerdefinierten Aktionen. Exponiere niemals API-Schlüssel oder Anmeldeinformationen in URLs oder unverschlüsselten Feldern.
- Verwende Bearer-Token für API-Authentifizierung
- Verwende Basic Auth nur über HTTPS
- Speichere sensible Anmeldeinformationen sicher
- Rotiere Anmeldeinformationen regelmäßig
Aktionen testen
Vor der Bereitstellung von Agenten mit Aktionen teste gründlich in der Dashboard-Testoberfläche:Ausführung überprüfen
Überprüfe, dass Aktionen korrekt ausgeführt werden und Antworten angemessen behandeln
Fehlerfälle testen
Simuliere Fehler, um zu überprüfen, dass die Fehlerbehandlung wie erwartet funktioniert
Was zu testen ist
Für Transfer-Aktionen:- Transfer wird zum richtigen Ziel ausgeführt
- Wartemusik wird abgespielt, wenn konfiguriert
- Transfer-Nachricht ist angemessen
- Kalt- vs. Warmtransfer-Modi funktionieren korrekt
- Verfügbarkeit wird korrekt abgerufen
- Buchung wird erfolgreich bestätigt
- E-Mail/SMS-Benachrichtigungen werden ordnungsgemäß gesendet
- Zeitzonen-Behandlung ist genau
- API-Aufrufe erfolgreich
- Authentifizierung funktioniert
- Antwortdaten sind für den Agenten verfügbar
- Fehlerantworten werden elegant behandelt
- Agent referenziert Aktion mit korrektem Namen
- Agent sammelt zuerst erforderliche Informationen
- Gesprächsfluss bleibt natürlich
- Fehler brechen das Gespräch nicht ab
Häufige Anwendungsfälle
Kundensupport-Workflow
Terminbuchungs-Workflow
Vertriebsqualifizierungs-Workflow
Fehlerbehebung häufiger Probleme
Aktion wird nicht ausgelöst
Aktion wird nicht ausgelöst
Problem: Agent verwendet die Aktion nicht, obwohl er sollte.Lösungen:
- Überprüfe, ob der Aktionsname in den Anweisungen genau übereinstimmt (case-sensitive)
- Überprüfe, ob der Aktionsstatus “Konfiguriert” ist, nicht “Unvollständig” oder “Fehler”
- Mache Anweisungen expliziter darüber, wann die Aktion verwendet werden soll
- Teste isoliert, indem du den Agenten explizit aufforderst, die Aktion zu verwenden
- Überprüfe das Gesprächstranskript, um die Argumentation des Agenten zu sehen
Agent sagt, Aktion wird ausgeführt, aber tut es nicht
Agent sagt, Aktion wird ausgeführt, aber tut es nicht
Problem: Agent bestätigt mündlich, dass er eine Aktion ausführt (z.B. “Ich verbinde du jetzt”), aber die Aktion wird erst im nächsten Gesprächszug ausgeführt.Warum dies passiert: Der Agent generiert eine Antwort und führt die Aktion im selben Zug aus, aber nur eines kann pro Zug passieren.Lösung: Fordere den Agenten auf, vor der Ausführung von Aktionen um Benutzerbestätigung zu bitten:Dies stellt sicher, dass der Agent die Aktion unmittelbar nach Erhalt der Bestätigung ausführt, nicht im selben Zug wie die Ankündigung.
Authentifizierungsfehler
Authentifizierungsfehler
Problem: Benutzerdefinierte Aktionen schlagen mit 401/403-Fehlern fehl.Lösungen:
- Überprüfe, ob die Anmeldeinformationen korrekt sind und nicht abgelaufen sind
- Überprüfe, ob der Authentifizierungstyp den API-Anforderungen entspricht
- Stelle sicher, dass Bearer-Token das Präfix “Bearer” enthalten, falls erforderlich
- Teste den Endpunkt unabhängig mit Postman oder curl
- Überprüfe die API-Dokumentation zum Authentifizierungsformat
Buchungsaktion schlägt fehl
Buchungsaktion schlägt fehl
Problem: Cal.com-Buchungsaktion gibt Fehler zurück.Lösungen:
- Überprüfe, ob die Cal.com-Integration verbunden ist
- Überprüfe, ob der Ereignistyp existiert und aktiv ist
- Stelle sicher, dass die Meeting-Plattform in Cal.com konfiguriert ist
- Überprüfe, ob Planungsfenster angeforderte Daten zulassen
- Überprüfe die Zeitzonenkonfiguration
- Teste die Buchung manuell in Cal.com, um die Verfügbarkeit zu überprüfen
Transfer verbindet nicht
Transfer verbindet nicht
Problem: Transfer-Aktion wird ausgeführt, aber verbindet nicht.Lösungen:
- Überprüfe, ob das Ziel im korrekten E.164-Format ist (z.B. +15551234567)
- Stelle sicher, dass die Telefonnummer erreichbar ist (für Telefontransfers)
- Überprüfe, ob die SIP-Adresse korrekt ist (für SIP-Transfers)
- Teste das Ziel unabhängig
Nächste Schritte
Anrufsteuerungsaktionen
Konfiguriere Transfer-, Gesprächsbeendigungs- und Inaktivitätsverwaltungsaktionen
Transfer-Details
Meistern du Transfer-Ziele, Modi und erweiterte Einstellungen
Buchungsintegration
Richte Cal.com-Terminplanung mit E-Mail- und SMS-Benachrichtigungen ein
Benutzerdefinierte API-Aktionen
Verbinde deine Agenten mit externen Systemen und APIs
Anweisungsleitfaden
Erfahre, wie du effektive Agentenanweisungen schreibst
Prompt Engineering
Meistere fortgeschrittene Prompting-Techniken für zuverlässiges Agentenverhalten