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

Cele două categorii de instrumente Grok

Lecția 1 din 16 Actualizată 30 iulie 2026 Dezvoltator
Pe această pagină
  1. Înțelegeți ecosistemul de instrumente API Grok
  2. Instrumente integrate — Lato server
  3. Apelarea funcțiilor (Function Calling) — Lato client
  4. Când să utilizați fiecare categorie
  5. Puncte cheie

Înțelegeți ecosistemul de instrumente API Grok

Prezentare generală a instrumentelor din documentație 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.

🔍
Web Search
Real-time web search
𝕏
X Search
Search on X/Twitter
🐍
Code Execution
Isolated Python sandbox
📁
Collections Search
Search within your documents
🔌
Remote MCP
External MCP servers

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:

  1. Descrieți funcțiile dumneavoastră (nume, parametri, descriere) în cerere
  2. Modelul analizează solicitarea utilizatorului
  3. Dacă stabilește că este necesară o funcție, returnează un apel de funcție cu argumente
  4. Codul dumneavoastră execută funcția (apel API, interogare bază de date, calcul etc.)
  5. Trimiteți rezultatul înapoi la model
  6. 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