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

Ikkonfigura u kkontrolla r-riżultati tat-tiftix fuq il-web

Lezzjoni 6 / 20 Aġġornat 2 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. Ikkonfigura u kkontrolla r-riżultati tat-tiftix fuq il-web
  2. Il-parametru search_context_size
  3. Iggwida l-mistoqsijiet tat-tiftix permezz tal-prompt
  4. Estrai u struttura ċ-ċitazzjonijiet
  5. Mudell: tiftix b’validazzjoni inkroċjata
  6. Immaniġġja n-nuqqas ta’ riżultati
  7. Tiftix fuq il-Web b’streaming
  8. Iffiltra d-dominji u elenka s-sorsi
  9. 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-tip input_text, u t-tiftix fuq il-web juża l-għodda web_search (web_search_preview issa hija għodda antika mingħajr filtri tad-dominju). Il-fajls iġġenerati jiġu rkuprati bl-użu tal-funzjonijiet fichiers_generes u telecharger mil-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.

DaqsTokens tal-kuntestLatencySpiżaUżu
lowMinimuMgħaġġelBaxxaFatti sempliċi, figuri
mediumModeratStandardMedjaSommarji, tqabbiliet
highMassimuIktar bil-modGħoljaAnaliż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_size jikkontrolla l-volum ta’ data tal-web injettata
  • filters jirrestrinġi jew jeskludi d-dominji (massimu 100); include jelenka s-sorsi kkonsultati kollha
  • Il-prompt tas-sistema jiggwida lill-mudell lejn is-sorsi t-tajba
  • Estrai l-annotazzjonijiet url_citation biex traċċa s-sorsi
  • Implimenta l-validazzjoni inkroċjata għal informazzjoni kritika
  • Immaniġġja r-riżultati nieqsa b’riformulazzjoni awtomatika