Aktionen

Legen Sie fest, was Ihr KI‑Agent während eines Gesprächs tun kann: von Antworten mit Echtzeit‑API‑Daten über Lead‑Erfassung bis hin zu individuellen Aufgaben.

Quickchat AI Agenten kennen zwei Arten von Aktionen.

Quickchat AI Actions sind integriert, Sie schalten sie nur ein und konfigurieren sie:

• Human Handoff übergibt das Gespräch an einen Menschen.
• Intelligente Datenerfassung erfasst Leads und weitere Daten im Chat.

Benutzerdefinierte Aktionen greifen über Quickchat AI hinaus:

• API-Aktionen rufen einen beliebigen HTTP-Endpunkt auf. Sie werden auf dieser Seite beschrieben.
• MCP-Aktionen verbinden einen kompletten MCP-Server auf einmal.
• Google Sheets ist ein Shortcut, der mit einem Klick eine Logging-Aktion für Sie einrichtet.

Jede Aktion kann über AI Action Variables auf Live-Daten aus dem Gespräch zugreifen, und das Jira-Beispiel baut eine Aktion von Anfang bis Ende auf.

Individuelle Aktionen

Mit individuellen Aktionen kann Ihre KI externe APIs während des Gesprächs aufrufen. Nutzen Sie sie, um interne Tools zu durchsuchen, Tickets zu erstellen, Alerts auszulösen oder frische Daten zu holen, die nicht in der Wissensdatenbank stehen. Sie finden sie unter Actions & MCPs → Custom Actions.

So funktionieren individuelle Aktionen

1. Wählen Sie einen Aktionstyp: API-Aktion, MCP, HubSpot-Aktion, Discord-Aktion, Google Sheets oder Shopify MCP. Konfigurieren Sie die Verbindung und die Anweisungen, die die AI benötigt.
2. Während eines Chats entscheidet die AI normalerweise anhand der Aktionsbeschreibung und der verfügbaren Tool- oder Parameterdetails, wann sie die Aktion ausführt. Eine API-Aktion kann stattdessen so eingestellt werden, dass sie automatisch vor der ersten Antwort ausgeführt wird.
3. Quickchat führt den Aufruf aus und gibt das Ergebnis an die KI zurück. Die KI liest die Antwort und antwortet dem Nutzer in natürlicher Sprache.
4. Testen oder verbinden Sie die Aktion in ihrem Editor, bevor Sie sie in Gesprächen verwenden.

Tipp

Schreiben Sie die Beschreibung als Anweisung an die KI: wann nutzen, was kommt zurück, welche Leitplanken gelten.

API‑Aktion erstellen

1. Gehen Sie zu Actions & MCPs.
2. Klicken Sie bei Custom Actions auf + und wählen API Action.
3. Füllen Sie Details:
   • Name: klar und prägnant
   • Description: wann nutzen, was in Parameter
4. Wählen Sie unter Ausführungszeitpunkt zwischen AI entscheidet und Vor der ersten Antwort.
5. Konfigurieren Sie Connection:
   • Action Type: GET oder POST
   • Action endpoint URL: vollständige API‑URL
   • Headers: erforderliche Headers (Authorization, content-type: application/json, …)
6. Definieren Sie Parameters: je Parameter name, location (query, body oder header) und description mit Hinweisen zur Wertbildung für die KI. Pfadwerte sind keine Parameter‑Location; fügen Sie sie direkt per {{platzhalter}}‑Templating in die Endpoint‑URL ein.
7. Test request, Antwort prüfen, Done.

Tipp

Jedes Wertefeld (URL, Header, Body oder Query) akzeptiert dynamische Platzhalter über die Schaltfläche + Add AI Data. Sie können Ihre KI‑Parameter, eingebaute Konversationsvariablen ({{scenario_id}}, {{language}}, {{country}}, …) und Konversations‑Metadaten ({{metadata_*}}) einfügen. Die vollständige Referenz finden Sie unter KI‑Aktions‑Variablen.

Über die Anfrage selbst hinaus hat eine API‑Aktion drei optionale Einstellungen, die man kennen sollte: Save to memory, Run only when und Response filter.

