Conversatietool
Creëer een tool die de AI kan gebruiken tijdens gesprekken. De AI beslist wanneer deze op basis van de context moet worden ingeschakeld.
Wanneer te Gebruiken
Gebruik deze trigger om uit te breiden wat je AI kan doen:
- Zoek naar producten in je catalogus
- Controleer de status van bestellingen in je systeem
- Zoek klantgegevens op in CRM
- Maak ondersteuningstickets aan in JIRA
- Boek afspraken
- Elke aangepaste mogelijkheid
Configuratie
Basisinstellingen
| Veld | Beschrijving |
|---|---|
| Toolnaam | Leesbare naam (weergegeven in de Node-bibliotheek) |
| Beschrijving | Legt uit wanneer/hoe de AI deze tool moet gebruiken |
Gebruikerstargeting
Kies wie deze tool kan gebruiken:
| Optie | Beschrijving |
|---|---|
| Alle gebruikers | Anonieme + verbonden gebruikers |
| Alleen verbonden gebruikers | Alleen ingelogde gebruikers |
| Rolgebaseerde toegang | Specifieke gebruikersrollen |
Toolvariabelen
Definieer parameters die de AI van de gebruiker moet verzamelen:
| Veld | Beschrijving |
|---|---|
| Variabelenaam | Interne naam (bijv., query, orderId) |
| Beschrijving | Helpt de AI te begrijpen wat er gevraagd moet worden |
Variabelen worden beschikbaar als {{variabelenaam}} in je flow.
Hoe Het Werkt
- Je definieert een tool met naam, beschrijving en variabelen
- AI leert wanneer deze gebruikt moet worden op basis van jouw beschrijving
- Gebruiker vraagt iets gerelateerd (bijv., "Vind een laptop")
- AI verzamelt vereiste variabelen in een gesprek
- Flow draait met de verzamelde gegevens
- Resultaat retourneert naar AI voor de uiteindelijke reactie
Het Benoemen van Je Tools: Waarom Het Belangrijk Is
Wanneer je AI-assistent toegang heeft tot meerdere tools, kiest deze welke te gebruiken op basis van slechts drie dingen: de toolnaam, de toolbeschrijving en de variabele beschrijvingen. Het kan niet zien wat er in de flow staat — het leest tekst en beslist.
Als die drie velden vaag of te vergelijkbaar zijn tussen tools, zal de AI de verkeerde tool kiezen. Studies over LLM-functieaanroepen tonen aan dat het verbeteren van de duidelijkheid van beschrijvingen alleen de juiste toolselectie met 15–20 procentpunten kan verhogen, zonder het onderliggende model te veranderen.
Dit is vooral cruciaal wanneer je verschillende tools hebt die verschillende kennisbases doorzoeken — vanuit het perspectief van de AI "zoeken ze allemaal naar informatie." De naam en beschrijving zijn de enige manier waarop het ze kan onderscheiden.
Toolnaam
Gebruik het patroon domein_actie_doel zodat de naam alleen elke tool onderscheidt:
| ❌ Vaag | ✅ Duidelijk |
|---|---|
Zoeken | rgpd_juridische_analyse |
zoek_docs | ecommerce_product_zoek |
Tool 2 | ondersteuning_ticket_opzoeken |
De AI gebruikt de naam als eerste filter voordat deze de beschrijving leest. Een duidelijke naam laat het onmiddellijk shortlist maken; een generieke naam dwingt het om te gokken.
Toolbeschrijving
De beschrijving is je krachtigste hefboom. Gebruik deze formule:
[Wat het doet — 1 zin]
Gebruik voor: [3–5 concrete gebruiksgevallen met de woorden die jouw gebruikers daadwerkelijk zouden zeggen]
❌ Slecht:
Zoek in de kennisdatabase naar informatie.
✅ Goed:
Zoekt CNIL-sancties en CJUE-jurisprudentie.
Gebruik voor: het vinden van sanctiebesluiten per sector of schendingstype,
het opzoeken van boetebedragen, het citeren van juridische precedenten,
het beoordelen van het financiële risico van RGPD-non-compliance.
De woorden binnen "Gebruik voor" fungeren als semantische triggers. Wanneer een bericht van een gebruiker "boete", "sanctie" of "risico" bevat, koppelt de AI dit onmiddellijk aan deze tool.
Variabele Beschrijvingen
Een variabele die wordt beschreven als "De zoekopdracht" zegt de AI niets. Het zal elke keer de ruwe vraag van de gebruiker plakken. Een betere beschrijving leidt de AI om de juiste zoekwoorden te extraheren voordat deze ze verzendt.
| ❌ Vaag | ✅ Duidelijk |
|---|---|
De zoekopdracht | Zoekopdracht: schendingstype, bedrijfsnaam, sector, boetebedrag of juridisch concept |
Gebruikersinvoer | Type document dat wordt aangevraagd: sjabloon, model, formulier, clausule of contract |
Dit dwingt de AI om te herformuleren in plaats van het volledige bericht van de gebruiker te kopiëren — wat resulteert in gerichter zoeken en betere resultaten.
Vermijden van Toolconflicten
Wanneer twee tools dezelfde vraag kunnen beantwoorden, aarzelt de AI — en kiest soms willekeurig. Elke tool moet een exclusief territorium dekken.
De regel: als je een gebruikersvraag kunt bedenken die naar beide tools zou kunnen gaan, hebben je beschrijvingen meer precisie nodig.
Voorbeeld — 5 compliance-tools met duidelijke grenzen:
| Tool | Deckt | Deckt NIET |
|---|---|---|
compliance_juridische_analyse | Wetsartikelen, juridische verplichtingen, rechten | Geen praktisch advies, geen echte gevallen |
compliance_methodologie | Stapsgewijze handleidingen, auditprocedures, raamwerken | Geen juridische tekst, geen sjablonen |
compliance_document_sjablonen | Klaar-voor-gebruik modellen, formulieren, contractclausules | Geen methodologie, geen juridische analyse |
compliance_zakelijke_processen | Operationele workflows, goedkeuringscircuits | Geen juridische tekst, alleen interne processen |
compliance_operationele_oplossingen | Concrete oplossingen, technische aanbevelingen | Geen theorie, alleen uitvoerbare oplossingen |
Hoe specifieker elke beschrijving is over wat de tool dekt, hoe minder ambiguïteit er is. Je hoeft geen expliciete uitsluitingen te schrijven — precisie doet het werk.
Snelle Checklist
Voordat je een flow publiceert met een Conversatietool-trigger, controleer:
- Naam volgt
domein_actie_doel— onderscheidbaar zonder de beschrijving te lezen - Beschrijving begint met wat de tool doet in 1 zin
- Beschrijving bevat "Gebruik voor:" met 3–5 concrete gebruiksgevallen
- Variabele beschrijvingen vermelden de soorten informatie die worden verwacht, niet alleen "de query"
- Geen overlap met het territorium van een andere tool
- Getest met 2–3 ambiguë vragen in het Testpaneel om correcte routering te bevestigen
Voorbeeld: Productzoektocht
Toolconfiguratie:
- Naam:
ecommerce_product_zoek - Beschrijving: Zoekt in de productcatalogus op naam, categorie of kenmerk. Gebruik voor: het vinden van een specifiek product, het vergelijken van producten in een categorie, controleren of een product bestaat, het opzoeken van productspecificaties of prijzen.
- Variabele:
query— "Productnaam, categorie, kenmerk of prijsklasse om naar te zoeken"
Flow:
- Trigger: Conversatietool
- Actie: Zoek Kennisdatabase (
{{query}}) - Actie: Stel Observatie in (resultaten retourneren)
Gebruikersgesprek:
Gebruiker: "Hebben jullie draadloze hoofdtelefoons?"
AI: roept ecommerce_product_zoek aan met query="draadloze hoofdtelefoons"
AI: "Ja! Ik heb 3 draadloze hoofdtelefoons gevonden. De Sony WH-1000XM5 is onze bestseller voor €349..."
Voorbeeld: JIRA-ticket
Toolconfiguratie:
- Naam:
support_create_jira_ticket - Beschrijving: Maakt een JIRA-ondersteuningsticket aan vanuit het gesprek. Gebruik voor: wanneer de gebruiker een bug meldt, een functie aanvraagt of een probleem moet escaleren naar het technische team.
- Variabelen:
title— "Korte samenvatting van het probleem (1 zin)",description— "Gedetailleerde beschrijving inclusief stappen om te reproduceren, verwachte gedrag en werkelijke gedrag"
Flow:
- Trigger: Conversatietool
- Actie: AI-aanroep (genereer titel/beschrijving)
- Parallel: Genereer beschrijving + titel
- Actie: JIRA Maak Probleem
