Samtaleverktøy
Lag et verktøy som AI kan bruke under samtaler. AI bestemmer når det skal kalles basert på konteksten.
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 funksjonalitet
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 |
Målretting av Brukere
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 | Intern navn (f.eks., query, orderId) |
| Beskrivelse | Hjelp AI å 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 samtalemessig
- Flyten kjører med de innsamlede dataene
- Resultatet returneres til AI for det endelige svaret
Navngi 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øysbeskrivelsen og variabelbeskrivelsene. Den kan ikke se hva som er inni flyten — den leser tekst og bestemmer.
Hvis disse tre feltene er vage eller for like på tvers av verktøy, vil AI velge feil verktøy. Studier om LLM-funksjonskall viser at forbedring av beskrivelsesklarhet 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 "søker" de alle 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øysbeskrivelse
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 dine 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 økonomiske risikoen ved RGPD-ikke-overholdelse.
Ordene inne i "Bruk for" fungerer som semantiske utløserne. Når en brukers melding inneholder "bot", "straff" eller "risiko", matcher AI det umiddelbart 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 begrep |
Brukerinput | Dokumenttype forespurt: mal, modell, skjema, klausul eller kontrakt |
Dette presser AI til å omformulere i stedet for å kopiere hele meldingen fra brukeren — 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 noen ganger velger tilfeldig. Hvert verktøy må dekke et eksklusivt område.
Regelen: hvis du kan tenke på et bruker spørsmål som kan gå til begge verktøy, 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 | Klare modeller, skjemaer, kontraktsklausuler | Ingen metodikk, 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 handlingsbare 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øy-utlø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 typene informasjon som forventes, ikke bare "forespørselen"
- Ingen overlapping med et annet verktøys område
- 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 Kunnskapsbase (
{{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 Billet
Verktøykonfigurasjon:
- Navn:
support_create_jira_ticket - Beskrivelse: Oppretter en JIRA supportbillet 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 å gjenskape, forventet oppførsel og faktisk oppførsel"
Flyt:
- Utløser: Samtaleverktøy
- Handling: AI Forespørsel (generere tittel/beskrivelse)
- Parallell: Generere beskrivelse + tittel
- Handling: JIRA Opprett Sak
