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

Activarea căutării pe web în API

Lecția 4 din 16 Actualizată 2 noiembrie 2026 Dezvoltator
Pe această pagină
  1. Oferiți-i lui Grok acces la web în timp real
  2. Condiții prealabile: API-ul Responses
  3. Activarea de bază
  4. Activarea cu SDK-ul xAI (Python)
  5. Activarea cu SDK-ul OpenAI
  6. Activarea cu SDK-ul Vercel AI
  7. Combinarea căutării pe web cu alte instrumente
  8. Puncte cheie

Actualizat la 2 noiembrie 2026. Conform documentației xAI: cu xai-sdk, căutarea pe web se activează prin funcția web_search() importată din xai_sdk.tools, într-o conversație creată de client.chat.create; vechiul exemplu care apela client.tools.web_search() și client.responses.create nu 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ă.

Responses
API necesar
5
Domenii filtrabile
Automat
Citări incluse
$5
/ 1.000 de apeluri

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 tabloul tools
  • 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