Salt la conținutul principal
Română— Alege o limbă
Meniu

Înțelegerea apelului de funcții

Lecția 1 din 14 Actualizată 29 iulie 2026 Dezvoltator
Pe această pagină
  1. Ce este apelul de funcții?
  2. Fluxul în 6 pași
  3. De ce este apelul de funcții atât de important?
  4. Diferența față de un prompt standard
  5. Limite de cunoscut
  6. Puncte cheie

Ce este apelul de funcții?

Apelul de funcții este una dintre cele mai puternice funcționalități ale API-ului Grok. Acesta permite modelului să solicite executarea unor funcții pe care le-ați definit, pentru a prelua date sau pentru a efectua acțiuni în lumea reală.

Punctul esențial de reținut: Grok nu execută niciodată funcțiile direct. Modelul analizează cererea dumneavoastră, stabilește că are nevoie de informații externe și vă returnează un apel structurat (numele funcției + argumente). Codul dumneavoastră lato-client este cel care execută efectiv funcția, apoi trimite rezultatul înapoi către model.

Fluxul în 6 pași

Fiecare interacțiune bazată pe apelul de funcții urmează un ciclu precis de șase pași. Acest flux este fundamental – el structurează întreaga dumneavoastră arhitectură.

1

Definirea instrumentelor

Descrieți funcțiile dumneavoastră folosind scheme JSON: nume, descriere, parametri așteptați.

2

Trimiterea cererii

Trimiteți mesajul utilizatorului împreună cu definițiile instrumentelor către API.

3

Recepționarea tool_call

Modelul returnează un obiect tool_call care conține numele funcției și argumentele în format JSON.

4

Executarea funcției

Codul dumneavoastră lato-client execută funcția propriu-zisă (apel API, interogare bază de date, calcul etc.).

5

Returnarea rezultatului

Trimiteți rezultatul execuției înapoi către model într-un mesaj cu rolul „tool“.

6

Răspunsul final

Modelul integrează rezultatul și generează un răspuns în limbaj natural pentru utilizator.

De ce este apelul de funcții atât de important?

Fără apelul de funcții, un model lingvistic este limitat la cunoștințele din perioada sa de antrenament. Acesta nu poate consulta o bază de date, nu poate interoga un API terț și nu poate efectua calcule în timp real. Apelul de funcții rezolvă această problemă fundamentală, oferind modelului capacitatea de a interacționa cu lumea exterioară într-un mod structurat și controlat.

Iată câteva cazuri de utilizare concrete:

  • Date în timp real: vremea, prețurile acțiunilor, starea comenzilor
  • Acțiuni de business: crearea unui tichet, trimiterea unui e-mail, rezervarea unui interval orar
  • Calcule precise: operațiuni matematice, conversii, agregări
  • Baze de date: căutare produse, istoric clienți, inventar

Diferența față de un prompt standard

Într-un schimb standard, puneți o întrebare, iar modelul răspunde direct. Cu apelul de funcții, modelul își poate întrerupe răspunsul pentru a solicita informații suplimentare printr-un apel de funcție. Această capacitate de a întrerupe fluxul de generare este ceea ce face mecanismul atât de puternic.

Modelul raționează astfel: „Pentru a răspunde la această întrebare, am nevoie de vremea actuală din Paris. Voi apela funcția get_weather cu parametrul city: Paris.“

Limite de cunoscut

API-ul Grok acceptă până la 200 de instrumente per cerere. Aceasta este o cifră suficientă pentru majoritatea cazurilor de utilizare, dar rețineți că fiecare definiție de instrument consumă tokeni de intrare. Cu cât declarați mai multe instrumente, cu atât cererea devine mai costisitoare – iar modelul va necesita mai mult timp pentru a alege instrumentul potrivit.

Puncte cheie

  • Apelul de funcții permite modelului să solicite executarea funcțiilor, nu să le execute el însuși
  • Fluxul urmează întotdeauna 6 pași: definire, trimitere, recepție, executare, returnare, răspuns
  • Funcțiile se execută lato-client, în codul dumneavoastră
  • Maximum 200 de instrumente per cerere
  • Fiecare definiție de instrument consumă tokeni – fiți selectivi