Activarea căutării pe web în API
Pe această pagină
Actualizat la 2 noiembrie 2026. Conform documentației xAI: cu
xai-sdk, căutarea pe web se activează prin funcțiaweb_search()importată dinxai_sdk.tools, într-o conversație creată declient.chat.create; vechiul exemplu care apelaclient.tools.web_search()șiclient.responses.createnu există în acest SDK. Sursă: Web Search.
Oferiți-i lui Grok acces la web în timp real
Căutarea pe web este instrumentul integrat cel mai utilizat în API-ul Grok. Acesta permite modelului să caute informații actualizate pe internet, depășind limita naturală a datelor sale de antrenament. Activarea este simplă, dar există aspecte esențiale de stăpânit pentru o utilizare eficientă.
Condiții prealabile: API-ul Responses
Căutarea pe web este disponibilă exclusiv prin API-ul Responses. Vechiul API Chat Completions oferea un sistem numit „Live Search“, care este acum depreciat. Dacă utilizați încă Chat Completions pentru căutarea pe web, trebuie să migrați către API-ul Responses.
API-ul Responses utilizează client.responses.create() în loc de client.chat.completions.create(). Structura cererii și a răspunsului diferă, dar atât SDK-ul xAI, cât și SDK-ul OpenAI le suportă.
Activarea de bază
Activați căutarea pe web adăugând un obiect {"type": "web_search"} în tabloul tools din cererea dumneavoastră:
{
"model": "grok-4.20-0309-reasoning",
"input": "Care sunt cele mai recente progrese în inteligența artificială?",
"tools": [
{"type": "web_search"}
]
}
Acest lucru este suficient pentru o căutare web de bază. Modelul determină automat dacă este necesară o căutare și formulează interogarea optimă pe baza mesajului utilizatorului.
Activarea cu SDK-ul xAI (Python)
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.20-0309-reasoning",
tools=[web_search()],
)
chat.append(user("Care sunt cele mai recente progrese în IA?"))
response = chat.sample()
print(response.content)
print(response.citations)
SDK-ul pune la dispoziție funcția web_search(), care generează obiectul de configurare al instrumentului. Aceasta acceptă, de asemenea, parametrii allowed_domains sau excluded_domains – până la cinci domenii, dar niciodată ambele în aceeași cerere.
Activarea cu SDK-ul OpenAI
from openai import OpenAI
client = OpenAI(
api_key="xai-your-key",
base_url="https://api.x.ai/v1"
)
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Care sunt cele mai recente progrese în IA?",
tools=[{"type": "web_search"}]
)
SDK-ul OpenAI funcționează cu API-ul Grok prin simpla modificare a base_url. Sintaxa instrumentului rămâne identică.
Activarea cu SDK-ul Vercel AI
import { xai } from "@ai-sdk/xai";
const response = await generateText({
model: xai("grok-4.20-0309-reasoning"),
prompt: "Care sunt cele mai recente progrese în IA?",
tools: [xai.tools.webSearch()]
});
SDK-ul Vercel AI utilizează xai.tools.webSearch() respectând convenția camelCase din JavaScript.
Combinarea căutării pe web cu alte instrumente
Puteți activa mai multe instrumente simultan. Modelul va alege instrumentul cel mai potrivit sau le va utiliza secvențial:
{
"tools": [
{"type": "web_search"},
{"type": "code_interpreter"}
]
}
În acest exemplu, modelul poate căuta date pe web și apoi le poate analiza prin Executarea de Cod.
Puncte cheie
- Căutarea pe web este disponibilă exclusiv prin API-ul Responses – Chat Completions este depreciat pentru această funcționalitate
- Activați-o adăugând
{"type": "web_search"}în tabloultools - Modelul decide automat când și cum să efectueze căutarea
- Toate SDK-urile (xAI, OpenAI, Vercel AI) suportă căutarea pe web
- Puteți activa mai multe instrumente simultan în aceeași cerere