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

Activarea căutării web în API-ul Grok

Lecția 1 din 14 Actualizată 3 noiembrie 2026 Începător
Pe această pagină
  1. De ce să conectați Grok la web în timp real
  2. API-ul Responses: Singurul endpoint suportat
  3. Fluxul de execuție în cinci pași
  4. Utilizarea cu diferite SDK-uri
  5. Exercițiu practic
  6. Puncte cheie

Actualizat la 2 noiembrie 2026. Conform documentației xAI: cu xai-sdk, căutarea web se activează prin funcția web_search() importată din xai_sdk.tools, în cadrul unei conversații create de client.chat.create; vechiul exemplu apela client.tools.web_search(), care nu există în acest SDK. Sursă: Web Search.

Actualizat la 3 noiembrie 2026. Primul exemplu apela client.responses.create() pe clientul xai-sdk, care nu are atributul responses: cu acest SDK, căutarea trece prin client.chat.create(..., tools=[web_search()]), iar client.responses.create() aparține SDK-ului openai indicat către https://api.x.ai/v1. Exemplul Vercel AI SDK transmitea instrumentele sub formă de array și nu importa generateText: acestea sunt declarate într-un obiect, conform documentației xAI. Cod verificat cu xai-sdk 1.21.0 și openai 3.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.

Căutare web cu Grok

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.

$5
per 1,000 calls
5
filterable domains
0
infrastructure to manage
Auto
citations included

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ă:

  1. Analiză: modelul evaluează dacă întrebarea necesită date recente
  2. Decizie: alege să caute sau să răspundă folosind cunoștințele interne
  3. Execuție: căutarea web rulează lato sensu pe server (nu gestionați nimic)
  4. Procesare: rezultatele sunt analizate și sintetizate
  5. 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"} în tools (SDK openai, API Responses) sau web_search() în client.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