Pochopenie volania funkcií
Na tejto strane
Čo je volanie funkcií?
Volanie funkcií je jednou z najvýkonnejších funkcií API Grok. Umožňuje modelu požiadať o vykonanie funkcií, ktoré si definuješ, aby získal údaje alebo vykonal akcie v reálnom svete.
Kľúčový bod na pochopenie: Grok nikdy nevykonáva funkcie sám. Model analyzuje tvoju požiadavku, zistí, že potrebuje externé informácie, a vráti ti štruktúrovaný výzvu (názov funkcie + argumenty). Tvoj klientsky kód skutočne funkciu vykoná a potom pošle výsledok späť modelu.
6-krokový tok
Každá interakcia volania funkcie nasleduje presný šesťkrokový cyklus. Tento tok je fundamentálny – štruktúruje celú tvoju architektúru.
Definuj nástroje
Popíšeš svoje funkcie pomocou schém JSON: názov, popis, očakávané parametre.
Odošli požiadavku
Pošleš správu používateľa spolu s definíciami nástrojov do API.
Prijmi tool_call
Model vráti objekt tool_call s názvom funkcie a argumentmi vo formáte JSON.
Vykonaj funkciu
Tvoj klientsky kód vykoná skutočnú funkciu (volanie API, dotaz do databázy, výpočet...).
Vráť výsledok
Pošleš výsledok vykonania späť modelu v správe s rolou tool.
Záverečná odpoveď
Model integruje výsledok a vygeneruje odpoveď v prirodzenom jazyku pre používateľa.
Prečo je volanie funkcií také dôležité?
Bez volania funkcií je jazykový model obmedzený len na svoje trénovacie znalosti. Nemôže konzultovať databázu, dopytovať API tretích strán ani vykonávať výpočty v reálnom čase. Volanie funkcií rieši tento zásadný problém tým, že modelu poskytuje schopnosť interagovať s vonkajším svetom štruktúrovaným a kontrolovaným spôsobom.
Tu je niekoľko konkrétnych prípadov použitia:
- Údaje v reálnom čase: počasie, ceny akcií, stavy objednávok
- Obchodné akcie: vytvorenie tiketu, odoslanie e-mailu, rezervácia termínu
- Presné výpočty: matematické operácie, konverzie, agregácie
- Databázy: vyhľadávanie produktov, história zákazníkov, inventár
Rozdiel oproti štandardnému promptu
Pri štandardnej výmene sa opýtaš otázku a model priamo odpovie. Pri volaní funkcií môže model svoju odpoveď pozastaviť, aby si vyžiadal ďalšie informácie prostredníctvom volania funkcie. Práve táto schopnosť prerušiť tok generovania robí tento mechanizmus takým výkonným.
Model uvažuje takto: „Na zodpovedanie tejto otázky potrebujem aktuálne počasie v Paríži. Zavolám funkciu get_weather s parametrom city: Paris.“
Obmedzenia, ktoré treba poznať
API Grok akceptuje až 200 nástrojov na jednu požiadavku. To je pre väčšinu prípadov použitia viac než dosť, ale maj na pamäti, že každá definícia nástroja spotrebúva vstupné tokeny. Čím viac nástrojov deklaruješ, tým drahšia je požiadavka – a tým dlhšie trvá modelu, kým si vyberie správny nástroj.
Kľúčové poznatky
- Volanie funkcií umožňuje modelu požiadať o vykonanie funkcie, nie ju samotnému vykonať
- Tok vždy nasleduje 6 krokov: definuj, odošli, prijmi, vykonaj, vráť, odpovedz
- Funkcie sa vykonávajú na strane klienta, v tvojom kóde
- Maximálne 200 nástrojov na požiadavku
- Každá definícia nástroja spotrebúva tokeny – vyberaj ich uvedomelo