Ausführungszeitpunkt einer API-Aktion wählen

Unter Ausführungszeitpunkt stehen zwei Modi zur Auswahl:

• AI entscheidet: Dies ist die Standardeinstellung. Die AI liest die Aktionsbeschreibung und entscheidet, ob für die Anfrage des Besuchers die Aktion benötigt wird. Verwenden Sie diesen Modus, wenn die Aktion nur bei bestimmten Fragen oder erst ausgeführt werden soll, nachdem die AI Informationen vom Besucher gesammelt hat.
• Vor der ersten Antwort: Quickchat führt die Aktion einmal aus, nachdem der Besucher die erste Nachricht gesendet hat und bevor die AI ihre erste Antwort verfasst. Die normale AI-Antwort erhält die Response und alle mit Save to memory gespeicherten Werte. Die AI kann diese Aktion nicht mehr selbst als Tool auswählen; sie läuft daher nur im ersten Turn und nicht erneut später im Gespräch. Verwenden Sie diesen Modus für die Kundenidentifizierung, den Account-Kontext, Berechtigungsprüfungen oder andere Vorbereitungen, die jede echte Konversation benötigt.

Vor der ersten Antwort bezieht sich auf die erste Nachricht des Besuchers, nicht auf die Erstellung der Konversation. Das Öffnen eines Chats oder der Empfang einer Begrüßungsnachricht löst die Aktion nicht aus. Daher wird für abgebrochene Chats kein Request gesendet. Quickchat zeichnet die Ausführung auf, bevor der Endpoint aufgerufen wird. Sie wird in derselben Konversation nicht erneut versucht, auch wenn der Request fehlschlägt oder das Ergebnis unklar ist.

Die erste Antwort wartet auf den Request, daher kann dieser Modus die Antwortzeit verlängern. Wenn mehrere Aktionen diesen Modus verwenden, werden sie nacheinander ausgeführt und ihre Request-Zeiten summieren sich. Wenn erforderliche Metadaten fehlen, der Endpoint nicht verfügbar ist oder ein Request fehlschlägt, antwortet die AI trotzdem. Öffnen Sie bei der Aktion das Request-Log, um zu sehen, was passiert ist.

Da die Aktion ausgeführt wird, bevor die AI Parameterwerte auswählen kann, muss jeder verwendete AI-Parameter einen Standardwert haben. Metadaten und eingebaute Variablen können direkt in URL, Header, Query oder Body eingefügt werden.

Identifizierung per E-Mail oder Telefonnummer

Für Kanäle, die entweder eine E-Mail-Adresse oder eine Telefonnummer bereitstellen können, erstellen Sie für jede Kennung eine eigene Lookup-Aktion. Stellen Sie beide auf Vor der ersten Antwort und fügen Sie jeweils unter Run only when eine passende Bedingung wie visitor_email exists oder visitor_phone_number exists hinzu. Quickchat sendet nur den Request, dessen Metadaten vorhanden sind.

Discord-Aktionen

Discord-Aktion öffnet eine Galerie mit vorausgefüllten, bearbeitbaren API-Actions:

• Support & Tickets: Bei Support-Ticket öffnen wählen Sie einen Server und einen Text-Channel aus. Optional können Sie eine mentionable Support-Rolle auswählen. Das Template erstellt drei Actions, die einen privaten Thread öffnen, den aktuellen Anfragenden hinzufügen und eine Zusammenfassung mit der optionalen Erwähnung der Rolle posten.
• Moderation: Mitglied timeouten, Mitglied kicken, Mitglied bannen, Bann aufheben, Rolle zuweisen, Slowmode festlegen und Ankündigung senden. Jedes Template wird mit einem Klick installiert und verwendet den Server, das Mitglied, die Rolle oder den Channel aus der aktuellen Discord-Anfrage.

Quickchat erstellt HTTP-Methode, URL, Header, Body, Parameter, Beschreibung, Response-Einstellungen und die Bedingungen unter Nur ausführen, wenn im Backend. Die resultierenden Karten sind gewöhnliche HTTP-Request-Actions. Sie können jedes Feld einsehen und bearbeiten.

