Ikkonfigura u kkontrolla r-riżultati tat-tiftix fuq il-web
F'din il-paġna
- Ikkonfigura u kkontrolla r-riżultati tat-tiftix fuq il-web
- Il-parametru search_context_size
- Iggwida l-mistoqsijiet tat-tiftix permezz tal-prompt
- Estrai u struttura ċ-ċitazzjonijiet
- Mudell: tiftix b’validazzjoni inkroċjata
- Immaniġġja n-nuqqas ta’ riżultati
- Tiftix fuq il-Web b’streaming
- Iffiltra d-dominji u elenka s-sorsi
- Punti Ewlenin
Lezzjoni aġġornata fit-2 ta’ Novembru, 2026 ibbażata fuq id-dokumentazzjoni ta’ OpenAI: l-għodda Code Interpreter teħtieġ parametru
container(miżjud mal-eżempji kollha), il-partijiet tat-test tal-input huma tat-tipinput_text, u t-tiftix fuq il-web już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.
Ikkonfigura u kkontrolla r-riżultati tat-tiftix fuq il-web
L-attivazzjoni tat-Tiftix fuq il-Web tieħu linja waħda; biex tikseb tweġibiet affidabbli jeħtieġu tliet settings li din il-lezzjoni tiddettalja. L-ewwel wieħed jiddeċiedi kemm kontenut tal-web jiġi injettat fil-kuntest, u dan jaffettwa direttament il-kont tiegħek. It-tieni wieħed jiggwida l-mistoqsijiet li l-mudell jifformula huwa stess—għax huwa jiktebhom, mhux int. It-tielet jikkonċerna ċ-ċitazzjonijiet; mingħajrhom, tweġiba b’sors hija sempliċiment dikjarazzjoni affermattiva.
Il-parametru search_context_size
Il-parametru search_context_size jikkontrolla kemm kontenut tal-web jiġi injettat fil-kuntest tal-mudell. Ma jbiddilx in-numru ta’ tfittxijiet u lanqas il-kwalità tagħhom: jiddetermina kemm test, wara li jinstabu l-paġni, jidħal fil-fatt fil-prompt. Dan huwa kompromess bejn l-eżawrjenza u l-ispiża, u għandek taġġustah skont it-tip ta’ kompitu, mhux tissettjah darba u tinsa.
from openai import OpenAI
client = OpenAI()
# Kuntest minimu: tweġibiet mgħaġġla u konċiżi
response = client.responses.create(
model="gpt-5.6-terra",
input="What is France's GDP in 2025?",
tools=[{
"type": "web_search",
"search_context_size": "low"
}]
)
# Kuntest medju: kompromess tajjeb (default)
response = client.responses.create(
model="gpt-5.6-terra",
input="Summarize AI market trends in Europe",
tools=[{
"type": "web_search",
"search_context_size": "medium"
}]
)
# Kuntest kbir: analiżi fil-fond
response = client.responses.create(
model="gpt-5.6-terra",
input="Compare AI strategies in France, Germany, and the Netherlands",
tools=[{
"type": "web_search",
"search_context_size": "high"
}]
)
Impatt fuq l-ispejjeż u l-latency
Ir-regola bażika hija sempliċi: żid grad biss meta t-tweġiba li rċevejt deludietek konkretament. Data, figura, jew konferma fattwali ma teħtieġ xejn aktar minn low; l-użu ta’ high għal dan huwa bħal li tħallas għal dossier sħiħ biex taqra linja waħda.
| Daqs | Tokens tal-kuntest | Latency | Spiża | Użu |
|---|---|---|---|---|
low | Minimu | Mgħaġġel | Baxxa | Fatti sempliċi, figuri |
medium | Moderat | Standard | Medja | Sommarji, tqabbiliet |
high | Massimu | Iktar bil-mod | Għolja | Analiżi fil-fond |
Iggwida l-mistoqsijiet tat-tiftix permezz tal-prompt
Hawnhekk hemm il-punt li ħafna nies jiskopru tard wisq: il-mudell jifformula l-mistoqsijiet tat-tiftix tiegħu stess. Int tikteb “x’inhuma l-bidliet regolatorji riċenti?” u huwa jittraduċi dan f’kliem ewlieni (keywords) li qatt ma tara. Għalhekk, il-kwalità tar-riżultat tiddependi fuq riformulazzjoni li fuqha għandek biss kontroll indirett—il-prompt tas-sistema. Semmi s-sorsi awtorevoli fil-qasam tiegħek u l-perjodu li jimpurtak: dan huwa l-aktar li jċaqlaq il-labra.
response = client.responses.create(
model="gpt-5.6-terra",
instructions=(
"You are a market analyst specializing in European technology. "
"When you perform web searches, prioritize institutional sources "
"(European Commission, INSEE, Eurostat) and specialized media "
"(Les Echos, La Tribune, TechCrunch). "
"Ignore personal blogs and forums."
),
input="What is the state of AI startup funding in France?",
tools=[{
"type": "web_search",
"search_context_size": "high"
}]
)
Estrai u struttura ċ-ċitazzjonijiet
Iċ-ċitazzjonijiet jaslu bħala annotazzjonijiet mehmuża mar-rispons, mhux fit-test innifsu. Din is-separazzjoni hija aħbar tajba: tippermettilek turi s-sorsi kif trid, tivverifikahom, jew tirrifjuta tweġiba li m’għandha l-ebda wieħed. F’kull applikazzjoni fejn it-tweġiba għandha piż—legali, mediku, finanzjarju—li tittratta annotazzjonijiet nieqsa bħala żball huwa aktar sikur milli tifda t-test.
def extract_sources(response) -> list[dict]:
"""Extract all URL citations from a Web Search response."""
sources = []
for item in response.output:
if item.type == "message":
for block in item.content:
if hasattr(block, "annotations"):
for ann in block.annotations:
if ann.type == "url_citation":
sources.append({
"url": ann.url,
"title": ann.title,
"excerpt_start": ann.start_index,
"excerpt_end": ann.end_index
})
return sources
# Użu
response = client.responses.create(
model="gpt-5.6-terra",
input="What are the new GDPR rules for AI in 2026?",
tools=[{"type": "web_search"}]
)
sources = extract_sources(response)
for s in sources:
print(f" {s['title']}: {s['url']}")
Mudell: tiftix b’validazzjoni inkroċjata
Sors wieħed jibqa’ sors wieħed, anke jekk mudell sabu. Għal informazzjoni li tmexxi deċiżjoni, itlob espliċitament konferma minn sorsi indipendenti multipli u ġiegħel lill-mudell jindika n-nuqqas ta’ qbil minflok ma jarbitrahom b’mod silenzjuż: nuqqas ta’ qbil bejn żewġ sorsi huwa fih innifsu informazzjoni, spiss aktar utli milli tagħmel medja taż-żewġ sorsi.
def validated_search(question: str, min_sources: int = 3) -> dict:
"""Web search requiring multiple sources."""
response = client.responses.create(
model="gpt-5.6-terra",
instructions=(
f"To answer this question, you must find at least "
f"{min_sources} independent sources that confirm the information. "
"If sources contradict each other, flag the discrepancies. "
"Cite each source explicitly."
),
input=question,
tools=[{
"type": "web_search",
"search_context_size": "high"
}]
)
sources = extract_sources(response)
return {
"answer": response.output_text,
"sources": sources,
"reliability": "high" if len(sources) >= min_sources else "verify"
}
Immaniġġja n-nuqqas ta’ riżultati
Hemm każ wieħed li n-nies jinsu jimmaniġġjaw: it-tiftix ma jirritorna xejn. Ir-riskju mhux in-nuqqas ta’ tweġiba—imma li, fin-nuqqas ta’ riżultati, il-mudell iwieġeb mill-għarfien intern tiegħu mingħajr ma jissignalah, u jagħtik informazzjoni plawżibbli iżda antika. Itloblu jgħid dan espliċitament, u ppjana għal riformulazzjoni.
def search_with_fallback(question: str) -> dict:
"""Web search with failure detection and reformulation."""
# L-ewwel tentattiv
response = client.responses.create(
model="gpt-5.6-terra",
input=question,
tools=[{"type": "web_search"}]
)
sources = extract_sources(response)
if len(sources) == 0:
# Riformulazzjoni awtomatika
response = client.responses.create(
model="gpt-5.6-terra",
input=f"Rephrase this question for a more effective web search, "
f"then search: {question}",
tools=[{"type": "web_search", "search_context_size": "high"}]
)
sources = extract_sources(response)
return {
"answer": response.output_text,
"sources": sources
}
Tiftix fuq il-Web b’streaming
Tiftix fuq il-web jieħu ftit sekondi, xi kultant aktar jekk il-mudell iħabbat diversi mistoqsijiet flimkien. Bis-streaming, l-utent jara t-tweġiba tinbena minflok ma jħares lejn indikatur ta’ tagħbija—u għal dan it-tip ta’ latency, id-differenza fil-perċezzjoni hija enormi għal spiża ta’ implimentazzjoni kważi żero.
stream = client.responses.create(
model="gpt-5.6-terra",
input="What are this week's tech news headlines?",
tools=[{"type": "web_search"}],
stream=True
)
for event in stream:
if event.type == "response.output_text.delta":
print(event.delta, end="", flush=True)
elif event.type == "response.completed":
# Estrai s-sorsi fl-aħħar
sources = extract_sources(event.response)
print(f"\n\n--- {len(sources)} sources consulted ---")
Iffiltra d-dominji u elenka s-sorsi
L-għodda web_search taċċetta parametru filters li jirrestrinġi t-tiftix għal lista ta’ dominji permessi (sa 100) jew jeskludi lista (ukoll sa 100). Ikteb id-dominji mingħajr http:// jew https://. Il-filtru jeżisti biss ma’ web_search fl-API tar-Risposti: l-għodda antika web_search_preview tinjorah.
response = client.responses.create(
model="gpt-5.6-terra",
tools=[{
"type": "web_search",
"filters": {"allowed_domains": ["service-public.fr", "legifrance.gouv.fr"]},
}],
include=["web_search_call.action.sources"],
input="What are the price display requirements for retail stores in France?",
)
print(response.output_text)
L-għażla include=["web_search_call.action.sources"] tirritorna l-lista sħiħa tal-URLs ikkonsultati, spiss itwal mil-lista ta’ ċitazzjonijiet. Iċ-ċitazzjonijiet infushom jaslu bħala annotazzjonijiet url_citation (URL, titlu, pożizzjoni fit-test): id-dokumentazzjoni ta’ OpenAI titlob li turihom b’mod viżibbli u li tista’ tikklikkjahom fl-interfaċċja tiegħek.
Punti Ewlenin
search_context_sizejikkontrolla l-volum ta’ data tal-web injettatafiltersjirrestrinġi jew jeskludi d-dominji (massimu 100);includejelenka s-sorsi kkonsultati kollha- Il-prompt tas-sistema jiggwida lill-mudell lejn is-sorsi t-tajba
- Estrai l-annotazzjonijiet
url_citationbiex traċċa s-sorsi - Implimenta l-validazzjoni inkroċjata għal informazzjoni kritika
- Immaniġġja r-riżultati nieqsa b’riformulazzjoni awtomatika