Konversationsverktyg
Skapa ett verktyg som AI kan använda under konversationer. AI bestämmer när det ska anropas baserat på kontext.
När man ska använda
Använd denna trigger för att utöka vad din AI kan göra:
- Sök efter produkter i din katalog
- Kontrollera orderstatus i ditt system
- Slå upp kunddata i CRM
- Skapa supportärenden i JIRA
- Boka möten
- Valfri anpassad funktionalitet
Konfiguration
Grundläggande inställningar
| Fält | Beskrivning |
|---|---|
| Verktygsnamn | Mänskligt läsbart namn (visas i Node-biblioteket) |
| Beskrivning | Förklarar när/hur AI ska använda detta verktyg |
Användarmålgrupp
Välj vem som kan använda detta verktyg:
| Alternativ | Beskrivning |
|---|---|
| Alla användare | Anonyma + anslutna användare |
| Endast anslutna användare | Endast inloggade användare |
| Rollbaserad åtkomst | Specifika användarroller |
Verktygsvariabler
Definiera parametrar som AI behöver samla in från användaren:
| Fält | Beskrivning |
|---|---|
| Variabelnamn | Internt namn (t.ex. query, orderId) |
| Beskrivning | Hjälper AI att förstå vad som ska frågas efter |
Variabler blir tillgängliga som {{variableName}} i ditt flöde.
Hur det fungerar
- Du definierar ett verktyg med namn, beskrivning och variabler
- AI lär sig när det ska använda det från din beskrivning
- Användaren frågar något relaterat (t.ex. "Hitta en bärbar dator")
- AI samlar in nödvändiga variabler konversativt
- Flödet körs med de insamlade uppgifterna
- Resultatet returneras till AI för det slutliga svaret
Namngivning av dina verktyg: Varför det är viktigt
När din AI-assistent har tillgång till flera verktyg väljer den vilket den ska anropa baserat på tre saker endast: verktygsnamnet, verktygsbeskrivningen och variabelbeskrivningarna. Den kan inte se vad som finns i flödet — den läser text och beslutar.
Om dessa tre fält är vaga eller för lika över verktyg kommer AI att välja fel verktyg. Studier om LLM-funktionsanrop visar att förbättrad tydlighet i beskrivningen ensamt kan öka korrekt verktygsval med 15–20 procentenheter, utan att ändra den underliggande modellen.
Detta är särskilt kritiskt när du har flera verktyg som söker i olika kunskapsbaser — ur AIs perspektiv "söker de alla efter information." Namnet och beskrivningen är det enda sättet den kan särskilja dem.
Verktygsnamn
Använd mönstret domain_action_target så att namnet ensamt särskiljer varje verktyg:
| ❌ Vagt | ✅ Tydligt |
|---|---|
Sök | rgpd_legal_analysis |
search_docs | ecommerce_product_search |
Verktyg 2 | support_ticket_lookup |
AI använder namnet som ett första filter innan den läser beskrivningen. Ett tydligt namn låter den kortlista omedelbart; ett generiskt namn tvingar den att gissa.
Verktygsbeskrivning
Beskrivningen är din mest kraftfulla hävstång. Använd denna formel:
[Vad det gör — 1 mening]
Använd för: [3–5 konkreta användningsfall med de ord som dina användare faktiskt skulle säga]
❌ Dåligt:
Sök i kunskapsbasen efter information.
✅ Bra:
Söker CNIL-sanktioner och CJUE-jurisprudens.
Använd för: att hitta straffbeslut efter sektor eller överträdelsetyp,
slå upp bötesbelopp, citera rättsliga prejudikat,
bedöma den finansiella risken för RGPD-överträdelse.
Orden inom "Använd för" fungerar som semantiska utlösare. När ett meddelande från en användare innehåller "böter", "straff" eller "risk", matchar AI omedelbart det med detta verktyg.
Variabelbeskrivningar
En variabel som beskrivs som "Sökfrågan" säger AI ingenting. Den kommer att klistra in användarens råa fråga varje gång. En bättre beskrivning vägleder AI att extrahera rätt nyckelord innan de skickas.
| ❌ Vagt | ✅ Tydligt |
|---|---|
Sökfrågan | Sökfråga: överträdelsetyp, företagsnamn, sektor, bötesbelopp eller rättsligt begrepp |
Användarinmatning | Begärt dokumenttyp: mall, modell, formulär, klausul eller kontrakt |
Detta tvingar AI att omformulera istället för att kopiera hela användarens meddelande — vilket resulterar i mer riktade sökningar och bättre resultat.
Undvika verktygskonflikter
När två verktyg kan svara på samma fråga tvekar AI — och ibland väljer den slumpmässigt. Varje verktyg måste täcka ett exklusivt territorium.
Regeln: om du kan tänka på en användarfråga som skulle kunna gå till antingen verktyg, behöver dina beskrivningar mer precision.
Exempel — 5 efterlevnadsverktyg med tydliga gränser:
| Verktyg | Täckning | Täck inte |
|---|---|---|
compliance_legal_analysis | Lagartiklar, juridiska skyldigheter, rättigheter | Ingen praktisk rådgivning, inga verkliga fall |
compliance_methodology | Steg-för-steg-guider, revisionsprocedurer, ramverk | Ingen juridisk text, inga mallar |
compliance_document_templates | Klara att använda modeller, formulär, kontraktsklausuler | Ingen metodologi, ingen juridisk analys |
compliance_business_processes | Operativa arbetsflöden, godkännandecirklar | Ingen juridisk text, endast interna processer |
compliance_operational_solutions | Konkreta lösningar, tekniska rekommendationer | Ingen teori, endast handlingsbara lösningar |
Ju mer specifik varje beskrivning är om vad verktyget täcker, desto mindre oklarhet finns det. Du behöver inte skriva explicita undantag — precision gör jobbet.
Snabbchecklista
Innan du publicerar ett flöde med en Konversationsverktyg-trigger, verifiera:
- Namn följer
domain_action_target— särskiljande utan att läsa beskrivningen - Beskrivning börjar med vad verktyget gör i 1 mening
- Beskrivning inkluderar "Använd för:" med 3–5 konkreta användningsfall
- Variabelbeskrivningar listar typerna av information som förväntas, inte bara "frågan"
- Ingen överlappning med ett annat verktags territorium
- Testad med 2–3 tvetydiga frågor i Testpanelen för att bekräfta korrekt ruttning
Exempel: Produkt Sökning
Verktygskonfiguration:
- Namn:
ecommerce_product_search - Beskrivning: Söker i produktkatalogen efter namn, kategori eller funktion. Använd för: att hitta en specifik produkt, jämföra produkter i en kategori, kontrollera om en produkt finns, slå upp produktspecifikationer eller prissättning.
- Variabel:
query— "Produktnamn, kategori, funktion eller prisklass att söka efter"
Flöde:
- Trigger: Konversationsverktyg
- Åtgärd: Sök i kunskapsbasen (
{{query}}) - Åtgärd: Ställ observation (returnera resultat)
Användarkonversation:
Användare: "Har ni några trådlösa hörlurar?"
AI: anropar ecommerce_product_search med query="trådlösa hörlurar"
AI: "Ja! Jag hittade 3 trådlösa hörlurar. Sony WH-1000XM5 är vår bästsäljare till €349..."
Exempel: JIRA Biljett
Verktygskonfiguration:
- Namn:
support_create_jira_ticket - Beskrivning: Skapar en JIRA-supportbiljett från konversationen. Använd för: när användaren rapporterar en bugg, begär en funktion eller behöver eskalera ett problem till det tekniska teamet.
- Variabler:
title— "Kort sammanfattning av problemet (1 mening)",description— "Detaljerad beskrivning inklusive steg för att återskapa, förväntat beteende och faktiskt beteende"
Flöde:
- Trigger: Konversationsverktyg
- Åtgärd: AI-begäran (generera titel/beskrivning)
- Parallell: Generera beskrivning + titel
- Åtgärd: JIRA Skapa ärende