Alle sieben Moderationstemplates enthalten unter Nur ausführen, wenn die Bedingung author_is_admin is true. Discord berechnet die Administrator-Berechtigung des aktuellen Absenders, das Discord-Gateway liefert diesen Wert und Quickchat prüft ihn vor dem Senden des Requests. Metadaten aus dem öffentlichen Chat oder der API können diesen Key nicht setzen. Testen Sie Moderationsaktionen in Discord sowohl mit einem Administrator- als auch mit einem Nicht-Administrator-Konto. AI Preview stellt keinen autorisierten Discord-Absender bereit.

Achtung

Die Moderationsaktionen sind bearbeitbar. Wenn Sie die Bedingung author_is_admin is true entfernen oder abschwächen, entfällt die mitgelieferte Autorisierungsgrenze. Kick und Bann verlangen vor der Ausführung keine Bestätigung.

Der Bot selbst benötigt weiterhin die für jeden Request erforderliche Discord-Berechtigung:

Aktion	Bot-Berechtigung oder Zugriff
Mitglied timeouten	Moderate Members
Mitglied kicken	Kick Members
Mitglied bannen, Bann aufheben	Ban Members
Rolle zuweisen	Manage Roles
Slowmode festlegen	Manage Channels
Ankündigung senden	View Channels und Send Messages

Discord erzwingt außerdem die Rollenhierarchie. Platzieren Sie die Rolle des Bots über den Mitgliedern und Rollen, die er verwalten soll. Das Template führt keine zusätzliche Hierarchieprüfung oder Prüfung einzelner Berechtigungen für den anfragenden Administrator durch.

Slowmode festlegen und Ankündigung senden akzeptieren eine Channel-ID als Parameter. Ohne ein zusätzliches festes Ziel prüft das Template nicht, ob der Channel zu dem Server gehört, auf dem der Administrator den Request gesendet hat. Wenn derselbe Bot mehreren Servern angehört, bearbeiten Sie diese Actions so, dass sie eine feste Channel-ID verwenden, oder trennen Sie die Server durch unterschiedliche Agents und Bot-Zugangsdaten.

Die Support-Ticket-Installation verwendet vorhandene Action-Funktionen zur Datenübergabe:

1. open_support_ticket erstellt einen privaten Thread im ausgewählten Channel, erfasst $.id und speichert den Wert im Konversations-Memory als discord_ticket_thread_id. Die Action erfordert die sichtbare Bedingung discord_message is true, läuft nur im ausgewählten Server und nur, solange dieser Memory-Key nicht vorhanden ist.
2. add_ticket_requester liest {{metadata_discord_ticket_thread_id}} und die von Discord bereitgestellte Variable {{metadata_discord_author_id}}. Die Action erfordert die sichtbare Bedingung discord_message is true und läuft nur im ausgewählten Server, nachdem die Thread-ID vorhanden ist.
3. post_in_ticket liest dieselbe gespeicherte Thread-ID, postet die vom Agenten erstellte einzeilige Zusammenfassung des Problems und erwähnt den Anfragenden. Wenn Sie eine Support-Rolle ausgewählt haben, wird auch diese Rolle erwähnt. Für die Action gelten dieselben sichtbaren Bedingungen für Discord-Nachricht, Server und gespeicherten Thread. Der Discord-Body allowed_mentions ist auf den Anfragenden und, sofern konfiguriert, diese Rolle begrenzt.

Die Beschreibungen und Ihr Agent-Prompt sollten den Agenten anweisen, diese Actions in dieser Reihenfolge auszuführen. Es gibt keine separate Ebene für Workflow-Status, Sperren, Bestätigungen, Wiederholungen, Wiederherstellung, Abgleich oder Replay-Schutz. Wenn ein Ergebnis unklar ist, prüfen Sie Discord und das Action-Log vor einem erneuten Versuch, da Discord den Request möglicherweise bereits ausgeführt hat.

