Määritä ja hallitse verkkohakutuloksia
Tällä sivulla
Tunti päivitetty 2. marraskuuta 2026 OpenAI:n dokumentaation perusteella: Code Interpreter -työkalu vaatii
container-parametrin (lisätty kaikkiin esimerkkeihin), syötteen tekstiosat ovat tyyppiäinput_text, ja verkkohaku käyttääweb_search-työkalua (web_search_previewon nyt vanhentunut työkalu ilman verkkotunnussuodattimia). Generoidut tiedostot haetaan käyttämällä tunnin 10 funktioitafichiers_generesjatelecharger. Lähteet: Code Interpreter · Verkkohaku.
Määritä ja hallitse verkkohakutuloksia
Verkkohaun käyttöönotto vie yhden rivin; luotettavien vastausten saaminen vaatii kolme asetusta, joita tämä tunti käsittelee yksityiskohtaisesti. Ensimmäinen päättää, kuinka paljon verkkosisältöä injektoidaan kontekstiin, ja se vaikuttaa suoraan laskuusi. Toinen ohjaa kyselyitä, jotka malli muodostaa itse – koska se kirjoittaa ne, et sinä. Kolmas koskee lähdeviitteitä; ilman niitä lähteistetty vastaus on pelkkä väittämä.
search_context_size-parametri
search_context_size-parametri hallitsee, kuinka paljon verkkosisältöä injektoidaan mallin kontekstiin. Se ei muuta hakujen määrää eikä niiden laatua: se määrittää, kuinka paljon tekstiä sivujen löytymisen jälkeen päätyy itse kehotteeseen. Kyseessä on tasapainoilu tyhjentävyyden ja kustannusten välillä, ja sinun tulee säätää sitä tehtävätyypin mukaan, eikä asettaa sitä kerran ja unohtaa.
from openai import OpenAI
client = OpenAI()
# Vähäinen konteksti: nopeat, ytimekkäät vastaukset
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"
}]
)
# Keskitason konteksti: hyvä kompromissi (oletus)
response = client.responses.create(
model="gpt-5.6-terra",
input="Summarize AI market trends in Europe",
tools=[{
"type": "web_search",
"search_context_size": "medium"
}]
)
# Laaja konteksti: perusteellinen analyysi
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"
}]
)
Vaikutus kustannuksiin ja viiveeseen
Nyrkkisääntö on yksinkertainen: kasvata arvoa yhden pykälän verran vain, jos saamasi vastaus petti sinut konkreettisesti. Päivämäärä, luku tai faktatarkistus eivät tarvitse enempää kuin low; high:n käyttäminen tähän on kuin maksaisi kokonaisesta kansiosta yhden rivin lukemiseksi.
| Koko | Kontekstimerkit | Viive | Kustannus | Käyttö |
|---|---|---|---|---|
low | Vähäinen | Nopea | Matala | Yksinkertaiset faktat, luvut |
medium | Kohtalainen | Vakio | Keskitaso | Yhteenveto, vertailut |
high | Maksimaalinen | Hitaampi | Korkea | Perusteellinen analyysi |
Ohjaa hakukyselyitä kehotteen avulla
Tässä on se kohta, jonka useimmat huomaavat liian myöhään: malli muodostaa omat hakukyselynsä. Kirjoitat “mitkä ovat viimeaikaiset sääntelymuutokset?” ja se kääntää sen avainsanoiksi, joita et koskaan näe. Tulosten laatu riippuu siis uudelleenmuotoilusta, johon sinulla on vain epäsuora kontrolli – järjestelmäkehotteen kautta. Nimeä alasi auktoritatiiviset lähteet ja ajankohta, joka sinua kiinnostaa: se vaikuttaa eniten.
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"
}]
)
Poimi ja jäsennä lähdeviitteet
Lähdeviitteet saapuvat vastaukseen liitettyinä huomautuksina, eivät itse tekstissä. Tämä erottelu on hyvä uutinen: se antaa sinulle vapauden näyttää lähteet haluamallasi tavalla, tarkistaa ne tai hylätä vastauksen, jos niitä ei ole. Missä tahansa sovelluksessa, jossa vastauksella on painoarvoa – juridinen, lääketieteellinen, taloudellinen – on turvallisempaa käsitellä puuttuvat huomautukset virheenä kuin luottaa tekstiin.
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
# Käyttö
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']}")
Malli: haku ristiintarkistuksella
Yksi lähde on edelleen vain yksi lähde, vaikka malli sen löysikin. Tiedolle, joka ohjaa päätöksentekoa, pyydä nimenomaisesti vahvistusta useilta riippumattomilta lähteiltä ja pyydä mallia merkitsemään erimielisyydet sen sijaan, että se hiljaisesti arbitroisi niitä: kahden lähteen välinen erimielisyys on itsessään tietoa, usein hyödyllisempää kuin kahden keskiarvon ottaminen.
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"
}
Käsittele tuloksettomat haut
On yksi tapaus, jonka ihmiset unohtavat käsitellä: haku ei palauta mitään. Riski ei ole vastauksen puuttuminen – vaan se, että tulosten puuttuessa malli vastaa sisäisen tietämyksensä perusteella ilmoittamatta siitä, tarjoten sinulle uskottavaa mutta vanhentunutta tietoa. Pyydä sitä sanomaan tämä nimenomaisesti ja varaudu uudelleenmuotoiluun.
def search_with_fallback(question: str) -> dict:
"""Web search with failure detection and reformulation."""
# Ensimmäinen yritys
response = client.responses.create(
model="gpt-5.6-terra",
input=question,
tools=[{"type": "web_search"}]
)
sources = extract_sources(response)
if len(sources) == 0:
# Automaattinen uudelleenmuotoilu
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
}
Verkkohaku suoratoistona
Verkkohaku vie muutaman sekunnin, joskus enemmän, jos malli ketjuttaa useita kyselyitä. Suoratoiston avulla käyttäjä näkee vastauksen rakentuvan sen sijaan, että hän tuijottaisi latausindikaattoria – ja tämänkaltaisessa viiveessä ero havainnoinnissa on valtava lähes olemattomilla toteutuskustannuksilla.
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":
# Poimi lähteet lopussa
sources = extract_sources(event.response)
print(f"\n\n--- {len(sources)} sources consulted ---")
Suodata verkkotunnuksia ja listaa lähteet
web_search-työkalu hyväksyy filters-parametrin, joka rajoittaa haun sallittujen verkkotunnusten listaan (enintään 100) tai sulkee pois listan (myös enintään 100). Kirjoita verkkotunnukset ilman http:// tai https://-etuliitettä. Suodatus on olemassa vain web_search:lle Responses API:ssa: vanhentunut web_search_preview-työkalu ignoroi sen.
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)
include=["web_search_call.action.sources"]-vaihtoehto palauttaa täyden listan konsultoiduista URL-osoitteista, joka on usein pidempi kuin itse lähdeviitteiden lista. Itse lähdeviitteet saapuvat url_citation-huomautuksina (URL, otsikko, sijainti tekstissä): OpenAI:n dokumentaatio pyytää näyttämään ne näkyvästi ja klikattavina käyttöliittymässäsi.
Keskeiset asiat
search_context_sizehallitsee injektoidun verkkodatan määrääfiltersrajoittaa tai sulkee pois verkkotunnuksia (max 100);includelistaa kaikki konsultoidut lähteet- Järjestelmäkehote ohjaa mallia oikeiden lähteiden äärelle
- Poimi
url_citation-huomautukset lähteiden jäljittämiseksi - Toteuta ristiintarkistus kriittiselle tiedolle
- Käsittele puuttuvat tulokset automaattisella uudelleenmuotoilulla