Samtalsverktyg
Skapa ett verktyg som AI kan använda under samtal. AI avgör när det ska anropa det baserat på kontext.
Få din AI-agent att AGERA · bygg ditt första verktyg
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
- Vilken som helst anpassad funktionalitet
Konfiguration
Grundläggande inställningar
| Fält | Beskrivning |
|---|---|
| Verktygsnamn | Mänskligt läsbart namn (visas i Node-bibliotek) |
| Beskrivning | Förklarar när/hur AI ska använda detta verktyg |
Användartargeting
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 laptop")
- 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
Namnge 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 avgör.
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 direkt; 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ättspraxis,
bedöma den finansiella risken för RGPD-överträdelse.
Orden inuti "Använd för" fungerar som semantiska utlösare. När ett användarens meddelande innehåller "böter", "straff" eller "risk", matchar AI det omedelbart 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 juridisk begrepp |
Användarinmatning | Begärt dokumenttyp: mall, modell, formulär, klausul eller kontrakt |
Detta pressar 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 väljer ibland 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äcker | Täcker INTE |
|---|---|---|
compliance_legal_analysis | Lagar, 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 metodik, 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 tvetydighet finns det. Du behöver inte skriva explicita undantag — precision gör jobbet.
Snabbchecklista
Innan du publicerar ett flöde med en Samtalsverktyg-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 de typer 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 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 priser.
- Variabel:
query— "Produktnamn, kategori, funktion eller prisklass att söka efter"
Flöde:
- Trigger: Samtalsverktyg
- Åtgärd: Sök i kunskapsbasen (
{{query}}) - Åtgärd: Ställ observation (returnera resultat)
Användarsamtal:
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 för 349 €..."
Exempel: JIRA Biljett
Verktygskonfiguration:
- Namn:
support_create_jira_ticket - Beskrivning: Skapar en JIRA-supportbiljett från samtalet. Använd för: när användaren rapporterar ett fel, 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 reproducera, förväntat beteende och faktiskt beteende"
Flöde:
- Trigger: Samtalsverktyg
- Åtgärd: AI-begäran (generera titel/beskrivning)
- Parallell: Generera beskrivning + titel
- Åtgärd: JIRA Skapa ärende
