Instrumente integrate pentru API-ul Responses
Pe această pagină
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.
Cele 4 tipuri de instrumente
web_search
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.
x_search
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
functionrulează 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