Orodja agenta (pregled)

Orodja agenta dajo vašemu AI prilagojena zmogljivosti. Namesto da bi odgovarjal le iz besedila, ki ga pozna, lahko AI med sestavljanjem odgovora pokliče vaše sisteme — na primer, da "preveri status naročila" ali "pogleda datum dostave" — in rezultat vključi v odgovor. Ta vodnik je konceptualni, na naloge osredotočen pregled: kaj so orodja, dve vrsti, kako ustvariti orodje, kako napisati opis, ki ga AI dejansko dobro uporablja, uvoz iz OpenAPI in dodelitev orodij kanalom. Za specifikacije o končnih točkah, varnosti in JSON Schema glejte vodnik za integratorje, na katerega je navedena povezava.

Orodja najdete v razdelku Nastavitve → Orodja agenta (pot /settings/agent-tools). Za upravljanje orodij agenta je potrebna vloga OWNER ali ADMIN; agenti in gledalci jih lahko na splošno berejo.

Kaj je orodje agenta#

Orodje je prilagojena zmogljivost, ki jo dodate AI. Ko sporočilo stranke zahteva žive ali računsko-specifične informacije — na primer status njenega naročila — lahko AI pokliče orodje, prejme dejanske podatke in jih uporabi za napisati natančen odgovor. S tem AI spremenite iz nečesa, kar pozna le vašo dokumentacijo, v nekaj, kar lahko deluje v vašem imenu znotraj meja, ki jih določite.

Dve vrsti orodij#

Strežniška stran (SERVER_SIDE)

HelpStack pokliče HTTP končno točko, ki jo zagotovite vi. Določite:

• Ime
• Opis (glejte Pisanje odličnega opisa — to je najpomembnejše polje)
• URL vaše končne točke
• Metoda HTTP
• Neobvezne glave
• Shemo JSON parametrov, ki opisuje vnose, ki jih mora AI zagotoviti

To je pogost primer: HelpStack se obrne na vaše zaledne sisteme, ki vrnejo podatke.

Stran odjemalca (CLIENT_SIDE)

Orodje se izvaja v brskalniku obiskovalca spletnega mesta in ne na vašem strežniku. To je napredno — po njem posezite le, ko mora dejanje resnično potekati v brskalnikovem kontekstu obiskovalca.

Ustvarjanje in upravljanje orodij#

V razdelku Nastavitve → Orodja agenta lahko:

• Ustvarite orodje (izberite njegovo vrsto in izpolnite polja).
• Uredite obstoječe orodje.
• Izbrišete orodje.
• Preklopite orodje na Aktivno / neaktivno brez brisanja.

Klici orodij so zabeleženi, tako da lahko pregledate, kaj je AI poklicalo.

Pisanje odličnega opisa#

Opis je ključnega pomena — to je tisto, kar AI prebere, da se odloči, kdaj poklicati orodje. Napišite ga kot navodila za novega sodelavca, ki vaših sistemov še ni videl:

• Povejte, kdaj ga uporabiti in za kaj je namenjeno.
• Povejte, katere informacije so potrebne za klic.

Dober primer:

"Uporabite, ko stranka vpraša za status obstoječega naročila. Zahteva številko naročila."

Tu bi bil ORDER_NUMBER eden od parametrov, definiranih v shemi JSON parametrov orodja. Nejasen opis povzroči, da AI pokliče orodje ob napačnem času ali ga v celoti preskoči; jasen opis ga naredi zanesljivega.

Uvoz iz OpenAPI#

Če vaši sistemi že imajo specifikacijo OpenAPI, vam ni treba definirati orodij eno za drugim. Uporabite možnost "Uvozi iz OpenAPI" in posredujte svojo specifikacijo — HelpStack ustvari orodja iz nje. To je najhitrejši način za izpostavitev obstoječega API AI.

Orodja za celotno organizacijo in orodja za posamezen kanal#

• Orodja so lahko definirana na ravni celotne organizacije, tako da so na voljo povsod.
• Orodja so lahko tudi dodeljena ali prepisana za vsak kanal posebej v razdelku Nastavitve → Kanali → kanal → Orodja.

To pomeni, da lahko ohranite skupen nabor orodij in hkrati prilagodite, katera orodja določen kanal lahko uporablja — na primer, orodje za iskanje naročil izpostavite samo na vašem kanalu za podporo.

Kam po več podrobnosti#

Ta vodnik je namerno konceptualen. Za tehnične podrobnosti — pogodbe o končnih točkah, avtentikacijo in varnost, glave ter pisanje sheme JSON parametrov — glejte vodnik za integratorje:

• Prilagojena orodja agenta (vodnik za integratorje)

Povezano#

• Prilagojena orodja agenta (vodnik za integratorje) — specifikacije o končnih točkah, varnosti in JSON Schema.
• Kanali — dodelite ali prepišite orodja za vsak kanal v zavihku Orodja.
• Ponudniki AI — model, ki se odloča, kdaj poklicati vaša orodja.
• AI odgovori — kako orodja sodijo v sestavljanje odgovora.
• Baza znanja — utemeljite odgovore na svoji vsebini (orodja zagotavljajo žive podatke).
• Glosar — definicije strežniške strani, strani odjemalca, OpenAPI in več.