Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Attiva t-Tfittxija fuq il-Web fl-API ta' Grok

Lezzjoni 1 / 14 Aġġornat 3 ta’ Novembru 2026 Bidbieni
F'din il-paġna
  1. Għaliex Tgħaqqad lil Grok mal-Web f’Ħin Reali
  2. L-API tar-Risposti: L-Uniku Endpoint Appoġġjat
  3. Il-Fluss ta’ Eżekuzzjoni f’Ħames Passi
  4. Użu ma’ SDKs Differenti
  5. Prattika Manwali
  6. Punti Ewlenin

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-funzjoni web_search() importata minn xai_sdk.tools, fi ħdan konversazzjoni maħluqa minn client.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-klijent xai-sdk, li m’għandux attribut responses: ma’ dan l-SDK, it-tfittxija tgħaddi minn client.chat.create(..., tools=[web_search()]), u client.responses.create() tappartjeni għall-SDK openai indikat lejn https://api.x.ai/v1. L-eżempju tas-SDK ta’ Vercel AI għadda l-għodod bħala array u ma importax generateText: huma jiddikjarawhom f’oġġett, bħad-dokumentazzjoni ta’ xAI. Il-kodiċi ġie vverifikat ma’ xai-sdk 1.21.0 u openai 3.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.

Tfittxija fuq il-Web ma' Grok

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.

$5
kull 1,000 sejħa
5
dominji li jistgħu jiġu ffiltrati
0
infrastruttura x'timmaniġġja
Awtomatiku
ċitazzjonijiet inklużi

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:

  1. Analiżi: il-mudell jevalwa jekk il-mistoqsija teħtiġix dejta riċenti
  2. Deċiżjoni: jagħżel li jfittex jew iwieġeb bl-għarfien intern tiegħu
  3. Eżekuzzjoni: it-tfittxija fuq il-web tiġi esegwita fuq is-server (ma timmaniġġja xejn)
  4. Ipproċessar: ir-riżultati jiġu analizzati u ssintetizzati
  5. 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 (SDK openai, API tar-Risposti) jew web_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