Attiva t-Tfittxija fuq il-Web fl-API ta' Grok
F'din il-paġna
Aġġornat fit-2 ta’ Novembru, 2026. Ibbażat fuq id-dokumentazzjoni ta’ xAI: bis-SDK
xai-sdk, it-tfittxija fuq il-web tiġi attivata permezz tal-funzjoniweb_search()importata minnxai_sdk.tools, fi ħdan konversazzjoni maħluqa minnclient.chat.create; l-eżempju l-qadim kien jissejjaħclient.tools.web_search(), li ma jeżistix f’dan l-SDK. Sors: Web Search.
Aġġornat fit-3 ta’ Novembru, 2026. L-ewwel eżempju sejjaħ
client.responses.create()fuq il-klijentxai-sdk, li m’għandux attributresponses: ma’ dan l-SDK, it-tfittxija tgħaddi minnclient.chat.create(..., tools=[web_search()]), uclient.responses.create()tappartjeni għall-SDKopenaiindikat lejnhttps://api.x.ai/v1. L-eżempju tas-SDK ta’ Vercel AI għadda l-għodod bħala array u ma importaxgenerateText: huma jiddikjarawhom f’oġġett, bħad-dokumentazzjoni ta’ xAI. Il-kodiċi ġie vverifikat ma’xai-sdk1.21.0 uopenai3.42.1. Sors: Web Search.
Għaliex Tgħaqqad lil Grok mal-Web f’Ħin Reali
Il-mudelli klassiċi tal-lingwa jaħdmu b’għarfien iffriżat fid-data tat-taħriġ tagħhom. Għal żviluppatur li jibni applikazzjonijiet li jeħtieġu dejta attwali (prezzijiet tal-ishma, aħbarijiet, riżultati sportivi, it-temp), din il-limitazzjoni hija ostaklu kbir. L-għodda web_search fl-API ta’ Grok issolvi din il-problema billi tippermetti lill-mudell jinvestiga l-web f’ħin reali, direttament mis-sejħa tal-API tiegħek.

Minflok fornituri oħra li jirrikjedu integrazzjonijiet ma’ partijiet terzi jew plugins separati, xAI toffri t-tfittxija fuq il-web bħala għodda integrata fuq is-server. M’għandek l-ebda infrastruttura x’timmaniġġja: il-mudell jiddeċiedi meta jfittex, iwettaq il-mistoqsija, u jintegra r-riżultati fir-risposta tiegħu.
L-API tar-Risposti: L-Uniku Endpoint Appoġġjat
It-tfittxija fuq il-web taħdem esklużivament fuq l-API tar-Risposti (Responses API). L-endpoint l-qadim ta’ Chat Completions kien joffri l-parametru search_parameters, iżda issa huwa deprekat. Jekk qed timmigra mill-API l-qadima, ikollok tadatta s-sejħiet tiegħek.
L-attivazzjoni sseħħ billi żżid l-għodda web_search fl-array tools fit-talba tiegħek:
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)
Dan l-eżempju juża l-SDK openai, kompatibbli mal-API tar-Risposti ta’ xAI; l-SDK nativ ta’ xAI, ippreżentat hawn taħt, jgħaddi minn konversazzjoni.
Hekk biss. Il-mudell janalizza l-prompt tiegħek, jiddetermina jekk għandux bżonn informazzjoni friska, u jattiva t-tfittxija awtomatikament. M’għandekx bżonn timmaniġġja ċ-ċiklu ta’ sejħiet jew loġika kondizzjonali.
Il-Fluss ta’ Eżekuzzjoni f’Ħames Passi
Meta tibgħat talba b’web_search attivat, il-proċess isegwi sekwenza speċifika:
- Analiżi: il-mudell jevalwa jekk il-mistoqsija teħtiġix dejta riċenti
- Deċiżjoni: jagħżel li jfittex jew iwieġeb bl-għarfien intern tiegħu
- Eżekuzzjoni: it-tfittxija fuq il-web tiġi esegwita fuq is-server (ma timmaniġġja xejn)
- Ipproċessar: ir-riżultati jiġu analizzati u ssintetizzati
- Risposta: it-test finali jiġi ġġenerat biċ-ċitazzjonijiet assoċjati
Dan il-mekkaniżmu jfisser li l-mudell jista’ jiddeċiedi li ma jfittixx jekk il-mistoqsija ma tiġġustifikax dan. Pereżempju, jekk tistaqsi għad-definizzjoni tal-fotosinteżi, x’aktarx ma tiġix attivata tfittxija fuq il-web.
Użu ma’ SDKs Differenti
L-SDK ta’ xAI jipprovdi funzjoni ddedikata, web_search(), biex tgħaddiha fil-lista tal-għodod tal-konversazzjoni:
# SDK nativ ta' xAI
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)
Mal-SDK openai, hija s-sejħa mill-bidu tal-lezzjoni: client.responses.create() b’base_url="https://api.x.ai/v1" u tools=[{"type": "web_search"}].
Għas-SDK ta’ Vercel AI f’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);
Prattika Manwali
Oħloq skript li jistaqsi lil Grok dwar avveniment attwali ta’ għażla tiegħek. Ivvverifika li r-risposta fiha informazzjoni riċenti (dati, avvenimenti li seħħew wara d-data ta’ qtugħ tal-mudell). Imbagħad ipprova l-istess mistoqsija mingħajr l-għodda web_search biex tara d-differenza.
Punti Ewlenin
- It-tfittxija fuq il-web tiġi attivata b’
{"type": "web_search"}f’tools(SDKopenai, API tar-Risposti) jewweb_search()f’client.chat.create(xai-sdk) - Taħdem biss fuq l-API tar-Risposti (mhux fuq Chat Completions)
- Il-mudell jiddeċiedi awtonomament meta jkollu bżonn ifittex
- Iċ-ċitazzjonijiet huma inklużi awtomatikament fir-risposta
- L-ispiża hija $5 kull 1,000 sejħa tal-għodda, flimkien mat-tokens ikkunsmati