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

Web Search API: Tfittxija Programmabbli fuq il-Web

Lezzjoni 5 / 20 Aġġornat 2 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. Web Search API: Tfittxija Programmabbli fuq il-Web
  2. Attiva t-Tfittxija fuq il-Web
  3. Struttura tar-Risposta
  4. Kuntest tal-Utent għar-Rilevanza
  5. Ikkombina t-Tfittxija fuq il-Web ma’ Funzjonijiet Personalizzati
  6. Każijiet ta’ Użu fil-Produzzjoni
  7. Limitazzjonijiet Magħrufa
  8. Punti Ewlenin

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-tip input_text, u t-tfittxija fuq il-web tuż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.

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_search f’linja waħda fi ħdan tools
  • Il-mudell jiddeċiedi awtonomament meta jfittex fuq il-web
  • user_location itejjeb ir-rilevanza għar-riżultati lokali
  • L-annotazzjonijiet url_citation jipprovdu s-sorsi
  • Ikkombina t-Tfittxija fuq il-Web mal-funzjonijiet tiegħek biex tawtomatizza l-monitoraġġ