Vestlustööriist
Looge tööriist, mida AI saab vestluste ajal kasutada. AI otsustab, millal seda konteksti põhjal kutsuda.
Make your AI agent ACT · build your first Tool
Millal kasutada
Kasutage seda käivituspunkti, et laiendada, mida teie AI teha saab:
- Otsige tooteid oma kataloogist
- Kontrollige tellimuse staatust oma süsteemis
- Otsige kliendiandmeid CRM-is
- Looge tugipiletid JIRA-s
- Broneerige kohtumisi
- Iga kohandatud võimekus
Konfiguratsioon
Põhiseaded
| Väli | Kirjeldus |
|---|---|
| Tööriista nimi | Inimesele arusaadav nimi (kuvatakse Node Library-s) |
| Kirjeldus | Selgitab, millal/kuidas AI peaks seda tööriista kasutama |
Kasutaja sihtimine
Valige, kes saab seda tööriista kasutada:
| Valik | Kirjeldus |
|---|---|
| Kõik kasutajad | Anonüümsed + ühendatud kasutajad |
| Ainult ühendatud kasutajad | Ainult sisse logitud kasutajad |
| Rollipõhine juurdepääs | Spetsiifilised kasutajarollid |
Tööriista muutujad
Määratlege parameetrid, mida AI peab kasutajalt koguma:
| Väli | Kirjeldus |
|---|---|
| Muutuja nimi | Sisemine nimi (nt query, orderId) |
| Kirjeldus | Aitab AI-l mõista, mida küsida |
Muutujad saavad teie voos kätte {{variableName}} kujul.
Kuidas see töötab
- Te määratlete tööriista nime, kirjelduse ja muutujad
- AI õpib, millal seda kasutada teie kirjeldusest
- Kasutaja küsib midagi seotud (nt "Leia mulle sülearvuti")
- AI kogub vajalikud muutujad vestluse käigus
- Voog käivitub kogutud andmetega
- Tulemus tagastatakse AI-le lõpliku vastuse jaoks
Tööriistade nimetamine: miks see on oluline
Kui teie AI assistendil on juurdepääs mitmele tööriistale, valib ta, millist kutsuda, põhinedes ainult kolmele asjale: tööriista nimele, tööriista kirjeldusele ja muutujate kirjeldustele. Ta ei näe, mis on voos — ta loeb teksti ja otsustab.
Kui need kolm välja on ebamugavad või liiga sarnased erinevate tööriistade vahel, valib AI vale tööriista. Uuringud LLM funktsioonide kutsumise kohta näitavad, et ainult kirjelduste selguse parandamine võib suurendada õige tööriista valimise tõenäosust 15–20 protsendipunkti võrra, ilma et alusmudelit muudetaks.
See on eriti kriitiline, kui teil on mitu tööriista, mis otsivad erinevaid teadmiste baase — AI perspektiivist vaadatuna otsivad nad kõik "teavet". Nimi ja kirjeldus on ainus viis, kuidas ta neid eristada saab.
Tööriista nimi
Kasutage mustrit domain_action_target, et nimi eristaks iga tööriista:
| ❌ Ebamugav | ✅ Selge |
|---|---|
Otsi | rgpd_legal_analysis |
search_docs | ecommerce_product_search |
Tööriist 2 | support_ticket_lookup |
AI kasutab nime esimesena filtrina enne kirjelduse lugemist. Selge nimi võimaldab tal kohe lühendada; üldine nimi sunnib teda arvama.
Tööriista kirjeldus
Kirjeldus on teie kõige võimsam tööriist. Kasutage seda valemit:
[Mida see teeb — 1 lause]
Kasutamiseks: [3–5 konkreetset kasutusjuhtu, mida teie kasutajad tõeliselt ütlevad]
❌ Halb:
Otsige teadmiste baasi teavet.
✅ Hea:
Otsib CNIL sanktsioone ja CJUE kohtupraktikat.
Kasutamiseks: karistuste otsimine sektori või rikkumise tüübi järgi,
trahvi summade otsimine, õiguslike pretsedentide tsiteerimine,
RGPD mittejärgimise finantsriski hindamine.
Sõnad "Kasutamiseks" toimivad semantiliste käivitajatena. Kui kasutaja sõnum sisaldab "trahv", "karistus" või "risk", seondub AI kohe sellele tööriistale.
Muutujate kirjeldused
Muutuja, mida kirjeldatakse kui "Otsingu päring", ei ütle AI-le midagi. Ta kopeerib iga kord kasutaja toore küsimuse. Paremini sõnastatud kirjeldus juhendab AI-d õigeid märksõnu välja tooma enne nende saatmist.
| ❌ Ebamugav | ✅ Selge |
|---|---|
Otsingu päring | Otsingu päring: rikkumise tüüp, ettevõtte nimi, sektor, trahvi summa või õiguslik kontseptsioon |
Kasutaja sisend | Taotletud dokumendi tüüp: mall, mudel, vorm, klausel või leping |
See sunnib AI-d reformuleerima, mitte kopeerima kasutaja kogu sõnumit — tulemuseks on sihipärasemad otsingud ja paremad tulemused.
Tööriistade konfliktide vältimine
Kui kaks tööriista saavad sama küsimuse vastata, kõhkleb AI — ja mõnikord valib juhuslikult. Iga tööriist peab katma ainulaadse territooriumi.
Reegel: kui suudate mõelda kasutaja küsimusele, mis võiks minna mõlemale tööriistale, vajavad teie kirjeldused rohkem täpsust.
Näide — 5 vastavustööriista selgete piiridega:
| Tööriist | Katab | EI kata |
|---|---|---|
compliance_legal_analysis | Õigusartiklid, õiguslikud kohustused, õigused | Ei mingit praktilist nõu, ei reaalseid juhtumeid |
compliance_methodology | Samm-sammult juhised, auditeerimise protseduurid, raamistikud | Ei õiguslikku teksti, ei malle |
compliance_document_templates | Valmis mudelid, vormid, lepinguklauslid | Ei metodoloogiat, ei õigusanalüüsi |
compliance_business_processes | Operatiivsed töövood, heakskiitmisringid | Ei õiguslikku teksti, ainult sisemised protsessid |
compliance_operational_solutions | Konkreetne lahendused, tehnilised soovitused | Ei teooriat, ainult teostatavad lahendused |
Mida spetsiifilisem on iga kirjelduse sisu tööriista katte kohta, seda vähem on ebamugavust. Te ei pea kirjutama selgeid välistusi — täpsus teeb töö.
Kiire kontrollnimekiri
Enne vestlustööriista käivituspunktiga voogude avaldamist kontrollige:
- Nimi järgib
domain_action_target— eristatav ilma kirjelduse lugemiseta - Kirjeldus algab sellega, mida tööriist teeb 1 lauses
- Kirjeldus sisaldab "Kasutamiseks:" koos 3–5 konkreetse kasutusjuhtumiga
- Muutujate kirjeldused loetlevad oodatud teabe tüübid, mitte lihtsalt "päring"
- Ei ole kattumist teise tööriista territooriumiga
- Testitud 2–3 ebamugava küsimusega Test paneelis, et kinnitada õiget suunamist
Näide: Toote otsing
Tööriista konfiguratsioon:
- Nimi:
ecommerce_product_search - Kirjeldus: Otsib tootekataloogist nime, kategooria või omaduse järgi. Kasutamiseks: konkreetse toote leidmine, toodete võrdlemine kategoorias, kontrollimine, kas toode eksisteerib, toote spetsifikatsioonide või hindade otsimine.
- Muutuja:
query— "Toote nimi, kategooria, omadus või hinnavahemik, mida otsida"
Voog:
- Käivitus: Vestlustööriist
- Tegevus: Otsi teadmiste baasi (
{{query}}) - Tegevus: Seadista vaatlus (tagasta tulemused)
Kasutaja vestlus:
Kasutaja: "Kas teil on juhtmevabu kõrvaklappe?"
AI: kutsus esile ecommerce_product_search koos query="juhtmevabad kõrvaklapid"
AI: "Jah! Leidsin 3 juhtmevaba kõrvaklappi. Sony WH-1000XM5 on meie parim müüja hinnaga 349 €..."
Näide: JIRA pilet
Tööriista konfiguratsioon:
- Nimi:
support_create_jira_ticket - Kirjeldus: Loob vestlusest JIRA tugipileti. Kasutamiseks: kui kasutaja teatab veast, palub funktsiooni või peab probleem tehnilisele meeskonnale edastama.
- Muutujad:
title— "Probleemi lühike kokkuvõte (1 lause)",description— "Üksikasjalik kirjeldus, sealhulgas reprodutseerimise sammud, oodatav käitumine ja tegelik käitumine"
Voog:
- Käivitus: Vestlustööriist
- Tegevus: AI päring (genereeri pealkiri/kirjeldus)
- Paralleel: Genereeri kirjeldus + pealkiri
- Tegevus: JIRA loo probleem
