KI Agenten
      Zurück zur Startseite
      1. moinAI Help Center
      2. KI Agenten & Themen
      3. KI Agenten

      Wie wird eine KI Aktion im Hub eingerichtet?

      Was sind KI Aktionen und wie werden sie hinzugefügt, konfiguriert und verwaltet, inklusive Praxisbeispielen und Best Practices.

      Was sind KI Aktionen?

      KI Aktionen stellen erweiterbare Funktions‑Bausteine eines KI Agenten dar. Sie ermöglichen es, den Chatbot gezielt externe Prozesse ausführen zu lassen, von einer Webhook‑Abfrage bis hin zu einer einfachen Weiterleitung (Follow‑Up). Auf diese Weise wird der Agent nahtlos mit Datenquellen, Back‑Office‑Systemen oder Shop‑APIs verbunden.

      Kurz gesagt: Eine KI Aktion ist ein benannter Schritt, der bei Bedarf ausgeführt wird, um gezielt Informationen abzurufen oder Nutzende weiterzuführen.

      Gründe für den Einsatz von KI Aktionen

      • Flexibilität – Beliebige REST‑Webhooks oder interne Endpunkte können ohne Code‑Änderung im Bot integriert werden.

      • Kontextbezug – Parameter aus der laufenden Unterhaltung (z. B. die letzte Nutzerfrage) lassen sich in die Action übernehmen.

      • Nutzerservice – Self‑Service‑Funktionen wie Bestellstatus, Terminbuchung oder Produkt‑Suche werden unmittelbar bereitgestellt.

      • Geführte Dialoge – Durch Follow‑Ups werden Nutzende kontextsensitiv zu Formularen oder Themen geleitet.

      Typen von KI Aktionen

      Typ Beschreibung Typische Anwendungsfälle
      Webhook Aktion Ein vordefinierter Webhook wird aufgerufen und die Antwort verarbeitet. Verfügbarkeits‑Abfragen, CRM‑Lookup, Shop‑Suche, Ticket‑Anlage
      Follow‑Up Aktion Eine Folgefrage wird gestellt und es erfolgt eine Übergabe an ein Formular/Thema. „Möchtest du deine Adresse ändern?“, Übergang zum Formular: Daten ändern. 

      Weitere Aktionstypen befinden sich in Planung.

      Vertragsabhängige Limits

      Die Gesamtzahl der verfügbaren KI Aktionen variiert je nach Paket.

      KI Aktionen im Hub anlegen

      1. Navigation

      Knowledge Base → Aktionen

      2. Neue Aktion erstellen

      1. ➕ Neue Aktion auswählen.

      2. Ein Aktionsname wird festgelegt (z. B. Seminarverfügbarkeit prüfen).

      3. Unter Tool auswählen wird der zuvor konfigurierte Webhook oder Follow‑Up bestimmt.

      4. Eine Toolbeschreibung wird hinterlegt – sie unterstützt die KI dabei, zu entscheiden, wann die Aktion sinnvoll ist.

      5. (Optional) Anweisungen vorher/nachher werden ausgefüllt, um das Antwort‑Verhalten des Bots zu steuern.

      6. Speichern wird betätigt, um die Aktion zu speichern.

      3. Parameter definieren (nur Webhook)

      Unter Parameter werden Eingaben konfiguriert, die an den Webhook übermittelt werden:

      Feld Erklärung
      Name Interner Bezeichner, der auch im Payload‑Body erscheint (z. B. ID).
      Typ Datentyp (Text, Zahl, Bool).
      Beschreibung Beschreibt, welche Information vom Nutzenden geliefert werden muss.

      Parameter können jederzeit hinzugefügt oder entfernt werden.

      4. Testen & Veröffentlichen

      • Der Staging‑Modus dient zur Validierung der Funktion in der Preview und im Playground.

      • Nach dem Veröffentlichen ist die Aktion im Live System verfügbar und aktiv.

      KI Aktionen verwalten

      Aktion Vorgehen
      Bearbeiten In der Liste Bearbeiten auswählen → Felder anpassen → Speichern betätigen.
      Löschen Löschen auswählen → Sicherheitsabfrage bestätigen.
      Staging ↔ Live Veröffentlichen des KI Agenten oder den gesamten Bot veröffentlichen.

      Hinweis: Gelöschte Aktionen können nicht wiederhergestellt werden.

      Praxisbeispiele

      1. Seminarverfügbarkeit prüfen (Webhook)

      • Beschreibung: Es wird zurückgegeben, ob für ein Seminar noch Plätze frei sind.

      • Webhook‑Pfad: GET /verfügbarkeit?seminar=

      • Vorher‑Anweisung: „Die Verfügbarkeit wird geprüft – dies kann bis zu 20 Sekunden dauern.“

      • Nachher‑Anweisung: „Es sind noch X Plätze frei.“ / „Leider ausgebucht.“ / „Nur noch wenige Plätze verfügbar.“

      • Parameter: ID (Zahl) – Seminar‑ID.

      2. Shopify‑Produktsuche (Webhook)

      • Beschreibung: Der Shopify‑Katalog wird über products(query) durchsucht.

      • Beispiel‑Queries:

        • title:*vans*

        • tag:'kid'

        • price:>50 AND price:<100

      • Prompt‑Build: Die Nutzeranfrage wird analysiert, Titel/Stichwörter werden extrahiert und zu einer Query zusammengesetzt (z. B. „Ich suche den x100 Damenschuh“ → title:*x100* AND tag:'woman').

      3. Follow‑Up: Adressänderung

      • Frage: „Möchtest du jetzt deine Adresse ändern?“

      • Aktion: Das Formular Daten ändern wird im nächsten Schritt geöffnet.

      Best Practices

      1. Beschreibungen präzise halten – je klarer der Zweck, desto zuverlässiger wird die Aktion aufgerufen.

      2. Parameter sauber benennen – keine Leer‑ oder Sonderzeichen; SCREAMING_SNAKE_CASE verwenden.

      3. Vorher‑Anweisung für lange Webhooks – vermeidet Ungeduld bei Nutzenden.

      4. Versionskontrolle – Änderungen stets zuerst in Staging testen.

      FAQ

      Wie lässt sich erkennen, dass eine Aktion ausgelöst wurde?
      → Teste das Verhalten zunächst im Playground, hier wird im Detail angezeigt ob und wie eine KI Aktion ausgeführt wurde.

      Können mehrere Aktionen in einer Antwort kombiniert werden?
      → Nein, zur Zeit ist die Ausführung auf eine Aktion begrenzt, Dies wird aber in Zukunft möglich sein.