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

Instrumente integrate pentru API-ul Responses

Lecția 9 din 16 Actualizată 30 iulie 2026 Dezvoltator
Pe această pagină
  1. Adăugarea de capacități modelului
  2. Cele 4 tipuri de instrumente
  3. Combinarea mai multor instrumente
  4. Instrumente lato-server versus lato-client
  5. Puncte cheie

Adăugarea de capacități modelului

Modelele Grok nu se limitează la generarea de text. Prin parametrul tools, le puteți oferi acces la instrumente care le extind semnificativ capacitățile: căutare web în timp real, căutare pe X (fostul Twitter), executarea de cod Python și propriile dumneavoastră funcții personalizate.

web_search
Real-time web search
x_search
Search on X
code
Python Interpreter
function
Custom functions

Cele 4 tipuri de instrumente

Permite modelului să caute informații pe web în timp real:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "What's the latest news on AI in Europe?",
  "tools": [{"type": "web_search"}]
}

Modelul decide automat când să efectueze o căutare. Rezultatele sunt integrate în răspunsul său, însoțite de citări.

Caută postări pe X (fostul Twitter):

{
  "model": "grok-4.20-0309-reasoning",
  "input": "What is the tech community saying about the latest iPhone?",
  "tools": [{"type": "x_search"}]
}

Deosebit de util pentru a capta opinia publică, tendințele și reacțiile în timp real.

code_interpreter

Execută cod Python lato-server pentru calcule, analiză de date sau crearea de grafice:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Calculate the mean and standard deviation of these values: 12, 15, 18, 22, 9, 31",
  "tools": [{"type": "code_interpreter"}]
}

Modelul scrie cod Python, îl execută pe serverele xAI și integrează rezultatele în răspunsul său.

function

Propriile dumneavoastră funcții pe care modelul le poate apela. Modelul generează argumentele, dar codul dumneavoastră execută funcția:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "What's the weather in Paris?",
  "tools": [{
    "type": "function",
    "name": "get_weather",
    "description": "Retrieves the weather for a given city",
    "parameters": {
      "type": "object",
      "properties": {
        "city": {"type": "string", "description": "City name"},
        "unit": {"type": "string", "enum": ["celsius", "fahrenheit"]}
      },
      "required": ["city"]
    }
  }]
}

Combinarea mai multor instrumente

Puteți transmite până la 128 de instrumente într-o singură cerere. Modelul alege instrumentul (sau instrumentele) care se potrivesc:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Search for the latest Ligue 1 results and create a scoreboard.",
  "tools": [
    {"type": "web_search"},
    {"type": "code_interpreter"}
  ]
}

În acest exemplu, modelul ar putea utiliza mai întâi web_search pentru a găsi rezultatele, apoi code_interpreter pentru a le formata într-un tabel.

Instrumente lato-server versus lato-client

Distincția este fundamentală:

  • Instrumente lato-server (web_search, x_search, code_interpreter): Executate automat de serverele xAI. Nu trebuie să faceți nimic; modelul lansează căutarea sau codul, preia rezultatul și îl integrează în răspunsul său.

  • Instrumente lato-client (function): Modelul generează un apel de funcție cu argumente, apoi întrerupe generarea. Codul dumneavoastră execută funcția, iar dumneavoastră trimiteți rezultatul înapoi într-o nouă cerere.

Această diferență impactează direct arhitectura aplicației dumneavoastră, așa cum veți vedea în lecțiile următoare.

Puncte cheie

  • Patru tipuri de instrumente: web_search, x_search, code_interpreter, function
  • Primele trei rulează lato-server – nu necesită infrastructură din partea dumneavoastră
  • Instrumentele de tip function rulează lato-client – codul dumneavoastră gestionează execuția
  • Puteți combina până la 128 de instrumente per cerere
  • Modelul decide automat când și ce instrumente să utilizeze