Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Web Search API: Cuardach Gréasáin Cláraithe

Ceacht 5 as 20 Nuashonraithe 2 Samhain 2026 Forbróir
Ar an leathanach seo
  1. Web Search API: Cuardach Gréasáin Cláraithe
  2. Web Search a Chumasú
  3. Struchtúr na Freagartha
  4. Comhthéacs an Úsáideora le haghaidh Ábharthachta
  5. Web Search a Chomhcheangal le Feidhmeanna Saincheaptha
  6. Cásanna Úsáide Táirgeachta
  7. Teorainneacha Aitheanta
  8. Príomhphointí

An ceacht nuashonraithe an 2 Samhain, 2026 bunaithe ar dhoiciméadú OpenAI: éilíonn an uirlis Code Interpreter anois paraiméadar container (curtha leis i ngach sampla), is de chineál input_text iad codanna téacs ionchuir, agus úsáideann an cuardach gréasáin an uirlis web_search (is uirlis sheanbhunaithe gan scagairí fearainn anois é web_search_preview). Faightear comhaid ghinte trí na feidhmeanna fichiers_generes agus telecharger ó Cheacht 10. Foinse: Code Interpreter · Cuardach gréasáin.

Web Search API: Cuardach Gréasáin Cláraithe

Ligeann an uirlis Web Search don mhúnla cuardaigh ghréasáin fhíor-ama a dhéanamh go díreach ón Responses API. Ní gá duit a thuilleadh API cuardaigh tríú páirtí a chomhtháthú: déanann an múnla an cheist a fhoirmiú, ritheann sé an cuardach, agus déanann sé síntéis ar na torthaí.

Web Search a Chumasú

Ní theastaíonn ach líne amháin le haghaidh gníomhachtaithe, ach folachaíonn sé athrú bunúsach: níl d’iarratas teoranta a thuilleadh ag teorainn eolais an mhúnla. Is féidir freagra a thabhairt ar cheisteanna faoi imeachtaí inné, praghsáil reatha, nó rialacháin le déanaí gan inneall cuardaigh tríú páirtí a chomhtháthú ná íoc as.

from openai import OpenAI

client = OpenAI()

response = client.responses.create(
    model="gpt-5.6-terra",
    input="What are the latest Ligue 1 results?",
    tools=[{"type": "web_search"}]
)

print(response.output_text)

Cinneann an múnla cathain a dhéanfaidh sé cuardach air féin, agus tá an pointe seo tábhachtach: ní dhéanann sé cuardach go córasach. Maidir le ceisteanna a mheasann sé a thagann faoina eolas atá ann cheana, freagraíonn sé go díreach—níos tapúla agus níos saoire, ach leis an riosca go dtabharfaidh sé eolas as dáta leis an muinín chéanna. Nuair a bhíonn úire ríthábhachtach, luaigh é seo go sainráite i do leid seachas a bheith ag súil go dtuigfidh an múnla é i gceart.

Struchtúr na Freagartha

Tagann foinse mar nótaí ceangailte leis an bhfreagra, ar leithligh ón téacs. Ligeann sé seo duit iad a thaispeáint ar do bhealach féin, iad a fhíorú, nó aon fhreagra a mharcáil amhail amhrasach nach bhfuil foinse aige nuair a éilíonn an t-ábhar iad.

response = client.responses.create(
    model="gpt-5.6-terra",
    input="What is the current stock price of LVMH?",
    tools=[{"type": "web_search"}]
)

# Téacs síntetithe
print(response.output_text)

# Foinse a scrúdú
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"Source: {annotation.url}")
                        print(f"Title : {annotation.title}")

Comhthéacs an Úsáideora le haghaidh Ábharthachta

Bíonn tionchar ag an suíomh ar thorthaí níos mó ná mar a shamhlófá, agus ní hamháin do chuardaigh atá go soiléir áitiúil. Tugann ceisteanna faoi chánachas, praghsáil, infhaighteacht, nó oibleagáidí dlíthiúla freagraí difriúla ag brath ar an tír: gan user_location, úsáideann an múnla comhthéacs réamhshocraithe atá minic dírithe ar na SA.

response = client.responses.create(
    model="gpt-5.6-terra",
    input="Which Japanese restaurant is open tonight?",
    tools=[{
        "type": "web_search",
        "user_location": {
            "type": "approximate",
            "city": "Paris",
            "country": "FR"
        }
    }]
)

Glacann an paraiméadar user_location le roinnt leibhéil cruinnis:

# Suíomh garbh
"user_location": {
    "type": "approximate",
    "city": "Lyon",
    "region": "Auvergne-Rhone-Alpes",
    "country": "FR"
}

Web Search a Chomhcheangal le Feidhmeanna Saincheaptha

Leanann an comhcheangal is táirgiúla an patrún céanna i gcónaí: tugann an gréasán eolas seachtrach, soláthraíonn do fheidhmeanna comhthéacs inmheánach, agus ceanglaíonn an múnla na pointí. Ansin atá an luach—ní fhreagraíonn an cuardach ná do chuid sonraí ar leithligh an cheist “an ndéanann an t-athrú seo difear dúinn?”

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="Search for the latest news on AI regulation in Europe "
          "and save important results",
    tools=tools
)

Cásanna Úsáide Táirgeachta

Faisnéis Iomaíochta Uathoibrithe

def veille_quotidienne(entreprises: list[str]):
    """Launches web monitoring for each competitor."""
    resultats = []
    for entreprise in entreprises:
        response = client.responses.create(
            model="gpt-5.6-terra",
            input=f"What is the latest news about {entreprise}? "
                  "Focus on product announcements, funding rounds, "
                  "and partnerships from the last 7 days.",
            tools=[{"type": "web_search"}]
        )
        resultats.append({
            "entreprise": entreprise,
            "synthese": response.output_text
        })
    return resultats

Fíorú Fíricí

def verifier_affirmation(affirmation: str) -> dict:
    """Verifies a claim by cross-referencing multiple web sources."""
    response = client.responses.create(
        model="gpt-5.6-terra",
        input=f"Verify this claim by searching for reliable sources: "
              f"'{affirmation}'. State whether it is true, false, or uncertain, "
              f"including the sources supporting your conclusion.",
        tools=[{"type": "web_search"}]
    )

    # Luaiteanna a eastósct
    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
    }

Teorainneacha Aitheanta

  • B’fhéidir nach bhfaighidh an múnla torthaí ábhartha do ábhair an-speisialaithe
  • Braitheann torthaí ar innéacsú gréasáin tráth an iarratais
  • Tá teorainn le líon na gcuardach in aghaidh an ghlao: déanann an múnla optamú trí cheisteanna cruinne a fhoirmiú
  • Níl rochtain ar ábhar taobh thiar de bhallaí íocaíochta nó scáileáin logáilte isteach

Príomhphointí

  • Cuir web_search leis i líne amháin laistigh de tools
  • Cinneann an múnla go huathrialach cathain a dhéanfaidh sé cuardach ar an ngréasán
  • Feabhsaíonn user_location ábharthacht do thorthaí áitiúla
  • Soláthraíonn nótaí url_citation foinse
  • Comhcheangail Web Search le do fheidhmeanna féin chun faireachán a uathoibriú