discord_ticket_thread_id wird nicht automatisch gelöscht. Die Vorlage unterstützt daher ein Ticket pro Quickchat-Konversation. Starten Sie für ein weiteres Ticket eine neue Discord-Konversation oder einen neuen Thread, oder bearbeiten Sie die Actions und ergänzen Sie den benötigten Memory-Lebenszyklus.

Gewähren Sie dem Bot für Support-Tickets im ausgewählten Ticket-Channel View Channels, Send Messages, Read Message History, Create Private Threads, Send Messages in Threads und Manage Threads. Lassen Sie Rolle benachrichtigen (optional) auf Keine Rolle benachrichtigen, wenn keine Rolle erwähnt werden soll. Wenn Sie eine Rolle auswählen, muss sie mentionable sein und ihre Mitglieder benötigen Zugriff auf die privaten Threads. Wenn Sie keine Rolle auswählen oder keine mentionable Rollen verfügbar sind, werden Tickets dennoch normal geöffnet, ohne eine Rolle zu benachrichtigen. Die Galerie listet Text-Channels und mentionable Rollen auf, prüft aber nicht alle Berechtigungsüberschreibungen des Channels.

Achtung

Discord-Aktionen benötigen den Token aus Ihrer eigenen Discord-App unter Externe Apps → Discord → Erweitertes Setup. Der gemeinsame One-Click-Bot allein kann diesen Token nicht bereitstellen. Siehe Discord.

Die Galerie ist eine Abkürzung für die Einrichtung und keine zusätzliche Policy-Ebene. Wenn Sie eine generierte Action bearbeiten oder eine individuelle Discord API Action erstellen, prüfen Sie vor der Aktivierung ihre Zugangsdaten, Ziele, Parameter, Response-Offenlegung und Bedingungen unter Nur ausführen, wenn.

Save to memory

Erfassen Sie einen Wert aus der API‑Antwort und speichern Sie ihn im Gedächtnis der Konversation unter einem von Ihnen gewählten Schlüssel. Spätere Aktionen können ihn als {{metadata_<key>}} wiederverwenden, und er erscheint in den Konversationsdetails (Posteingang, API und Exporte).

Greifen Sie dazu, wenn eine Aktion etwas erzeugt, das eine spätere Aktion benötigt. Eine Lookup‑Aktion kann eine customer_id aus ihrer Antwort speichern; eine nachfolgende Aktion sendet dann {{metadata_customer_id}}, ohne dass die KI den Wert übertragen muss.

Geben Sie im Abschnitt Save to memory des API‑Aktions‑Editors dem erfassten Wert einen memory key und verweisen Sie auf den Teil der Antwort, den Sie behalten möchten. Von da an ist es eine Metadaten‑Variable wie jede andere.

Memory keys werden mit den Remote-MCP-Tools des Agents geteilt. Wenn ein MCP-Tool bereits unter demselben Schlüssel speichert, meldet das Feld memory key den Konflikt beim Speichern. Wählen Sie dann einen anderen Schlüssel.

Tipp

Verwenden Sie snake_case‑Schlüssel (Buchstaben, Ziffern, Unterstriche). Ein Schlüssel wie customer_id ist als {{metadata_customer_id}} referenzierbar; Schlüssel mit Leerzeichen oder anderer Interpunktion können nicht in Platzhaltern verwendet werden. Wie Metadaten‑Variablen funktionieren, erfahren Sie unter Konversations‑Metadaten.

Run only when

Beschränken Sie eine Aktion so, dass sie nur ausgeführt wird, wenn Bedingungen auf den Konversations‑Metadaten erfüllt sind. Die Bedingungen werden auf unserer Seite, zum Aufrufzeitpunkt geprüft, nachdem die KI entschieden hat, die Aktion aufzurufen, aber bevor eine Anfrage gesendet wird. Sie lassen sich daher nicht aus dem Chat heraus umgehen.

