Alat za Razgovor
Stvorite alat koji AI može koristiti tijekom razgovora. AI odlučuje kada ga pozvati na temelju konteksta.
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ške u JIRA-i
- Rezervacija termina
- Bilo koja prilagođena funkcionalnost
Konfiguracija
Osnovne Postavke
| Polje | Opis |
|---|---|
| Naziv 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 |
|---|---|
| Naziv Varijable | Interno ime (npr., query, orderId) |
| Opis | Pomaže AI-u da razumije što treba zatražiti |
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: naziv 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 samo može povećati ispravnu selekciju 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.
Naziv Alata
Koristite obrazac domain_action_target tako da samo ime razlikuje svaki alat:
| ❌ Nejasno | ✅ Jasno |
|---|---|
Pretraži | rgpd_legal_analysis |
search_docs | ecommerce_product_search |
Alat 2 | support_ticket_lookup |
AI koristi ime kao prvi filtar prije nego što pročita opis. Jasno ime omogućuje 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 koristili]
❌ 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,
pretraživanje 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čki 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čki upit | Pretraživački upit: vrsta 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 — što rezultira ciljanijim pretraživanjima i boljim rezultatima.
Izbjegavanje Sukoba Alata
Kada dva alata mogu odgovoriti na isto pitanje, AI oklijeva — i ponekad bira nasumično. Svaki alat mora pokriti isključivo područje.
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_legal_analysis | Zakonske članke, pravne obveze, prava | Nema praktičnih savjeta, nema stvarnih slučajeva |
compliance_methodology | Vodiči korak po korak, postupci revizije, okviri | Nema pravnog teksta, nema predložaka |
compliance_document_templates | Gotovi modeli, obrasci, klauzule ugovora | Nema metodologije, nema pravne analize |
compliance_business_processes | Operativni tijekovi, odobrenja | Nema pravnog teksta, samo unutarnji procesi |
compliance_operational_solutions | Konkretna rješenja, tehničke preporuke | Nema teorije, samo provediva rješenja |
Što su opisi svakog alata specifičniji u vezi s onim što pokrivaju, 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_product_search - Opis: Pretražuje katalog proizvoda prema imenu, kategoriji ili značajki. 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 korisnika:
Korisnik: "Imate li bežične slušalice?"
AI: poziva ecommerce_product_search 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 za podršku 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 (generiraj naslov/opis)
- Paralelno: Generiraj opis + naslov
- Akcija: JIRA Kreiraj Problem
