Während eines Anrufs Aktionen in Ihren Systemen auslösen

Mit dem Skill Externe Aktion kann Ihr KI-Agent während eines laufenden Gesprächs API-Aufrufe in Echtzeit ausführen.

Das ist nützlich, wenn Ihr Agent Informationen sofort abrufen oder senden muss, zum Beispiel einen Bestellstatus prüfen, eine Buchung verifizieren oder einen Preis berechnen, während der Anrufer noch in der Leitung ist.

Über die API-Anbindung Ihrer externen Systeme greift der Agent auf aktuelle Daten zu und antwortet sofort, damit das Gespräch lebendig und korrekt bleibt.

Die Externe Aktion ist derselbe Skill wie der Modus „während des Anrufs" von API Aufrufen. Die vollständige Referenz, inklusive Results und Path, finden Sie unter API Aufrufen — während des Anrufs.

Wann Sie ihn nutzen

Nutzen Sie diesen Skill, wenn Ihr Agent:

• Daten in Echtzeit abrufen oder aktualisieren soll, während er mit dem Anrufer spricht.
• eine Aktion abhängig von den Aussagen des Kunden ausführen soll (zum Beispiel Sendungsstatus prüfen oder eine Mitgliedschaft verifizieren).
• Live-Informationen aus Ihrem System nennen soll, etwa Preise, Verfügbarkeit oder Kontodaten.

So funktioniert es

Der Skill führt während des Gesprächs eine API-Anfrage aus, ausgelöst durch die Logik, die Sie im Hauptziel des Agenten festlegen.

Sie können festlegen:

• API-Methode: GET oder POST.
• Parameter: Informationen, die die API braucht (etwa eine Bestellnummer oder E-Mail).
• Header: Authentifizierung oder eigene Header (zum Beispiel Authorization: Bearer token).
• Results: welche Werte aus der API-Antwort die KI lesen und nutzen soll.

Der Agent ruft dann Ihre API auf, verarbeitet das Ergebnis und nutzt es ganz natürlich in seiner Antwort an den Anrufer.

Einrichtung

1. Gehen Sie zu Agent → Fähigkeiten → Externe Aktion.
2. Füllen Sie folgende Felder aus:
   • Aktionsname: ein klarer Name (zum Beispiel check_order_status).
   • Beschreibung: was die Aktion tut (zum Beispiel „Sendungsinformationen abrufen").
   • API-Endpunkt: die URL der API.
   • Methode: GET oder POST.
   • Parameter (optional): Eingabewerte, die Ihre API braucht (zum Beispiel order_number, email).
   • Results (optional): die erwarteten Antwortschlüssel (zum Beispiel status, estimated_delivery_date).
   • Header (optional): benötigte Header, etwa Autorisierungstokens.
3. Schalten Sie Fähigkeit aktivieren ein.
4. Klicken Sie auf Erstellen.

Beispielanweisung

Da die Externe Aktion während des Gesprächs läuft, müssen Sie im Hauptziel klar festlegen, wann die KI sie auslöst. Zum Beispiel:

Möchte der Anrufer den Lieferstatus seiner Bestellung wissen, nutze die externe Aktion check_order_status mit dem Parameter order_number, den der Anrufer nennt. Nenne ihm dann den aktuellen Status und das voraussichtliche Lieferdatum.

So weiß der Agent genau, wann er die API aufruft und wie er das Ergebnis nutzt.

Anwendungsbeispiel: Sendungsverfolgung

Szenario: Ein Kunde ruft an und fragt: „Wo ist mein Paket?"

Konfiguration:

• Aktionsname: check_order_status
• API-Endpunkt: https://api.shippingcompany.com/tracking
• Methode: GET
• Parameter: order_number (Text)
• Results: status, estimated_delivery_date

Beispielanweisung:

Fragt der Anrufer nach seinem Lieferstatus, rufe die externe Aktion check_order_status auf. Beantworte die Frage klar mit den Ergebnisfeldern {{status}} und {{estimated_delivery_date}}.

Beispielgespräch:

Anrufer: „Können Sie mir sagen, wo mein Paket ist?"

KI-Agent: „Gern, nennen Sie mir bitte Ihre Bestellnummer."

(Der Agent ruft die API in Echtzeit auf.)

KI-Agent: „Ihr Paket ist unterwegs und sollte am 24. Oktober ankommen."

Weitere Beispiele

• Mitgliedschaft prüfen: „Nennt der Anrufer seine Mitgliedsnummer, prüfe mit check_membership_status, ob sein Konto aktiv ist."
• Preisabfrage: „Fragt der Anrufer nach einem Angebot, löse die Aktion get_price_estimate mit Produktname und Menge aus."

Die Externe Aktion gibt Ihrem KI-Agenten Live-Zugriff auf Ihre Systeme: Er kann Informationen abrufen, Angaben prüfen oder Aktionen in Echtzeit ausführen, während das Gespräch natürlich weiterläuft.