Tools

Was sind Tools?

Tools sind die Aktionen, die dein KI-Agent während eines Gesprächs ausführen kann. Während Rules festlegen, wie der Agent sich verhält, bestimmen Tools, was er tun kann — deinen Produktkatalog durchsuchen, Produktkarten anzeigen, bestimmte Informationen abrufen oder einen konfigurierten Workflow auslösen.

Wenn ein Besucher eine Nachricht sendet, entscheidet der Agent in Echtzeit, welche Tools relevant sind, und ruft sie bei Bedarf auf. Die Ergebnisse fließen dann in die Antwort des Agenten ein. Für den Besucher wirkt es wie ein natürliches Gespräch — im Hintergrund arbeitet der Agent mit deinen Tools, um die richtigen Informationen bereitzustellen.

Tool erstellen

Öffne Tools in der linken Seitenleiste. Klicke rechts oben auf Neues Tool.

Du wirst nach einem Namen und einem Tool-Typ gefragt. Nach der Bestätigung wird das Tool angelegt und du landest direkt auf der Detailseite, wo du alles weitere konfigurieren kannst.

Name festlegen

Der Name ist intern — deine Besucher sehen ihn nicht direkt. Wähle etwas, das die Funktion des Tools klar beschreibt, zum Beispiel Produktsuche, Bestellstatus abfragen oder Größentabelle.

Der Name wird auch verwendet, um den Handle des Tools zu generieren — einen URL-freundlichen Bezeichner, der intern genutzt wird. Den Handle siehst du auf der Detailseite.

Tool-Typ wählen

Der Tool-Typ bestimmt die grundlegende Funktion des Tools. Jeder Typ hat eigene Konfigurationsoptionen. Wähle den Typ, der zu dem passt, was das Tool leisten soll.

Der Typ wird beim Anlegen festgelegt und kann danach nicht mehr geändert werden. Wenn du einen anderen Typ benötigst, lege ein neues Tool an.

Tool aktivieren oder deaktivieren

Jedes Tool hat einen Aktiviert-Schalter. Wenn ein Tool deaktiviert ist, ruft der Agent es nicht auf — auch wenn der Gesprächskontext es normalerweise auslösen würde.

Das ist nützlich, um:

Ein Tool vorübergehend zu deaktivieren, während du es neu konfigurierst
Saisonale Tools außerhalb des relevanten Zeitraums abzuschalten
Dein Setup zu testen, indem du Tools einzeln deaktivierst

Das Deaktivieren löscht weder das Tool noch seine Konfiguration. Wenn du es wieder aktivierst, greift das bisherige Verhalten sofort.

Tool konfigurieren

When to use

Das Feld When to use teilt dem Agenten in natürlicher Sprache mit, wann er dieses Tool aufrufen soll. Schreibe es als einfache Anweisung:

Wenn ein Kunde nach einem bestimmten Produkt fragt oder sehen möchte, was verfügbar ist
Wenn der Nutzer seinen Bestellstatus oder Lieferfortschritt prüfen möchte
Wenn jemand nach Größeninformationen oder einem Vergleich zwischen Varianten fragt

Der Agent liest diesen Text während des Gesprächs und entscheidet anhand davon, ob das Aufrufen des Tools bei der aktuellen Frage hilfreich wäre.

Die Sidebar-Bezeichnung ist der Name, der Besuchern angezeigt wird, wenn das Tool ein Seitenleisten-Panel öffnet — bei Tools, die Ergebnisse neben dem Chat statt inline anzeigen. Halte sie kurz und prägnant, zum Beispiel Produkte, Bestelldetails oder Ergebnisse.

Wenn das Tool keine Seitenleiste verwendet, hat dieses Feld keine sichtbare Auswirkung.

Einleitungstext

Der Einleitungstext erscheint oben im Seitenleisten-Panel, wenn es sich öffnet, und gibt dem Besucher Kontext dafür, was er sieht. Nutze ihn, um Erwartungen zu setzen:

Hier sind die Produkte, die zu deiner Frage passen.
Deine Bestelldetails siehst du unten.

Halte ihn kurz — ein bis zwei Sätze reichen.

Config

