Samtaleverktøy
Lag et verktøy som AI kan bruke under samtaler. AI bestemmer når det skal kalles basert på konteksten.
Få AI-agenten din til å HANDLE · bygg ditt første verktøy
Når du skal bruke det
Bruk denne utløseren for å utvide hva AI kan gjøre:
- Søk etter produkter i katalogen din
- Sjekk ordrestatus i systemet ditt
- Se opp kundedata i CRM
- Opprett supportbilletter i JIRA
- Bestill avtaler
- Enhver tilpasset kapasitet
Konfigurasjon
Grunnleggende innstillinger
| Felt | Beskrivelse |
|---|---|
| Verktøynavn | Menneskelig lesbart navn (vist i Node-biblioteket) |
| Beskrivelse | Forklarer når/hvordan AI skal bruke dette verktøyet |
Brukermålretting
Velg hvem som kan bruke dette verktøyet:
| Alternativ | Beskrivelse |
|---|---|
| Alle brukere | Anonyme + tilkoblede brukere |
| Kun tilkoblede brukere | Kun innloggede brukere |
| Rollebasert tilgang | Spesifikke brukerroller |
Verktøyvariabler
Definer parametere AI trenger å samle inn fra brukeren:
| Felt | Beskrivelse |
|---|---|
| Variabelnavn | Internt navn (f.eks., query, orderId) |
| Beskrivelse | Hjelp AI med å forstå hva som skal spørres om |
Variabler blir tilgjengelige som {{variableName}} i flyten din.
Hvordan det fungerer
- Du definerer et verktøy med navn, beskrivelse og variabler
- AI lærer når det skal brukes fra beskrivelsen din
- Bruker spør om noe relatert (f.eks., "Finn meg en laptop")
- AI samler inn nødvendige variabler samtalebasert
- Flyten kjører med de innsamlede dataene
- Resultatet returneres til AI for den endelige responsen
Navngivning av verktøyene dine: Hvorfor det er viktig
Når AI-assistenten din har tilgang til flere verktøy, velger den hvilket den skal kalle basert på tre ting: verktøynavnet, verktøybeschrivelsen, og variabelbeskrivelsene. Den kan ikke se hva som er inne i flyten — den leser tekst og bestemmer.
Hvis disse tre feltene er vage eller for like på tvers av verktøyene, vil AI velge feil verktøy. Studier om LLM-funksjonskall viser at forbedring av klarheten i beskrivelsen alene kan øke korrekt verktøyvalg med 15–20 prosentpoeng, uten å endre den underliggende modellen.
Dette er spesielt kritisk når du har flere verktøy som søker i forskjellige kunnskapsbaser — fra AIs perspektiv, de "søker etter informasjon." Navnet og beskrivelsen er den eneste måten den kan skille dem fra hverandre.
Verktøynavn
Bruk mønsteret domain_action_target slik at navnet alene skiller hvert verktøy:
| ❌ Vagt | ✅ Klart |
|---|---|
Søk | rgpd_legal_analysis |
search_docs | ecommerce_product_search |
Verktøy 2 | support_ticket_lookup |
AI bruker navnet som et første filter før den leser beskrivelsen. Et klart navn lar den lage en kortliste umiddelbart; et generisk navn tvinger den til å gjette.
Verktøybeschrivelse
Beskrivelsen er din mest kraftfulle spak. Bruk denne formelen:
[Hva det gjør — 1 setning]
Bruk for: [3–5 konkrete bruksområder med ordene brukerne faktisk ville sagt]
❌ Dårlig:
Søk i kunnskapsbasen etter informasjon.
✅ Bra:
Søker CNIL-sanksjoner og CJUE-rettspraksis.
Bruk for: finne straffebeslutninger etter sektor eller bruddtype,
se opp bøtesummer, sitere juridiske presedenser,
vurdere den finansielle risikoen ved RGPD-ikkeoverholdelse.
Ordene inne i "Bruk for" fungerer som semantiske triggere. Når en brukers melding inneholder "bøter", "straff" eller "risiko", matcher AI umiddelbart det med dette verktøyet.
Variabelbeskrivelser
En variabel beskrevet som "Søkeforespørselen" forteller AI ingenting. Den vil lime inn brukerens rå spørsmål hver gang. En bedre beskrivelse veileder AI til å trekke ut de riktige nøkkelordene før de sendes.
| ❌ Vagt | ✅ Klart |
|---|---|
Søkeforespørselen | Søkeforespørsel: bruddtype, firmanavn, sektor, bøtesum, eller juridisk konsept |
Brukerinndata | Dokumenttype forespurt: mal, modell, skjema, klausul, eller kontrakt |
Dette presser AI til å omformulere i stedet for å kopiere hele brukerens melding — noe som resulterer i mer målrettede søk og bedre resultater.
Unngå verktøykonflikter
Når to verktøy kan svare på det samme spørsmålet, nøler AI — og velger noen ganger tilfeldig. Hvert verktøy må dekke et eksklusivt territorium.
Regelen: hvis du kan tenke deg et bruker spørsmål som kan gå til begge verktøyene, trenger beskrivelsene dine mer presisjon.
Eksempel — 5 samsvarsverktøy med klare grenser:
| Verktøy | Dekker | Dekker IKKE |
|---|---|---|
compliance_legal_analysis | Lovartikler, juridiske forpliktelser, rettigheter | Ingen praktiske råd, ingen virkelige saker |
compliance_methodology | Trinn-for-trinn guider, revisjonsprosedyrer, rammeverk | Ingen juridisk tekst, ingen maler |
compliance_document_templates | Klargjorte modeller, skjemaer, kontraktsklausuler | Ingen metodologi, ingen juridisk analyse |
compliance_business_processes | Operasjonelle arbeidsflyter, godkjenningssløyfer | Ingen juridisk tekst, kun interne prosesser |
compliance_operational_solutions | Konkrete løsninger, tekniske anbefalinger | Ingen teori, kun handlingsdyktige løsninger |
Jo mer spesifikk hver beskrivelse er om hva verktøyet dekker, jo mindre tvetydighet er det. Du trenger ikke å skrive eksplisitte unntak — presisjon gjør jobben.
Rask sjekkliste
Før du publiserer en flyt med en samtaleverktøyutløser, verifiser:
- Navn følger
domain_action_target— skillebart uten å lese beskrivelsen - Beskrivelse starter med hva verktøyet gjør i 1 setning
- Beskrivelse inkluderer "Bruk for:" med 3–5 konkrete bruksområder
- Variabelbeskrivelser lister opp typene informasjon som forventes, ikke bare "forespørselen"
- Ingen overlapp med et annet verktøys territorium
- Testet med 2–3 tvetydige spørsmål i testpanelet for å bekrefte korrekt ruting
Eksempel: Produkt Søk
Verktøykonfigurasjon:
- Navn:
ecommerce_product_search - Beskrivelse: Søker i produktkatalogen etter navn, kategori eller funksjon. Bruk for: finne et spesifikt produkt, sammenligne produkter i en kategori, sjekke om et produkt eksisterer, se opp produktspecifikasjoner eller priser.
- Variabel:
query— "Produktnavn, kategori, funksjon, eller prisklasse å søke etter"
Flyt:
- Utløser: Samtaleverktøy
- Handling: Søk i kunnskapsbasen (
{{query}}) - Handling: Sett observasjon (returner resultater)
Brukersamtale:
Bruker: "Har dere noen trådløse hodetelefoner?"
AI: kaller ecommerce_product_search med query="trådløse hodetelefoner"
AI: "Ja! Jeg fant 3 trådløse hodetelefoner. Sony WH-1000XM5 er vår bestselger til €349..."
Eksempel: JIRA-billett
Verktøykonfigurasjon:
- Navn:
support_create_jira_ticket - Beskrivelse: Oppretter en JIRA supportbillett fra samtalen. Bruk for: når brukeren rapporterer en feil, ber om en funksjon, eller trenger å eskalere et problem til det tekniske teamet.
- Variabler:
title— "Kort sammendrag av problemet (1 setning)",description— "Detaljert beskrivelse inkludert trinn for å reprodusere, forventet atferd, og faktisk atferd"
Flyt:
- Utløser: Samtaleverktøy
- Handling: AI-forespørsel (generere tittel/beskrivelse)
- Parallelt: Generere beskrivelse + tittel
- Handling: JIRA Opprett sak
