Konversationstool
Erstellen Sie ein Tool, das die KI während Gesprächen verwenden kann. Die KI entscheidet basierend auf dem Kontext, wann sie es aufruft.
Wann zu verwenden
Verwenden Sie diesen Trigger, um zu erweitern, was Ihre KI tun kann:
- Produkte in Ihrem Katalog suchen
- Bestellstatus in Ihrem System überprüfen
- Kundendaten im CRM nachschlagen
- Support-Tickets in JIRA erstellen
- Termine buchen
- Jede benutzerdefinierte Fähigkeit
Konfiguration
Grundlegende Einstellungen
| Feld | Beschreibung |
|---|---|
| Tool-Name | Menschlich lesbarer Name (im Node-Bibliothek angezeigt) |
| Beschreibung | Erklärt, wann/wie die KI dieses Tool verwenden sollte |
Benutzerzielgruppen
Wählen Sie aus, wer dieses Tool verwenden kann:
| Option | Beschreibung |
|---|---|
| Alle Benutzer | Anonyme + verbundene Benutzer |
| Nur verbundene Benutzer | Nur angemeldete Benutzer |
| Rollenbasierter Zugriff | Bestimmte Benutzerrollen |
Tool-Variablen
Definieren Sie Parameter, die die KI vom Benutzer sammeln muss:
| Feld | Beschreibung |
|---|---|
| Variablenname | Interner Name (z. B. query, orderId) |
| Beschreibung | Hilft der KI zu verstehen, wonach gefragt werden soll |
Variablen werden in Ihrem Flow als {{variableName}} verfügbar.
So funktioniert es
- Sie definieren ein Tool mit Name, Beschreibung und Variablen
- Die KI lernt, wann sie es aus Ihrer Beschreibung verwenden soll
- Der Benutzer fragt etwas dazu (z. B. "Finde mir einen Laptop")
- Die KI sammelt erforderliche Variablen im Gespräch
- Der Flow läuft mit den gesammelten Daten
- Das Ergebnis wird an die KI für die endgültige Antwort zurückgegeben
Benennung Ihrer Tools: Warum es wichtig ist
Wenn Ihr KI-Assistent Zugriff auf mehrere Tools hat, wählt er aus, welches er aufrufen möchte, basierend auf nur drei Dingen: dem Tool-Namen, der Tool-Beschreibung und den Variablenbeschreibungen. Er kann nicht sehen, was im Flow enthalten ist — er liest den Text und entscheidet.
Wenn diese drei Felder vage oder zu ähnlich sind, wird die KI das falsche Tool auswählen. Studien zum Funktionsaufruf von LLM zeigen, dass die Verbesserung der Klarheit der Beschreibung allein die korrekte Tool-Auswahl um 15–20 Prozentpunkte erhöhen kann, ohne das zugrunde liegende Modell zu ändern.
Dies ist besonders kritisch, wenn Sie mehrere Tools haben, die verschiedene Wissensdatenbanken durchsuchen — aus der Perspektive der KI "suchen" sie alle nach Informationen. Der Name und die Beschreibung sind der einzige Weg, wie sie sich unterscheiden können.
Tool-Name
Verwenden Sie das Muster domain_action_target, damit der Name allein jedes Tool unterscheidet:
| ❌ Vage | ✅ Klar |
|---|---|
Search | rgpd_legal_analysis |
search_docs | ecommerce_product_search |
Tool 2 | support_ticket_lookup |
Die KI verwendet den Namen als ersten Filter, bevor sie die Beschreibung liest. Ein klarer Name ermöglicht es ihr, sofort eine Vorauswahl zu treffen; ein generischer Name zwingt sie zu raten.
Tool-Beschreibung
Die Beschreibung ist Ihr stärkstes Werkzeug. Verwenden Sie diese Formel:
[Was es tut — 1 Satz]
Verwenden für: [3–5 konkrete Anwendungsfälle mit den Wörtern, die Ihre Benutzer tatsächlich verwenden würden]
❌ Schlecht:
Durchsuchen Sie die Wissensdatenbank nach Informationen.
✅ Gut:
Durchsucht CNIL-Sanktionen und CJUE-Rechtsprechung.
Verwenden für: Finden von Strafentscheidungen nach Sektor oder Verstoßart,
Nachschlagen von Geldbußen, Zitieren von Rechtsvorschriften,
Bewertung des finanziellen Risikos von RGPD-Nichtkonformität.
Die Wörter innerhalb von "Verwenden für" wirken als semantische Trigger. Wenn die Nachricht eines Benutzers "Geldbuße", "Strafe" oder "Risiko" enthält, ordnet die KI dies sofort diesem Tool zu.
Variablenbeschreibungen
Eine als "Die Suchanfrage" beschriebene Variable sagt der KI nichts. Sie wird jedes Mal die rohe Frage des Benutzers einfügen. Eine bessere Beschreibung leitet die KI an, die richtigen Schlüsselwörter zu extrahieren, bevor sie sie sendet.
| ❌ Vage | ✅ Klar |
|---|---|
Die Suchanfrage | Suchanfrage: Verstoßart, Firmenname, Sektor, Geldbuße oder rechtliches Konzept |
Benutzereingabe | Angeforderten Dokumenttyp: Vorlage, Modell, Formular, Klausel oder Vertrag |
Dies zwingt die KI, umzuformulieren, anstatt die gesamte Nachricht des Benutzers zu kopieren — was zu gezielteren Suchen und besseren Ergebnissen führt.
Vermeidung von Tool-Konflikten
Wenn zwei Tools dieselbe Frage beantworten können, zögert die KI — und wählt manchmal zufällig. Jedes Tool muss ein exklusives Territorium abdecken.
Die Regel: Wenn Sie an eine Benutzerfrage denken können, die an entweder Tool gerichtet werden könnte, benötigen Ihre Beschreibungen mehr Präzision.
Beispiel — 5 Compliance-Tools mit klaren Grenzen:
| Tool | Deckt ab | Deckt NICHT ab |
|---|---|---|
compliance_legal_analysis | Gesetzesartikel, rechtliche Verpflichtungen, Rechte | Keine praktischen Ratschläge, keine realen Fälle |
compliance_methodology | Schritt-für-Schritt-Anleitungen, Prüfverfahren, Rahmenwerke | Kein rechtlicher Text, keine Vorlagen |
compliance_document_templates | Fertige Modelle, Formulare, Vertragsklauseln | Keine Methodologie, keine rechtliche Analyse |
compliance_business_processes | Operative Workflows, Genehmigungsschleifen | Kein rechtlicher Text, nur interne Prozesse |
compliance_operational_solutions | Konkrete Lösungen, technische Empfehlungen | Keine Theorie, nur umsetzbare Lösungen |
Je spezifischer jede Beschreibung darüber ist, was das Tool abdeckt, desto weniger Mehrdeutigkeit gibt es. Sie müssen keine expliziten Ausschlüsse schreiben — Präzision erledigt die Arbeit.
Schnellcheckliste
Überprüfen Sie vor der Veröffentlichung eines Flows mit einem Konversationstool-Trigger:
- Name folgt
domain_action_target— unterscheidbar, ohne die Beschreibung zu lesen - Beschreibung beginnt mit dem, was das Tool in 1 Satz tut
- Beschreibung enthält "Verwenden für:" mit 3–5 konkreten Anwendungsfällen
- Variablenbeschreibungen listen die erwarteten Informationsarten auf, nicht nur "die Abfrage"
- Kein Überschneidung mit dem Territorium eines anderen Tools
- Getestet mit 2–3 mehrdeutigen Fragen im Testpanel, um die korrekte Weiterleitung zu bestätigen
Beispiel: Produktsuche
Tool-Konfiguration:
- Name:
ecommerce_product_search - Beschreibung: Durchsucht den Produktkatalog nach Name, Kategorie oder Merkmal. Verwenden für: Finden eines bestimmten Produkts, Vergleichen von Produkten in einer Kategorie, Überprüfen, ob ein Produkt existiert, Nachschlagen von Produktspezifikationen oder Preisen.
- Variable:
query— "Produktname, Kategorie, Merkmal oder Preisspanne, nach der gesucht werden soll"
Flow:
- Trigger: Konversationstool
- Aktion: Wissensdatenbank durchsuchen (
{{query}}) - Aktion: Beobachtung festlegen (Ergebnisse zurückgeben)
Benutzerkonversation:
Benutzer: "Haben Sie kabellose Kopfhörer?"
KI: ruft ecommerce_product_search mit query="kabellose Kopfhörer" auf
KI: "Ja! Ich habe 3 kabellose Kopfhörer gefunden. Die Sony WH-1000XM5 sind unser Bestseller für 349 €..."
Beispiel: JIRA-Ticket
Tool-Konfiguration:
- Name:
support_create_jira_ticket - Beschreibung: Erstellt ein JIRA-Supportticket aus dem Gespräch. Verwenden für: wenn der Benutzer einen Fehler meldet, eine Funktion anfordert oder ein Problem an das technische Team eskalieren muss.
- Variablen:
title— "Kurze Zusammenfassung des Problems (1 Satz)",description— "Detaillierte Beschreibung einschließlich Schritte zur Reproduktion, erwartetes Verhalten und tatsächliches Verhalten"
Flow:
- Trigger: Konversationstool
- Aktion: KI-Anfrage (Titel/Beschreibung generieren)
- Parallel: Beschreibung + Titel generieren
- Aktion: JIRA Ticket erstellen