Dies ist das richtige Werkzeug für privilegierte oder unumkehrbare Aktionen (ein Mitglied sperren, eine Rückerstattung ausstellen, einen Datensatz löschen). Eine Zeile in Ihrem Prompt, die besagt „nur Admins dürfen das”, ist eine hilfreiche Anweisung, aber keine Sicherheitsgrenze: Ein entschlossener Nutzer kann mit dem Modell argumentieren oder eine Prompt‑Injection versuchen. Eine Ausführungsbedingung ist deterministisch und lebt außerhalb des Prompts, also gilt sie unabhängig davon, was im Gespräch gesagt wird.

• Die Ausführungsbedingung ist die Grenze. Sie wird serverseitig ausgewertet und ist nicht Teil des Prompts, den das Modell liest. Genau das verhindert tatsächlich die Ausführung der Aktion.
• Die Prompt‑Regel ist die Nutzererfahrung. Behalten Sie trotzdem eine Zeile in Ihrem Prompt, damit die KI höflich ablehnt und den Grund erklärt, statt einfach zu verstummen.

Fügen Sie Bedingungen im Abschnitt Run only when des Aktions‑Editors hinzu. Klicken Sie auf Add condition, wählen Sie einen Metadaten‑Schlüssel (zum Beispiel telegram_sender_is_admin) und legen Sie fest, wie verglichen werden soll:

Bedingung	Erfüllt, wenn der Metadaten‑Wert…
is true	wahrheitswertig (truthy) ist
is false	falschwertig (falsy) ist
exists	in der Konversation vorhanden ist
does not exist	fehlt
equals	einem von Ihnen angegebenen Wert entspricht
does not equal	von einem von Ihnen angegebenen Wert abweicht

Die Aktion wird nur ausgeführt, wenn jede Bedingung erfüllt ist. Eine Bedingung auf einen Schlüssel, der in der Konversation nicht gesetzt ist, ist nicht erfüllt.

Wenn eine Bedingung nicht erfüllt ist, wird keine Anfrage gesendet und die KI teilt dem Nutzer mit, dass sie das nicht tun kann. Unten wird dieselbe Sperranfrage für einen Nicht‑Admin blockiert und für einen Admin zugelassen, wobei sich nichts ändert außer der Person, die fragt:

Achtung

Knüpfen Sie Bedingungen nur an Metadaten, die Quickchat setzt (etwa ein kanalverifiziertes telegram_sender_is_admin‑Flag), nicht an Werte, die der Besucher beeinflussen kann. Woher jeder Schlüssel stammt, erfahren Sie unter Konversations‑Metadaten.

Response filter

Standardmäßig sieht die KI die vollständige API‑Antwort. Fügen Sie JSONPath‑Ausdrücke im Abschnitt Response filter hinzu, um die KI auf bestimmte Teile davon zu beschränken.

Zwei häufige Gründe zum Filtern:

• Sensible Felder ausblenden. Halten Sie Kunden‑E‑Mails, Zahlungsdaten oder interne IDs aus dem Kontext des Modells heraus, wenn der Endpoint mehr zurückgibt, als die KI benötigt.
• Den Prompt verkleinern. Gesprächige APIs können große Payloads zurückgeben; das Filtern auf die wenigen relevanten Felder hält die Antwort klein und die KI fokussiert.

Fügen Sie einen oder mehrere JSONPath‑Ausdrücke hinzu, und die KI erhält nur die übereinstimmenden Teile. Beispielsweise behält $.data.items[*].name nur die Artikelnamen aus einer größeren Antwort.

Tipp

Nutzen Sie das Test Response‑Panel, um vor dem Verlassen darauf genau zu sehen, was die KI nach dem Filtern erhält. Siehe Ihre Aktion testen.

Achtung

Ein JSONPath, der nichts findet, lässt die KI mit einer leeren Antwort zurück. Beginnen Sie ohne Filter, bestätigen Sie, dass der Aufruf funktioniert, und verengen Sie ihn dann.

Best Practices

• Explizit beschreiben: wann verwenden, wie Parameter zu befüllen sind.
• Scopes minimal halten: nur benötigte Header/Tokens aufnehmen.
• Vor Rollout testen: Statuscodes und Payloads prüfen.

Tutorials

• Jira‑Tickets in der Unterhaltung suchen
• Slack‑Benachrichtigung mit einer KI‑Aktion senden