Activarea căutării web în API-ul Grok
Pe această pagină
Actualizat la 2 noiembrie 2026. Conform documentației xAI: cu
xai-sdk, căutarea web se activează prin funcțiaweb_search()importată dinxai_sdk.tools, în cadrul unei conversații create declient.chat.create; vechiul exemplu apelaclient.tools.web_search(), care nu există în acest SDK. Sursă: Web Search.
Actualizat la 3 noiembrie 2026. Primul exemplu apela
client.responses.create()pe clientulxai-sdk, care nu are atributulresponses: cu acest SDK, căutarea trece princlient.chat.create(..., tools=[web_search()]), iarclient.responses.create()aparține SDK-uluiopenaiindicat cătrehttps://api.x.ai/v1. Exemplul Vercel AI SDK transmitea instrumentele sub formă de array și nu importagenerateText: acestea sunt declarate într-un obiect, conform documentației xAI. Cod verificat cuxai-sdk1.21.0 șiopenai3.42.1. Sursă: Web Search.
De ce să conectați Grok la web în timp real
Modelele lingvistice clasice lucrează cu cunoștințe înghețate la data antrenamentului lor. Pentru un dezvoltator care construiește aplicații ce necesită date actuale (prețuri bursiere, știri, rezultate sportive, vreme), această limitare este un impediment major. Instrumentul web_search din API-ul Grok rezolvă această problemă, permițând modelului să interogheze web-ul în timp real, direct din apelul API.

Spre deosebire de alți furnizori care necesită integrări terțe sau plugin-uri separate, xAI oferă căutarea web ca un instrument integrat lato sensu (server-side). Nu aveți nicio infrastructură de gestionat: modelul decide când să caute, execută interogarea și integrează rezultatele în răspunsul său.
API-ul Responses: Singurul endpoint suportat
Căutarea web funcționează exclusiv pe API-ul Responses. Vechiul endpoint Chat Completions oferea un parametru search_parameters, dar acesta este acum depreciat. Dacă migrați de la vechiul API, va trebui să vă adaptați apelurile.
Activarea se face prin adăugarea instrumentului web_search în array-ul tools din cererea dumneavoastră:
import os
from openai import OpenAI
client = OpenAI(api_key=os.environ["XAI_API_KEY"], base_url="https://api.x.ai/v1")
response = client.responses.create(
model="grok-4.5",
input="What is the weather like in Paris today?",
tools=[{"type": "web_search"}],
)
print(response.output_text)
Acest exemplu utilizează SDK-ul openai, compatibil cu API-ul Responses xAI; SDK-ul nativ xAI, prezentat mai jos, trece printr-o conversație.
Atât tot. Modelul analizează promptul dumneavoastră, determină dacă are nevoie de informații proaspete și declanșează căutarea automat. Nu trebuie să gestionați nicio buclă de apeluri sau logică condițională.
Fluxul de execuție în cinci pași
Când trimiteți o cerere cu web_search activat, procesul urmează o secvență specifică:
- Analiză: modelul evaluează dacă întrebarea necesită date recente
- Decizie: alege să caute sau să răspundă folosind cunoștințele interne
- Execuție: căutarea web rulează lato sensu pe server (nu gestionați nimic)
- Procesare: rezultatele sunt analizate și sintetizate
- Răspuns: textul final este generat împreună cu citările asociate
Acest mecanism înseamnă că modelul poate decide să nu caute dacă întrebarea nu justifică acest lucru. De exemplu, întrebarea despre definiția fotosintezei probabil nu va declanșa o căutare web.
Utilizarea cu diferite SDK-uri
SDK-ul xAI oferă o funcție dedicată, web_search(), de transmis în lista de instrumente a conversației:
# Native xAI SDK
from xai_sdk import Client
from xai_sdk.chat import user
from xai_sdk.tools import web_search
client = Client()
chat = client.chat.create(model="grok-4.5", tools=[web_search()])
chat.append(user("Latest AI news in Europe"))
response = chat.sample()
print(response.content)
print(response.citations)
Cu SDK-ul openai, este vorba despre apelul de la începutul lecției: client.responses.create() cu base_url="https://api.x.ai/v1" și tools=[{"type": "web_search"}].
Pentru Vercel AI SDK în JavaScript:
import { xai } from '@ai-sdk/xai';
import { generateText } from 'ai';
const { text, sources } = await generateText({
model: xai.responses('grok-4.5'),
prompt: "Latest AI news in Europe",
tools: {
web_search: xai.tools.webSearch(),
},
});
console.log(text);
console.log('Citations:', sources);
Exercițiu practic
Creați un script care interoghează Grok despre un eveniment actual la alegerea dumneavoastră. Verificați dacă răspunsul conține informații recente (date, evenimente petrecute după data de cutoff a modelului). Apoi încercați aceeași întrebare fără instrumentul web_search pentru a observa diferența.
Puncte cheie
- Căutarea web se activează cu
{"type": "web_search"}întools(SDKopenai, API Responses) sauweb_search()înclient.chat.create(xai-sdk) - Funcționează doar pe API-ul Responses (nu pe Chat Completions)
- Modelul decide autonom când are nevoie să caute
- Citările sunt incluse automat în răspuns
- Costul este de 5 USD per 1.000 de apeluri de instrumente, plus token-ii consumați