Plugins

Was sind Plugins?

Plugins erweitern deinen KI-Agenten um Funktionen, die über die eingebauten Tools hinausgehen. Während Tools häufige Aufgaben wie Produktsuche und Informationsabruf übernehmen, verbinden Plugins den Agenten mit externen Diensten, ermöglichen den E-Mail-Versand oder legen fest, wie Produktkarten dargestellt werden.

Stell dir Plugins wie optionale Module vor, die du für deinen Account einschaltest. Jeder Plugin-Typ fügt eine eigene Funktion hinzu. Du konfigurierst das Plugin, aktivierst es — und der Agent verfügt über die neue Funktion, ohne dass du Code ändern musst.

Verfügbare Plugin-Typen

Email Service

Der Email-Service-Plugin ermöglicht es deinem KI-Agenten, während eines Gesprächs E-Mails zu versenden. Wenn ein Besucher eine Zusammenfassung anfordert, eine Bestätigung möchte oder Informationen in seinen Posteingang haben möchte, kann der Agent die E-Mail direkt verfassen und abschicken.

Du konfigurierst die Absenderdetails, E-Mail-Vorlagen und die Bedingungen, unter denen der Agent die E-Mail anbieten oder auslösen soll.

Custom API

Der Custom-API-Plugin verbindet deinen KI-Agenten mit einem externen API-Endpoint. So kann der Agent Daten aus deinen eigenen Systemen abrufen oder übermitteln — Lagerbestände prüfen, Kundendaten abfragen, Formulare einreichen oder andere individuelle Integrationen, die dein Unternehmen benötigt.

Das Plugin registriert die Endpoint-Details und stellt die Authentifizierung her. Der Agent ruft die API verzögert auf — nur wenn der Gesprächskontext es nahelegt — damit nicht jede Antwort mit unnötigem Overhead belastet wird.

Product Cards

Der Product-Cards-Plugin legt fest, wie der Agent Produkte visuell im Chat anzeigt. Statt reiner Textantworten werden Produkte als strukturierte Karten mit Bildern, Titeln, Preisen und Aktionsbuttons dargestellt.

Jeder Product-Cards-Plugin-Eintrag ist eine Vorlage, die das Kartenlayout und die angezeigten Produktdatenfelder definiert. Du kannst mehrere Vorlagen für verschiedene Kontexte anlegen — eine kompakte Karte für schnelle Vergleiche, eine detaillierte Karte für die Einzelproduktansicht.

Plugin aktivieren oder deaktivieren

Öffne Plugins in der linken Seitenleiste. Die Liste zeigt alle Plugins in deinem Account und ihren aktuellen Status.

Um ein Plugin zu aktivieren, öffne seine Detailseite und setze den Aktiviert-Schalter auf ein. Zum Deaktivieren schalte ihn aus. Die Änderung gilt sofort — der Agent nutzt (oder nutzt nicht) das Plugin ab dem nächsten Gespräch.

Das Deaktivieren löscht das Plugin nicht und setzt die Konfiguration nicht zurück. Du kannst es jederzeit wieder aktivieren.

Plugin konfigurieren

When to use

Das Feld When to use teilt dem Agenten in natürlicher Sprache mit, wann dieses Plugin aktiv sein oder ausgelöst werden soll. Schreibe es als einfache Anweisung:

Wenn ein Kunde darum bittet, Informationen per E-Mail zu erhalten
Wenn der Nutzer nach Lagerbestand oder aktuellen Preisen fragt
Wenn das Anzeigen von Produkten als visuelle Karten dem Kunden helfen würde, Optionen zu vergleichen

Der Agent nutzt diesen Text, um zu entscheiden, ob das Aufrufen des Plugins im aktuellen Gespräch sinnvoll ist.

Die Sidebar-Bezeichnung wird Besuchern angezeigt, wenn das Plugin ein Seitenleisten-Panel öffnet. Halte sie kurz und prägnant, zum Beispiel Per E-Mail senden, Live-Bestand oder Produktkarten.

Einleitungstext

Der Einleitungstext erscheint oben im Seitenleisten-Panel, wenn es sich öffnet. Nutze ihn, um dem Besucher kurz zu erklären, was er sieht oder was als nächstes passiert.

Wir senden das an deine E-Mail-Adresse.
Hier ist die aktuelle Verfügbarkeit aus unserem Lager.

Ein bis zwei Sätze reichen.

Pluginspezifische Config

Das Config-Feld enthält pluginspezifische Einstellungen als JSON-Objekt. Was hier akzeptiert wird, hängt vom Plugin-Typ ab:

Email Service — Absendername, Absenderadresse, Reply-To-Adresse, E-Mail-Vorlagen
Custom API — Endpoint-URL, Authentifizierungsmethode, Request-Header, Parameter-Mapping
Product Cards — Kartenlayout (Bildplatzierung, Elementreihenfolge), welche Produktfelder wie angezeigt werden

