So verbinden Sie einen KI-Agenten mit Ihrer eigenen API

Erstellen Sie eine eigene Aktion, damit ein Agent von Sell Whisper AI während eines Gesprächs Ihren HTTP-Endpunkt aufrufen kann, mit Eingaben, Authentifizierung und Testlauf. Ab Starter.

Schritte

In dieser Reihenfolge vorgehen

  1. Eigene Aktion erstellen

    Öffnen Sie den Agenten, gehen Sie zu Aktionen (Actions), dann zu „Eigene Aktionen“ (Custom actions), und erstellen Sie eine Aktion vom Typ „API-Aufruf“ (API Call). Eigene Aktionen sind ab Starter verfügbar.

    Liste der benutzerdefinierten Aktionen eines Agenten
  2. Beschreiben, wann sie verwendet wird

    Geben Sie der Aktion einen Namen und eine Beschreibung und füllen Sie „Wann verwenden“ (When to Use) in einfachen Worten aus: Dieser Text sagt der KI, wann sie Ihren Endpunkt aufrufen soll. Fügen Sie unter „Benutzereingaben“ (User Inputs) jeden Wert hinzu, den der Agent erfassen soll, mit seinem Typ und der Angabe, ob er erforderlich ist.

    Formular für eine benutzerdefinierte Aktion mit API-Aufruf, Einsatzbeschreibung und Endpunkt
  3. Auf Ihren Endpunkt richten

    Legen Sie Methode, Endpunkt-URL, Header, Query-Parameter und einen JSON-Request-Body fest. Wählen Sie die Art der Authentifizierung: API-Schlüssel, Bearer-Token, Basic Auth oder ein eigener Header.

  4. Testen und einschalten

    Speichern Sie und klicken Sie dann auf „Mit Live-Daten testen“ (Test with Live Data), um den Aufruf auszuführen. Verlangen Sie eine Bestätigung durch den Nutzer für alles, was Daten ändert, aktivieren Sie die Aktion und probieren Sie sie im Playground aus.

Vier Arten eigener Aktionen

TypWas er tut
API-Aufruf (API Call)Ruft Ihren HTTP-Endpunkt von den Servern von Sell Whisper AI aus auf und gibt die Antwort an den Agenten weiter
Button-Link (Button Link)Zeigt eine Schaltfläche, die eine URL öffnet
Formular (Form)Zeigt ein Formular und sendet die Eingaben Ihres Kunden per POST an einen Webhook
ClientFührt einen Handler, den Sie auf Ihrer eigenen Seite registrieren, im Browser des Besuchers aus

Diese Anleitung verwendet den Typ „API-Aufruf“ (API Call). Er eignet sich für Abfragen wie einen Bestellstatus, einen Kontostand oder eine Buchung und für Änderungen wie die Kündigung eines Abonnements.

Die Beschreibung für die KI schreiben

Der Agent entscheidet anhand der Beschreibung und des Textes unter „Wann verwenden“ (When to Use), wann er eine Aktion aufruft. Schreiben Sie beides so, wie Sie eine neue Kollegin oder einen neuen Kollegen einweisen würden: was die Aktion zurückgibt und in welchen Situationen sie gefragt ist. Benennen Sie jede Eingabe eindeutig und sagen Sie, wie ein gültiger Wert aussieht. Vage Beschreibungen sind der häufigste Grund dafür, dass eine Aktion nie oder im falschen Moment aufgerufen wird.

Für Sicherheit sorgen

  • Authentifizierung. Hinterlegen Sie API-Schlüssel, Bearer-Token oder Basic-Zugangsdaten an der Aktion; Ihr Kunde bekommt sie nie zu sehen.
  • Bestätigung. Aktivieren Sie die Bestätigung durch den Nutzer für alles, was Daten ändert, damit Ihr Kunde den Aufruf zuerst freigibt.
  • Limits und Wiederholungen. Legen Sie für einen langsamen Endpunkt ein Timeout und die Anzahl der Wiederholungsversuche fest, und Rate-Limits unter „Erweitert“ (Advanced).
  • Wer fragt. Für kontospezifische Aufrufe verifizieren Sie angemeldete Nutzer, damit die Anfrage eine Identität trägt, die Ihr Server signiert hat.

Das Ergebnis anzeigen

Aktivieren Sie die Ergebnisansicht, um die Antwort im Widget als Karte, Formular oder Tabelle anzuzeigen. Messaging-Apps erhalten denselben Inhalt als Text.

Verwandte Themen

FAQ

Häufige Fragen

Kann die Antwort als Karte oder Tabelle angezeigt werden?
Ja. Aktivieren Sie die Ergebnisansicht und ordnen Sie die Antwort einer Karte, einem Formular oder einer Tabelle zu. Kanäle, die diese nicht anzeigen können, etwa WhatsApp, erhalten denselben Inhalt als Text.
Kann eine Aktion auf meiner Seite statt auf einem Server laufen?
Ja. Der Typ „Client“ übergibt den Aufruf an einen Handler, den Sie über das Widget-SDK auf Ihrer Seite registrieren. Er wird nur im Website-Widget angeboten.
Wo sehe ich, was aufgerufen wurde?
Jede eigene Aktion führt Ausführungsprotokolle mit Status, Eingaben, Ausgaben und Dauer jedes Aufrufs.

Passende Dokumentation

Jetzt starten

Setzen Sie die Schritte in die Praxis um

Kostenlos starten, keine Kreditkarte erforderlich.