Alat za Razgovor
Stvorite alat koji AI može koristiti tijekom razgovora. AI odlučuje kada ga pozvati na temelju konteksta.
Neka vaš AI agent RADI · izgradite svoj prvi alat
Kada Koristiti
Koristite ovaj okidač za proširenje onoga što vaš AI može učiniti:
- Pretraživanje proizvoda u vašem katalogu
- Provjera statusa narudžbe u vašem sustavu
- Pretraživanje podataka o kupcima u CRM-u
- Kreiranje podržanih tiketa u JIRA-i
- Rezervacija termina
- Bilo koja prilagođena funkcionalnost
Konfiguracija
Osnovne Postavke
| Polje | Opis |
|---|---|
| Ime Alata | Ime koje je lako razumjeti (prikazano u Biblioteci Čvorova) |
| Opis | Objašnjava kada/kako AI treba koristiti ovaj alat |
Ciljanje Korisnika
Odaberite tko može koristiti ovaj alat:
| Opcija | Opis |
|---|---|
| Svi Korisnici | Anonimni + povezani korisnici |
| Samo Povezani Korisnici | Samo prijavljeni korisnici |
| Pristup Temeljen na Ulogama | Specifične korisničke uloge |
Varijable Alata
Definirajte parametre koje AI treba prikupiti od korisnika:
| Polje | Opis |
|---|---|
| Ime Varijable | Interno ime (npr., query, orderId) |
| Opis | Pomaže AI-u da razumije što treba pitati |
Varijable postaju dostupne kao {{variableName}} u vašem toku.
Kako To Funkcionira
- Definirate alat s imenom, opisom i varijablama
- AI uči kada ga koristiti iz vašeg opisa
- Korisnik pita nešto povezano (npr., "Pronađi mi laptop")
- AI prikuplja potrebne varijable razgovorno
- Tok se pokreće s prikupljenim podacima
- Rezultat se vraća AI-u za konačni odgovor
Imenovanje Vaših Alata: Zašto je To Važno
Kada vaš AI asistent ima pristup više alata, bira koji će pozvati na temelju samo tri stvari: ime alata, opis alata i opisi varijabli. Ne može vidjeti što je unutar toka — čita tekst i odlučuje.
Ako su ta tri polja nejasna ili previše slična među alatima, AI će odabrati pogrešan alat. Istraživanja o pozivanju funkcija LLM-a pokazuju da poboljšanje jasnoće opisa može povećati točnost odabira alata za 15–20 postotnih bodova, bez promjene osnovnog modela.
To je posebno kritično kada imate nekoliko alata koji pretražuju različite baze znanja — iz perspektive AI-a, svi "pretražuju informacije." Ime i opis su jedini način na koji ih može razlikovati.
Ime Alata
Koristite obrazac domain_action_target tako da samo ime razlikuje svaki alat:
| ❌ Nejasno | ✅ Jasno |
|---|---|
Pretraži | rgpd_pravna_analiza |
search_docs | ecommerce_pretraga_proizvoda |
Alat 2 | pregled_tiketa_podrške |
AI koristi ime kao prvi filtar prije nego što pročita opis. Jasno ime omogućava mu da odmah suzi izbor; generičko ime prisiljava ga da nagađa.
Opis Alata
Opis je vaša najmoćnija poluga. Koristite ovu formulu:
[Što radi — 1 rečenica]
Koristite za: [3–5 konkretnih slučajeva upotrebe s riječima koje bi vaši korisnici zapravo rekli]
❌ Loše:
Pretražuje bazu znanja za informacije.
✅ Dobro:
Pretražuje sankcije CNIL-a i presude CJUE-a.
Koristite za: pronalaženje odluka o kaznama po sektoru ili vrsti prekršaja,
provjeru iznosa kazni, citiranje pravnih presedana,
procjenu financijskog rizika neusklađenosti s RGPD-om.
Riječi unutar "Koristite za" djeluju kao semantički okidači. Kada korisnička poruka sadrži "kaznu", "penal" ili "rizik", AI odmah to povezuje s ovim alatom.
Opisi Varijabli
Varijabla opisana kao "Pretraživačka upit" ne govori AI-u ništa. Svaki put će zalijepiti korisničko sirovo pitanje. Bolji opis usmjerava AI da izvuče prave ključne riječi prije nego što ih pošalje.
| ❌ Nejasno | ✅ Jasno |
|---|---|
Pretraživačka upit | Pretraživačka upit: tip prekršaja, naziv tvrtke, sektor, iznos kazne ili pravni koncept |
Korisnički unos | Tip dokumenta koji se traži: predložak, model, obrazac, klauzula ili ugovor |
To potiče AI da reformulira umjesto da kopira cijelu poruku korisnika — rezultirajući u ciljanijim pretraživanjima i boljim rezultatima.
Izbjegavanje Sukoba Alata
Kada dva alata mogu odgovoriti na isto pitanje, AI oklijeva — i ponekad nasumično bira. Svaki alat mora pokriti ekskluzivnu teritoriju.
Pravilo: ako možete smisliti korisničko pitanje koje bi moglo ići bilo kojem alatu, vaši opisi trebaju više preciznosti.
Primjer — 5 alata za usklađenost s jasnim granicama:
| Alat | Pokriva | NE pokriva |
|---|---|---|
compliance_pravna_analiza | Pravni članci, pravne obveze, prava | Nema praktičnih savjeta, nema stvarnih slučajeva |
compliance_metodologija | Vodiči korak po korak, postupci revizije, okviri | Nema pravnog teksta, nema predložaka |
compliance_dokument_predlošci | Gotovi modeli, obrasci, klauzule ugovora | Nema metodologije, nema pravne analize |
compliance_poslovni_procesi | Operativni tijekovi rada, odobrenja | Nema pravnog teksta, samo interni procesi |
compliance_operativna_rješenja | Konkretna rješenja, tehničke preporuke | Nema teorije, samo provediva rješenja |
Što su opisi specifičniji o tome što alat pokriva, to je manje nejasnoća. Ne trebate pisati eksplicitne isključenja — preciznost obavlja posao.
Brza Provjera
Prije objavljivanja toka s okidačem Alata za Razgovor, provjerite:
- Ime slijedi
domain_action_target— razlikuje se bez čitanja opisa - Opis počinje s onim što alat radi u 1 rečenici
- Opis uključuje "Koristite za:" s 3–5 konkretnih slučajeva upotrebe
- Opisi varijabli navode vrste očekivanih informacija, a ne samo "upit"
- Nema preklapanja s teritorijom drugog alata
- Testirano s 2–3 nejasna pitanja u Test panelu kako bi se potvrdilo ispravno usmjeravanje
Primjer: Pretraživanje Proizvoda
Konfiguracija Alata:
- Ime:
ecommerce_pretraga_proizvoda - Opis: Pretražuje katalog proizvoda po imenu, kategoriji ili značajci. Koristite za: pronalaženje specifičnog proizvoda, usporedbu proizvoda u kategoriji, provjeru postoji li proizvod, pretraživanje specifikacija ili cijena proizvoda.
- Varijabla:
query— "Naziv proizvoda, kategorija, značajka ili raspon cijena za pretraživanje"
Tok:
- Okidač: Alat za Razgovor
- Akcija: Pretraži Bazu Znanja (
{{query}}) - Akcija: Postavi Promatranje (vrati rezultate)
Razgovor s korisnikom:
Korisnik: "Imate li bežične slušalice?"
AI: poziva ecommerce_pretraga_proizvoda s query="bežične slušalice"
AI: "Da! Pronašao sam 3 bežične slušalice. Sony WH-1000XM5 je naš bestseler po cijeni od 349 €..."
Primjer: JIRA Tiket
Konfiguracija Alata:
- Ime:
support_create_jira_ticket - Opis: Kreira JIRA tiket podrške iz razgovora. Koristite za: kada korisnik prijavi grešku, zatraži značajku ili treba eskalirati problem tehničkom timu.
- Varijable:
title— "Kratki sažetak problema (1 rečenica)",description— "Detaljan opis uključujući korake za reprodukciju, očekivano ponašanje i stvarno ponašanje"
Tok:
- Okidač: Alat za Razgovor
- Akcija: AI Zahtjev (generirati naslov/opis)
- Paralelno: Generirati opis + naslov
- Akcija: JIRA Kreiraj Problem
