Funktsioonide kutsumise mõistmine
Sellel lehel
Mis on funktsioonide kutsumine?
Funktsioonide kutsumine on Grok API üks võimsamaid funktsioone. See võimaldab mudelil taotleda sinu defineeritud funktsioonide käivitamist, et hankida andmeid või sooritada toiminguid reaalses maailmas.
Oluline on mõista järgmist: Grok ise kunagi funktsioone ei käivita. Mudel analüüsib sinu päringut, teeb kindlaks, et tal on vaja välist teavet, ja tagastab sulle struktureeritud kutse (funktsiooni nimi + argumendid). Tegelikult käivitab funktsiooni sinu kliendipoolne kood, mis saadab seejärel tulemuse mudelile tagasi.
6-etapiline voog
Iga funktsioonide kutsumise interaktsioon järgib täpset kuueetapilist tsüklit. See voog on fundamentaalne – see struktureerib kogu sinu arhitektuuri.
Määratle tööriistad
Kirjeldad oma funktsioone JSON skeemidega: nimi, kirjeldus, oodatavad parameetrid.
Saada päring
Saadad kasutaja sõnumi koos tööriistade definitsioonidega API-le.
Võta vastu tool_call
Mudel tagastab tool_call objekti koos funktsiooni nime ja JSON-argumentidega.
Käivita funktsioon
Sinu kliendipoolne kood käivitab tegeliku funktsiooni (API päring, andmebaasipäring, arvutus jne).
Tagasta tulemus
Saadad täitmise tulemuse mudelile tagasi sõnumina, mille rolliks on tool.
Lõplik vastus
Mudel integreerib tulemuse ja genereerib kasutajale loomuliku keele vastuse.
Miks on funktsioonide kutsumine nii oluline?
Ilma funktsioonide kutsumiseta on keelemudel piiratud oma treeningu käigus omandatud teadmistega. See ei saa konsulteerida andmebaasi, pärida kolmanda osapoole API-t ega teha reaalajas arvutusi. Funktsioonide kutsumine lahendab selle fundamentaalse probleemi, andes mudelile võime suhelda välismaailmaga struktureeritud ja kontrollitud viisil.
Siin on mõned konkreetsed kasutusjuhtumid:
- Reaalajas andmed: ilm, aktsiahinnad, tellimuste olekud
- Äritegevused: pileti loomine, e-kirja saatmine, aja broneerimine
- Täpsed arvutused: matemaatilised tehted, teisendused, agregeerimised
- Andmebaasid: tooteotsing, kliendi ajalugu, laoseis
Erinevus tavapärasest vihjest
Tavalises vahetuses esitad küsimuse ja mudel vastab otse. Funktsioonide kutsumise korral võib mudel oma vastuse peatada, et taotleda funktsioonikutsu kaudu lisateavet. Just see võime katkestada genereerimisvoog teeb mehhanismi nii võimsaks.
Mudel arutleb nii: „Sellele küsimusele vastamiseks vajaksin Pariisi praegust ilma. Kutsun funktsiooni get_weather parameetriga city: Paris.“
Piirangud, mida tasub teada
Grok API aktsepteerib ühe päringu kohta kuni 200 tööriista. Enamiku kasutusjuhtumite jaoks on sellest enam kui küll, kuid pea meeles, et iga tööriista definitsioon tarbib sisendtokeneid. Mida rohkem tööriistu deklareerid, seda kallimaks päring muutub ja seda kauem aega kulub mudelil õige tööriista valimiseks.
Peamised punktid
- Funktsioonide kutsumine võimaldab mudelil taotleda funktsioonide käivitamist, mitte neid ise käivitada
- Voog järgib alati 6 sammu: määratle, saada, võta vastu, käivita, tagasta, vasta
- Funktsioonid käivituvad kliendipoolselt, sinu koodis
- Maksimaalselt 200 tööriista päringu kohta
- Iga tööriista definitsioon tarbib tokeneid – ole valikuline