Web Search API: Tfittxija Programmabbli fuq il-Web
F'din il-paġna
Lezzjoni aġġornata fit-2 ta’ Novembru, 2026 ibbażata fuq id-dokumentazzjoni ta’ OpenAI: l-għodda Code Interpreter issa teħtieġ parametru
container(miżjud mal-eżempji kollha), il-partijiet tat-test tal-input huma tat-tipinput_text, u t-tfittxija fuq il-web tuża l-għoddaweb_search(web_search_previewissa hija għodda antika mingħajr filtri tad-dominju). Il-fajls iġġenerati jiġu rkuprati bl-użu tal-funzjonijietfichiers_generesutelechargermil-Lezzjoni 10. Sorsi: Code Interpreter · Web search.
Web Search API: Tfittxija Programmabbli fuq il-Web
L-għodda Web Search tippermetti lill-mudell iwettaq tfittxijiet fuq il-web f’ħin reali direttament mill-API tar-Risposti. M’għadekx għandek bżonn tintegra API ta’ tfittxija ta’ parti terza: il-mudell jifformola l-mistoqsija, iwettaq it-tfittxija, u jissintetizza r-riżultati.
Attiva t-Tfittxija fuq il-Web
L-attivazzjoni tieħu linja waħda biss, li taħbi bidla fundamentali: l-applikazzjoni tiegħek m’għadhiex limitata mid-data tal-aħħar għarfien tal-mudell. Mistoqsijiet dwar avvenimenti ta’ lbieraħ, prezzijiet attwali, jew regolamenti reċenti jsiru possibbli mingħajr ma tintegra jew tħallas għal magna ta’ tfittxija ta’ parti terza.
from openai import OpenAI
client = OpenAI()
response = client.responses.create(
model="gpt-5.6-terra",
input="X'inhuma l-aħħar riżultati tal-Ligue 1?",
tools=[{"type": "web_search"}]
)
print(response.output_text)
Il-mudell jiddeċiedi meta jfittex waħdu, u dan il-punt jistħoqqilu attenzjoni: ma jfittxix sistematikament. Għal mistoqsijiet li jemmen li jaqgħu fil-għarfien eżistenti tiegħu, iwieġeb direttament—aktar malajr u irħas, iżda bir-riskju li jippreżenta informazzjoni antika bl-istess kunfidenza. Meta l-aġġornament huwa kritiku, iddikjara dan b’mod espliċitu fil-prompt tiegħek minflok ma tittama li l-mudell jindovina sewwa.
Struttura tar-Risposta
Is-sorsi jaslu bħala annotazzjonijiet mehmuża mar-risposta, separatament mit-test. Dan jippermettilek turihom kif trid, tivverifikahom, jew timmarka bħala suspettuża kwalunkwe risposta li ma jkollhiex sorsi meta s-suġġett jeħtieġhom.
response = client.responses.create(
model="gpt-5.6-terra",
input="X'inhu l-prezz attwali tal-azzjonijiet ta' LVMH?",
tools=[{"type": "web_search"}]
)
# Test issintetizzat
print(response.output_text)
# Eżamina s-sorsi
for item in response.output:
if hasattr(item, "content"):
for block in item.content:
if hasattr(block, "annotations"):
for annotation in block.annotations:
if annotation.type == "url_citation":
print(f"Sors: {annotation.url}")
print(f"Titolu : {annotation.title}")
Kuntest tal-Utent għar-Rilevanza
Il-post jaffettwa r-riżultati aktar milli tista’ timmaġina, u mhux biss għal tfittxijiet ovvjament lokali. Mistoqsijiet dwar it-tassazzjoni, l-ipprezzar, id-disponibbiltà, jew l-obbligi legali jagħtu tweġibiet differenti skont il-pajjiż: mingħajr user_location, il-mudell jiddefawltja għal kuntest li spiss ikun iċċentrat fuq l-Istati Uniti.
response = client.responses.create(
model="gpt-5.6-terra",
input="Liema ristaurant Ġappuniż huwa miftuħ il-lejla?",
tools=[{
"type": "web_search",
"user_location": {
"type": "approximate",
"city": "Paris",
"country": "FR"
}
}]
)
Il-parametru user_location jaċċetta diversi livelli ta’ preċiżjoni:
# Post approssimattiv
"user_location": {
"type": "approximate",
"city": "Lyon",
"region": "Auvergne-Rhone-Alpes",
"country": "FR"
}
Ikkombina t-Tfittxija fuq il-Web ma’ Funzjonijiet Personalizzati
L-aktar kombinazzjoni produttiva dejjem issegwi l-istess mudell: il-web iġib informazzjoni esterna, il-funzjonijiet tiegħek jipprovdu kuntest intern, u l-mudell jgħaqqad il-punti. Din il-konnessjoni hija fejn tinsab il-valur—la t-tfittxija u lanqas id-dejta tiegħek waħedha tweġeb “din il-bidla taffettwana?”.
tools = [
{"type": "web_search"},
{
"type": "function",
"name": "sauvegarder_veille",
"description": "Save a monitoring result to the database",
"parameters": {
"type": "object",
"properties": {
"titre": {"type": "string"},
"resume": {"type": "string"},
"url_source": {"type": "string"},
"categorie": {
"type": "string",
"enum": ["concurrent", "marche", "reglementation", "technologie"]
}
},
"required": ["titre", "resume", "categorie"],
"additionalProperties": False
},
"strict": True
}
]
response = client.responses.create(
model="gpt-5.6-terra",
input="Fittex l-aħbarijiet l-aktar reċenti dwar ir-regolamentazzjoni tal-AI fl-Ewropa "
"u salva r-riżultati importanti",
tools=tools
)
Każijiet ta’ Użu fil-Produzzjoni
Intelligence Kompetittiva Awtomatizzata
def veille_quotidienne(entreprises: list[str]):
"""Tniedi monitoraġġ fuq il-web għal kull kompetitur."""
resultats = []
for entreprise in entreprises:
response = client.responses.create(
model="gpt-5.6-terra",
input=f"X'inhuma l-aħbarijiet l-aktar reċenti dwar {entreprise}? "
"Iffoka fuq tħabbiriet ta' prodotti, rawnds ta' finanzjament, "
"u sħubijiet mill-aħħar 7 ijiem.",
tools=[{"type": "web_search"}]
)
resultats.append({
"entreprise": entreprise,
"synthese": response.output_text
})
return resultats
Verifika tal-Fatti
def verifier_affirmation(affirmation: str) -> dict:
"""Tivverifika affermazzjoni billi tqabbel sorsi multipli fuq il-web."""
response = client.responses.create(
model="gpt-5.6-terra",
input=f"Ivverifika din l-affermazzjoni billi tfittex sorsi affidabbli: "
f"'{affirmation}'. Iddikjara jekk hix vera, falza, jew inċerta, "
f"inklużi s-sorsi li jappoġġjaw il-konklużjoni tiegħek.",
tools=[{"type": "web_search"}]
)
# Estrai ċ-ċitazzjonijiet
sources = []
for item in response.output:
if hasattr(item, "content"):
for block in item.content:
if hasattr(block, "annotations"):
for ann in block.annotations:
if ann.type == "url_citation":
sources.append(ann.url)
return {
"analyse": response.output_text,
"nombre_sources": len(sources),
"sources": sources
}
Limitazzjonijiet Magħrufa
- Il-mudell jista’ ma jsibx riżultati rilevanti għal suġġetti speċjali ħafna
- Ir-riżultati jiddependu mill-indiċjar tal-web fil-ħin tat-talba
- In-numru ta’ tfittxijiet għal kull sejħa huwa limitat: il-mudell jottimizza billi jifformola mistoqsijiet preċiżi
- Il-kontenut wara ħitan ta’ ħlas jew skrinijiet ta’ login mhuwiex aċċessibbli
Punti Ewlenin
- Żid
web_searchf’linja waħda fi ħdantools - Il-mudell jiddeċiedi awtonomament meta jfittex fuq il-web
user_locationitejjeb ir-rilevanza għar-riżultati lokali- L-annotazzjonijiet
url_citationjipprovdu s-sorsi - Ikkombina t-Tfittxija fuq il-Web mal-funzjonijiet tiegħek biex tawtomatizza l-monitoraġġ