Conversatietool
Creëer een tool die de AI kan gebruiken tijdens gesprekken. De AI beslist wanneer deze moet worden ingeschakeld op basis van de context.
Maak je AI-agent ACT · bouw je eerste Tool
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 supporttickets aan in JIRA
- Boek afspraken
- Elke aangepaste mogelijkheid
Configuratie
Basisinstellingen
| Veld | Beschrijving |
|---|---|
| Toolnaam | Menselijk leesbare naam (weergegeven in de Node-bibliotheek) |
| Beschrijving | Legt uit wanneer/hoe de AI deze tool moet gebruiken |
Doelgroep
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 moet verzamelen van de gebruiker:
| Veld | Beschrijving |
|---|---|
| Variabelenaam | Interne naam (bijv. query, orderId) |
| Beschrijving | Helpt de AI te begrijpen wat gevraagd moet worden |
Variabelen worden beschikbaar als {{variabelenaam}} in je flow.
Hoe Het Werkt
- Jij definieert een tool met naam, beschrijving en variabelen
- AI leert wanneer deze te gebruiken uit jouw beschrijving
- Gebruiker vraagt iets gerelateerd (bijv. "Vind een laptop")
- AI verzamelt vereiste variabelen conversatief
- Flow draait met de verzamelde gegevens
- Resultaat retourneert naar AI voor de uiteindelijke reactie
De Naamgeving 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 kritisch 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 | support_ticket_opzoeken |
De AI gebruikt de naam als eerste filter voordat deze de beschrijving leest. Een duidelijke naam laat het onmiddellijk shortlist; 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 je gebruikers daadwerkelijk zouden zeggen]
❌ Slecht:
Zoek de kennisdatabase naar informatie.
✅ Goed:
Zoekt naar 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 beschreven als "De zoekopdracht" vertelt de AI niets. Het zal elke keer de ruwe vraag van de gebruiker plakken. Een betere beschrijving leidt de AI om de juiste trefwoorden te extraheren voordat deze ze verzendt.
| ❌ Vaag | ✅ Duidelijk |
|---|---|
De zoekopdracht | Zoekopdracht: schendingstype, bedrijfsnaam, sector, boetebedrag of juridisch concept |
Gebruikersinvoer | Vraagt type document: sjabloon, model, formulier, clausule of contract |
Dit duwt 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 kan 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 casussen |
compliance_methodologie | Stapsgewijze handleidingen, auditprocedures, kaders | 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, verifieer:
- 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 verwacht worden, 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, 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)
Gesprek met de gebruiker:
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-supportticket 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 Probleem Aanmaken
