Conversatiouns-Tool
Schaf e Tool, dat d'AI während Conversatiounen benotze kann. D'AI entscheed wann et et op Basis vum Kontext opruft.
Macht Äre AI-Agent ACT · baut Äert éischt Tool
Woufir ze benotzen
Benotzt dësen Trigger fir ze verlängeren, wat Äre AI kann:
- Sich no Produkter an Ärem Katalog
- Kontrolléiert den Bestellstatus an Ärem System
- Kuckt no Clientedaten am CRM
- Erstellt Support-Tickets an JIRA
- Bucht Rendez-vous
- All personaliséiert Fäegkeet
Konfiguratioun
Basis Astellungen
| Feld | Beschreiwung |
|---|---|
| Tool Numm | Mënschlech liesbar Numm (gewisen am Node Bibliothéik) |
| Beschreiwung | Erklärt wéini/wéi AI dëst Tool soll benotzen |
Benotzer Zilsetzung
Wielt, wien dëst Tool benotze kann:
| Optioun | Beschreiwung |
|---|---|
| All Benotzer | Anonym + verbonnen Benotzer |
| Nëmme verbonnen Benotzer | Nëmme ageloggt Benotzer |
| Roll-baséiert Zougang | Spezifesch Benotzerrollen |
Tool Variabelen
Definéiert Parameter, déi d'AI muss vun de Benotzer sammelen:
| Feld | Beschreiwung |
|---|---|
| Variabel Numm | Intern Numm (z.B., query, orderId) |
| Beschreiwung | Hëlleft der AI ze verstoen, wat se muss froen |
Variabelen ginn als {{variableName}} an Ärem Flow verfügbar.
Wéi et funktionéiert
- Dir definéiert e Tool mat Numm, Beschreiwung, an Variabelen
- AI léiert wéini et et benotze soll aus Ärer Beschreiwung
- Benotzer froen eppes verbonnen (z.B., "Fannt mir e Laptop")
- AI sammelt déi néideg Variabelen am Gespréich
- Flow leeft mat den gesammelt Daten
- Resultat gëtt un d'AI fir d'final Äntwert zréck
Numm vun Äre Tools: Firwat et wichteg ass
Wann Äre AI Assistent Zougang zu multiple Tools huet, wielt et, wéi eng et op Basis vun dräi Saachen: dem Tool Numm, der Tool Beschreiwung, an den Variabel Beschreiwungen. Et kann net gesin, wat an dem Flow ass - et liesst Text an entscheed.
Wann dës dräi Felder vage oder ze ähnlech iwwer Tools sinn, wäert d'AI dat falscht Tool wielen. Studien iwwer LLM Funktiounsopruff weisen, datt d'Klarheet vun der Beschreiwung eleng d'korrekt Toolwiel ëm 15–20 Prozentpunkte kann erhéijen, ouni d'fundamental Modell ze veränneren.
Dëst ass besonnesch kritesch wann Dir e puer Tools hutt, déi verschidde Wëssenbasen sichen - aus der Perspektiv vun der AI, si sichen all "informatioun." Den Numm an d'Beschreiwung sinn d'eenzeg Wee fir se vuneneen ze ënnerscheeden.
Tool Numm
Benotzt d'Muster domain_action_target sou datt den Numm eleng all Tool ënnerscheed:
| ❌ Vage | ✅ Kloer |
|---|---|
Sichen | rgpd_legal_analysis |
search_docs | ecommerce_product_search |
Tool 2 | support_ticket_lookup |
D'AI benotzt den Numm als éischt Filter ier et d'Beschreiwung liesst. E kloeren Numm erlaabt et, direkt eng Kuerzlist ze maachen; e generesche Numm zéngt et, ze raten.
Tool Beschreiwung
D'Beschreiwung ass Ären mächtegsten Hebel. Benotzt dës Formel:
[Wat et mécht - 1 Saz]
Benotzt fir: [3–5 konkret Benotzungsfäll mat de Wierder, déi Är Benotzer wierklech soen géifen]
❌ Schlecht:
Sicht d'Wëssenbasis no Informatioun.
✅ Gut:
Sicht CNIL Sanktiounen an CJUE Rechtsprechung.
Benotzt fir: Fannen vu Sanktiounsentscheedungen no Sektor oder Verstouss Typ,
kucken no Strofbeträg, zitéieren legal Präzedenz,
bewäerten den finanziellen Risiko vun RGPD Nichtefëllung.
D'Wierder an "Benotzt fir" handelen als semantesch Trigger. Wann eng Benotzerbotschaft "Strof", "Sanktioun" oder "Risiko" enthält, passt d'AI et direkt op dëst Tool un.
Variabel Beschreiwungen
Eng Variabel, déi als "D'Sichufro" beschriwwe gëtt, erzielt der AI näischt. Et wäert d'raw Fro vum Benotzer all Kéier kopéieren. Eng besser Beschreiwung leet der AI d'Fäegkeet fir d'recht Schlüsselwieder erauszefëllen ier se se schéckt.
| ❌ Vage | ✅ Kloer |
|---|---|
D'Sichufro | Sichufro: Verstouss Typ, Firmennumm, Sektor, Strofbeträg, oder legal Konzept |
Benotzerinput | Dokumenttyp gefrot: Schabloun, Modell, Form, Klausel, oder Kontrakt |
Dëst dréit d'AI dozou, ze reformuléieren amplaz d'ganz Message vum Benotzer ze kopéieren - wat zu méi gezielten Sichen an besseren Resultater féiert.
Vermeidung vun Tool Konflikter
Wann zwou Tools d'selwecht Fro beäntwerte kënnen, zéckt d'AI - an wielt heiansdo zoufälleg. Jedes Tool muss e exklusivt Territorium ofdecken.
D'Regel: wann Dir eng Benotzerfro denkt, déi zu béide Tools kéint goen, brauchen Är Beschreiwungen méi Präzisioun.
Beispill — 5 Compliance Tools mat kloeren Grenzen:
| Tool | Deckt | Deckt NET |
|---|---|---|
compliance_legal_analysis | Gesetzesartikelen, legal Obligatiounen, Rechter | Keen praktesche Rotschléi, keng real-welt Fäll |
compliance_methodology | Schrëtt-fir-Schrëtt Guide, Auditprozeduren, Frameworks | Keen legal Text, keng Schablounen |
compliance_document_templates | Bereet-fir-ze benotzen Modeller, Formen, Kontrakt Klauselen | Keen Methodologie, keng legal Analyse |
compliance_business_processes | Operatiouns-Workflows, Genehmegung Circuit | Keen legal Text, nëmmen intern Prozesser |
compliance_operational_solutions | Konkret Léisungen, technesch Empfehlungen | Keen Theorie, nëmmen umsetzbar Léisungen |
D'spezifesch Beschreiwung iwwer wat d'Tool deckt, reduzéiert d'Ambiguitéit. Dir braucht net explizit Ausgrenzungen ze schreiwen - Präzisioun mécht d'Aarbecht.
Schnell Kontrolllëscht
Virun der Verëffentlechung vun engem Flow mat engem Conversatiouns-Tool Trigger, veriféiert:
- Numm follegt
domain_action_target— ënnerscheedbar ouni d'Beschreiwung ze liesen - Beschreiwung fänkt un mat wat d'Tool mécht an 1 Saz
- Beschreiwung enthält "Benotzt fir:" mat 3–5 konkrete Benotzungsfäll
- Variabel Beschreiwungen lëschten d'Typen vun Informatiounen, déi erwaart ginn, net just "d'Fro"
- Kein Iwwerlapp mat engem aneren Tool sengem Territorium
- Getest mat 2–3 ambigue Froen am Testpanel fir korrekt Routing ze bestätegen
Beispill: Produkt Sich
Tool Konfiguratioun:
- Numm:
ecommerce_product_search - Beschreiwung: Sich den Produktkatalog no Numm, Kategorie, oder Feature. Benotzt fir: e spezifesch Produkt ze fannen, Produkter an enger Kategorie ze vergläichen, ze kontrolléieren ob e Produkt existéiert, Produktspezifikatioune oder Präisser ze kucken.
- Variabel:
query— "Produkt Numm, Kategorie, Feature, oder Präisspanne fir ze sichen"
Flow:
- Trigger: Conversatiouns-Tool
- Aktioun: Sich Wëssenbasis (
{{query}}) - Aktioun: Setzt Observatioun (resultater zréckginn)
Benotzer Conversatioun:
Benotzer: "Hutt Dir drahtlos Kopfhörer?"
AI: ruft ecommerce_product_search mat query="drahtlos Kopfhörer"
AI: "Jo! Ech hunn 3 drahtlos Kopfhörer fonnt. Den Sony WH-1000XM5 ass eise Bestseller fir €349..."
Beispill: JIRA Ticket
Tool Konfiguratioun:
- Numm:
support_create_jira_ticket - Beschreiwung: Erstellt e JIRA Support Ticket aus der Conversatioun. Benotzt fir: wann de Benotzer e Bug mellt, eng Feature ufroht, oder e Problem un d'technesch Team muss eskaléieren.
- Variabelen:
title— "Kuerz Zesummefaassung vum Problem (1 Saz)",description— "Detailléiert Beschreiwung inklusiv Schrëtt fir ze reproduzéieren, erwaart Verhalen, an tatsächlecht Verhalen"
Flow:
- Trigger: Conversatiouns-Tool
- Aktioun: AI Ufro (generéiert Titel/Beschreiwung)
- Parallell: Generéiert Beschreiwung + Titel
- Aktioun: JIRA Probleem erstellen