Eine vollständige Liste der unterstützten Konfigurationsschlüssel findest du in der Plugin-Typ-Referenz.

Plugins mit Produkten und Rules verknüpfen

Plugins können mit Produkten und Rules in deinem Account verbunden werden.

Produkt-Verknüpfungen ordnen das Plugin bestimmten Produkten zu. Bei einem Product-Cards-Plugin bestimmt das, für welche Produkte die Vorlage gilt. Bei anderen Plugin-Typen legen die Verknüpfungen fest, welche Produkte in den Scope fallen, wenn das Plugin ausgeführt wird.

Rule-Verknüpfungen verbinden das Plugin mit bestimmten Rules. On-Demand-Rules, die mit einem Plugin verknüpft sind, werden automatisch in den Kontext des Agenten geladen, sobald das Plugin ausgelöst wird. So kannst du Verhaltensanweisungen anhängen, die nur gelten, wenn dieses Plugin aktiv ist — zum Beispiel eine Rule über den Ton beim E-Mail-Versand oder den Umgang mit einem fehlgeschlagenen API-Aufruf.

Um Verknüpfungen zu verwalten, öffne die Detailseite des Plugins und nutze den entsprechenden Bereich.

Einstellungen

| Einstellung | Beschreibung | |---|---| | Name | Interner Name des Plugins | | Plugin-Typ | Email Service, Custom API oder Product Cards | | Handle | Automatisch generierter URL-freundlicher Bezeichner | | Aktiviert | Ob der Agent dieses Plugin nutzen kann | | When to use | Anweisung in natürlicher Sprache, wann der Agent das Plugin aktivieren soll | | Sidebar-Bezeichnung | Beschriftung im Seitenleisten-Panel dieses Plugins | | Einleitungstext | Kurzer Text oben im Seitenleisten-Panel | | Config | Pluginspezifische Konfiguration als JSON-Objekt | | Produkt-Verknüpfungen | Produkte, die diesem Plugin zugeordnet sind | | Rule-Verknüpfungen | Rules, die aktiviert werden, wenn dieses Plugin ausgelöst wird |

Plugins verwalten

Suchen

Die Plugins-Liste zeigt alle Plugins in deinem Account. Mit dem Suchfeld oben kannst du nach Name filtern. Das hilft dir, den Überblick zu behalten, wenn du mehrere Plugins verschiedener Typen konfiguriert hast.

Plugin bearbeiten

Klicke in der Liste auf ein Plugin, um die Detailseite zu öffnen. Dort kannst du Name, Aktivierungsstatus, When-to-use-Anweisung, Sidebar-Bezeichnung, Einleitungstext und Config aktualisieren. Außerdem kannst du Produkt- und Rule-Verknüpfungen verwalten.

Speichere deine Änderungen mit dem Speichern-Button. Änderungen greifen sofort ab dem nächsten Gespräch.

Plugin löschen

Öffne die Detailseite des Plugins und nutze die Lösch-Option. Das Löschen ist endgültig. Alle Produkt- und Rule-Verknüpfungen des Plugins werden dabei ebenfalls entfernt.

Bei Product-Cards-Plugins wird durch das Löschen die Kartenvorlage vollständig entfernt. Gespräche, in denen der Agent diese Vorlage genutzt hätte, fallen auf die nächste verfügbare Vorlage zurück — oder auf reinen Text, wenn keine andere greift.

FAQ

Kann ich mehrere Plugins desselben Typs anlegen? Ja. Du kannst mehrere Plugins desselben Typs mit unterschiedlichen Konfigurationen anlegen. Ein typisches Muster sind mehrere Product-Cards-Plugins — eines pro Produktkategorie oder Anzeigekontext — jeweils mit eigenem Layout und verknüpften Produkten.

Was ist der Unterschied zwischen einem Tool und einem Plugin? Tools sind eingebaute Agentenfunktionen, die immer zur Konfiguration bereitstehen. Plugins sind optionale Erweiterungen — sie fügen Funktionen hinzu, die der Agent von Haus aus nicht hat, wie E-Mail-Versand oder Verbindung zu externen APIs. Beide werden ähnlich konfiguriert, aber Plugins erfordern eine explizite Aktivierung.

Unterstützt der Custom-API-Plugin Authentifizierung? Ja. Die Plugin-Config akzeptiert Authentifizierungsdetails. Die unterstützten Authentifizierungsmethoden und die Strukturierung der Zugangsdaten im Config-JSON findest du in der Custom-API-Konfigurationsreferenz.

Wie werden Produkte angezeigt, wenn ich einen Product-Cards-Plugin deaktiviere? Der Agent fällt auf eine textbasierte Beschreibung zurück. Wenn andere Product-Cards-Plugins mit überschneidenden Produkt-Verknüpfungen aktiv sind, kann stattdessen eine dieser Vorlagen genutzt werden. Wenn alle Product-Cards-Plugins deaktiviert sind, werden Produkte ausschließlich im Klartext beschrieben.