Das Config-Feld enthält toolspezifische Einstellungen als JSON-Objekt. Was hier eingetragen wird, hängt vom Tool-Typ ab. Ein Produktsuche-Tool könnte beispielsweise Filter oder Ergebnislimits akzeptieren; ein benutzerdefiniertes Tool könnte Endpoint-Konfiguration enthalten.

Die spezifischen Schlüssel und Werte deines Tool-Typs findest du in der Tool-Typ-Referenz.

Tools mit Produkten und Rules verknüpfen

Tools können mit anderen Features in deinem Account verbunden werden.

Produkt-Verknüpfungen ordnen das Tool bestimmten Produkten aus deinem Katalog zu. Das ist nützlich, wenn ein Tool nur Ergebnisse für eine Teilmenge von Produkten liefern soll oder wenn Regeln, die mit diesen Produkten verknüpft sind, aktiviert werden sollen, sobald das Tool läuft.

Rule-Verknüpfungen verbinden das Tool mit bestimmten Rules. Wenn das Tool aufgerufen wird, werden alle damit verknüpften On-Demand-Rules automatisch in den Kontext des Agenten geladen. So kannst du Verhaltensanweisungen anhängen, die nur relevant sind, wenn dieses Tool aktiv ist.

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

Einstellungen

| Einstellung | Beschreibung | |---|---| | Name | Interner Name des Tools | | Tool-Typ | Die Art der Funktion, die dieses Tool bereitstellt | | Handle | Automatisch generierter URL-freundlicher Bezeichner | | Aktiviert | Ob der Agent dieses Tool aufrufen kann | | When to use | Anweisung in natürlicher Sprache, wann der Agent das Tool aufrufen soll | | Sidebar-Bezeichnung | Beschriftung im Seitenleisten-Panel dieses Tools | | Einleitungstext | Kurzer Text oben im Seitenleisten-Panel | | Config | Toolspezifische Konfiguration als JSON-Objekt | | Produkt-Verknüpfungen | Produkte, die diesem Tool zugeordnet sind | | Rule-Verknüpfungen | Rules, die aktiviert werden, wenn dieses Tool aufgerufen wird |

Tools verwalten

Suchen

Die Tools-Liste zeigt alle Tools in deinem Account. Mit dem Suchfeld oben kannst du nach Name filtern. Das hilft dir, Tools schnell zu finden, wenn du ein größeres Setup mit mehreren Tools für verschiedene Zwecke hast.

Tool bearbeiten

Klicke in der Liste auf ein Tool, 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 — der Agent nutzt die aktualisierte Konfiguration ab dem nächsten Gespräch.

Tool löschen

Öffne die Detailseite des Tools und nutze die Lösch-Option. Das Löschen ist endgültig und entfernt alle Produkt- und Rule-Verknüpfungen des Tools.

Bevor du ein aktiv genutztes Tool löschst, deaktiviere es zunächst, um die Auswirkung zu prüfen. Wenn das Deaktivieren keine Probleme verursacht, ist das Löschen sicher.

FAQ

Kann ein Tool mit mehreren Produkten verknüpft werden? Ja. Du kannst ein Tool mit beliebig vielen Produkten verknüpfen. Die Verknüpfungen legen fest, welche Produkte in den Scope fallen, wenn das Tool läuft, und bestimmen, welche produktspezifischen Rules aktiviert werden.

Was passiert, wenn ein Tool aktiviert ist, aber kein When-to-use-Feld ausgefüllt wurde? Der Agent weiß nicht, wann er das Tool aufrufen soll. Fülle das When-to-use-Feld immer aus — damit entscheidet der Agent, welche Tools für eine Frage relevant sind.

Kann ich denselben Tool-Typ mehrfach verwenden? Ja. Du kannst mehrere Tools desselben Typs mit unterschiedlichen Konfigurationen anlegen. Zum Beispiel zwei Produktsuche-Tools für verschiedene Produktkategorien, jedes mit eigener When-to-use-Anweisung.

Hat das Deaktivieren eines Tools Auswirkungen auf verknüpfte Rules? Die Rules selbst bleiben unverändert. Wenn eine Rule mit einem deaktivierten Tool verknüpft und auf On Demand gestellt ist, wird sie schlicht nicht ausgelöst — weil das Tool nie läuft. Always-Rules sind vom Tool-Status nicht betroffen.