Cele două categorii de instrumente Grok
Pe această pagină
Înțelegeți ecosistemul de instrumente API Grok
API-ul Grok face mai mult decât să genereze text. Acesta oferă un set de instrumente care permit modelului să interacționeze cu lumea exterioară: căutarea de informații în timp real, analiza datelor de pe rețelele sociale sau executarea de cod Python. Pentru a valorifica aceste capacități, trebuie să înțelegeți modul în care sunt organizate.
API-ul Grok distinge două categorii fundamentale de instrumente. Această distincție determină cine execută instrumentul, unde are loc procesarea și ce trebuie să gestionați în calitate de dezvoltator.
Instrumente integrate — Lato server
Instrumentele integrate rulează direct pe serverele xAI. Atunci când modelul decide să utilizeze unul dintre aceste instrumente, execuția este automată și transparentă. Nu trebuie să gestionați nicio infrastructură și nici să procesați rezultate intermediare.
Iată cele cinci instrumente integrate disponibile:
- Web Search (
web_search): Căutare web în timp real, cu filtrare pe domenii și citări automate - X Search (
x_search): Căutare pe X/Twitter, cu filtrare pe cont și dată - Code Execution (
code_interpreter/code_execution): Executarea codului Python într-un mediu izolat și securizat (sandbox) - Collections Search (
collections_search/file_search): Căutare în documentele pe care le-ați încărcat anterior - Remote MCP (
mcp): Conectarea la servere MCP externe (Model Context Protocol)
Pentru a activa un instrument integrat, adăugați-l pur și simplu în tabloul tools din cererea dumneavoastră:
{
"tools": [{"type": "web_search"}]
}
Apelarea funcțiilor (Function Calling) — Lato client
Apelarea funcțiilor funcționează diferit. Definiți funcții personalizate pe care modelul le poate apela. Dar, spre deosebire de instrumentele integrate, codul dumneavoastră de pe partea client este cel care execută funcția și returnează rezultatul către model.
Fluxul este următorul:
- Descrieți funcțiile dumneavoastră (nume, parametri, descriere) în cerere
- Modelul analizează solicitarea utilizatorului
- Dacă stabilește că este necesară o funcție, returnează un apel de funcție cu argumente
- Codul dumneavoastră execută funcția (apel API, interogare bază de date, calcul etc.)
- Trimiteți rezultatul înapoi la model
- Modelul formulează răspunsul final
Această abordare vă oferă control total: decideți ce fac funcțiile dumneavoastră, ce date gestionează și cum se conectează la infrastructura dumneavoastră.
Când să utilizați fiecare categorie
Instrumentele integrate sunt ideale atunci când aveți nevoie de acces la informații în timp real (web, rețele sociale) sau când trebuie să rulați calcule fără a gestiona infrastructura. Apelarea funcțiilor este preferabilă atunci când trebuie să interacționați cu propriile sisteme: baze de date interne, API-uri de afaceri sau orice serviciu specific aplicației dumneavoastră.
Puteți combina ambele categorii într-o singură cerere. De exemplu, puteți activa Web Search definind în același timp o funcție personalizată care salvează rezultatele în baza dumneavoastră de date.
Puncte cheie
- API-ul Grok oferă două categorii de instrumente: instrumente integrate (executate de xAI) și apelarea funcțiilor (executate de codul dumneavoastră)
- Instrumentele integrate nu necesită nicio infrastructură lato client
- Apelarea funcțiilor oferă control total, dar necesită mai multă dezvoltare
- Ambele categorii pot fi combinate într-o singură cerere
- Acest curs se concentrează pe cele trei principale instrumente integrate: Web Search, X Search și Code Execution