Konfigurácia a ovládanie výsledkov vyhľadávania na webe
Na tejto strane
- Konfigurácia a ovládanie výsledkov vyhľadávania na webe
- Parameter search_context_size
- Usmerňovanie vyhľadávacích dotazov cez prompt
- Extrakcia a štruktúrovanie citácií
- Vzorec: vyhľadávanie s krížovou validáciou
- Spracovanie prípadu bez výsledkov
- Vyhľadávanie na webe so streamovaním
- Filtrovanie domén a zoznam zdrojov
- Kľúčové poznatky
Lekcia aktualizovaná 2. novembra 2026 na základe dokumentácie OpenAI: nástroj Code Interpreter vyžaduje parameter
container(pridaný do všetkých príkladov), vstupné textové časti majú typinput_texta vyhľadávanie na webe používa nástrojweb_search(web_search_previewje teraz zastaraný nástroj bez filtrov domén). Vygenerované súbory sa získavajú pomocou funkciífichiers_generesatelechargerz Lekcie 10. Zdroje: Code Interpreter · Web search.
Konfigurácia a ovládanie výsledkov vyhľadávania na webe
Aktivácia vyhľadávania na webe si vyžiada jeden riadok kódu, no získanie spoľahlivých odpovedí si vyžaduje tri nastavenia, ktoré si v tejto lekcii podrobne rozoberieme. Prvé rozhoduje o tom, koľko webového obsahu sa vloží do kontextu, čo priamo ovplyvňuje vaše náklady. Druhé smeruje dotazy, ktoré si model formulujú sám – pretože ich píše on, nie ty. Tretie sa týka citácií; bez nich je odpoveď s uvedeným zdrojom len obyčajným tvrdením.
Parameter search_context_size
Parameter search_context_size riadi, koľko webového obsahu sa vloží do kontextu modelu. Mení ani počet vyhľadávaní, ani ich kvalitu: určuje, koľko textu sa po nájdení stránok skutočne dostane do promptu. Je to kompromis medzi úplnosťou a cenou, ktorý by si mal ladeniť podľa typu úlohy, nie nastaviť raz a zabudnúť naň.
from openai import OpenAI
client = OpenAI()
# Minimálny kontext: rýchle, stručné odpovede
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"
}]
)
# Stredný kontext: dobrý kompromis (predvolené)
response = client.responses.create(
model="gpt-5.6-terra",
input="Summarize AI market trends in Europe",
tools=[{
"type": "web_search",
"search_context_size": "medium"
}]
)
# Veľký kontext: hĺbková analýza
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"
}]
)
Vplyv na náklady a latenciu
Zlaté pravidlo je jednoduché: zvýš hodnotu o stupeň vyššie len vtedy, keď ťa získaná odpoveď konkrétne sklamala. Na dátum, číslo alebo faktické potvrdenie nepotrebuješ nič viac než low; použitie high v takom prípade je ako platiť za celý spis, aby si si prečítal jeden riadok.
| Veľkosť | Tokeny kontextu | Latencia | Náklady | Použitie |
|---|---|---|---|---|
low | Minimálne | Rýchla | Nízke | Jednoduché fakty, čísla |
medium | Stredné | Štandardná | Stredné | Zhrnutia, porovnania |
high | Maximálne | Pomalšia | Vysoké | Hĺbková analýza |
Usmerňovanie vyhľadávacích dotazov cez prompt
Tu je bod, ktorý väčšina ľudí objaví príliš neskoro: model si sám formuluje svoje vyhľadávacie dotazy. Napíšeš „aké sú nedávne regulačné zmeny?“ a on to preloží do kľúčových slov, ktoré nikdy neuvidíš. Kvalita výsledkov teda závisí od preformulovania, nad ktorým máš len nepriamu kontrolu – systémový prompt. Pomenuj autoritatívne zdroje vo svojom odbore a obdobie, ktoré ťa zaujíma: to posunie výsledky najviac.
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"
}]
)
Extrakcia a štruktúrovanie citácií
Citácie prichádzajú ako anotácie pripojené k odpovedi, nie priamo v texte. Toto oddelenie je dobrou správou: umožňuje ti zobrazovať zdroje podľa vlastného uváženia, overovať ich alebo zamietnuť odpoveď, ktorá žiadne nemá. V akejkoľvek aplikácii, kde má odpoveď váhu – právna, lekárska, finančná – je bezpečnejšie považovať chýbajúce anotácie za chybu, než slepo dôverovať textu.
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
# Usage
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']}")
Vzorec: vyhľadávanie s krížovou validáciou
Jeden zdroj zostáva len jedným zdrojom, aj keď ho našiel model. Pri informáciách, ktoré ovplyvňujú rozhodovanie, explicitne požaduj potvrdenie z viacerých nezávislých zdrojov a nechaj model označiť nezhody, namiesto toho, aby ich mlčky arbitroval: nezhoda medzi dvoma zdrojmi je sama o sebe informáciou, často užitočnejšou než spriemerovanie oboch.
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"
}
Spracovanie prípadu bez výsledkov
Existuje jeden prípad, na ktorý ľudia zabúdajú: vyhľadávanie nevráti žiadny výsledok. Rizikom nie je absencia odpovede – rizikom je, že model pri nedostatku výsledkov odpovie zo svojich interných vedomostí bez toho, aby to signalizoval, a poskytne ti tak vierohodné, no zastarané informácie. Požiadaj ho, aby to explicitne uviedol, a naplánuj si preformulovanie dotazu.
def search_with_fallback(question: str) -> dict:
"""Web search with failure detection and reformulation."""
# First attempt
response = client.responses.create(
model="gpt-5.6-terra",
input=question,
tools=[{"type": "web_search"}]
)
sources = extract_sources(response)
if len(sources) == 0:
# Automatic reformulation
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
}
Vyhľadávanie na webe so streamovaním
Vyhľadávanie na webe trvá niekoľko sekúnd, niekedy aj viac, ak model reťazí niekoľko dotazov. Pri streamovaní používateľ vidí, ako sa odpoveď postupne buduje, namiesto toho, aby hľadel na indikátor načítavania – a pri tejto type latencie je rozdiel vo vnímaní obrovský pri takmer nulových nákladoch na implementáciu.
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":
# Extract sources at the end
sources = extract_sources(event.response)
print(f"\n\n--- {len(sources)} sources consulted ---")
Filtrovanie domén a zoznam zdrojov
Nástroj web_search akceptuje parameter filters, ktorý obmedzuje vyhľadávanie na zoznam povolených domén (až 100) alebo vylučuje zoznam zakázaných (tiež až 100). Domény zapisuj bez http:// alebo https://. Filtrovanie existuje len pri web_search v Responses API: zastaraný nástroj web_search_preview ho ignoruje.
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)
Možnosť include=["web_search_call.action.sources"] vráti úplný zoznam konzultovaných URL adries, ktorý je často dlhší než zoznam citácií. Samotné citácie prichádzajú ako anotácie url_citation (URL, názov, pozícia v texte): dokumentácia OpenAI vyžaduje, aby si ich vo svojom rozhraní zobrazoval viditeľne a ako klikateľné odkazy.
Kľúčové poznatky
search_context_sizeriadi objem webových dát vložených do kontextufiltersobmedzuje alebo vylučuje domény (max 100);includevypisuje všetky konzultované zdroje- Systémový prompt usmerňuje model k správnym zdrojom
- Extrahuj anotácie
url_citationna vysledovanie zdrojov - Implementuj krížovú validáciu pre kritické informácie
- Spracuj chýbajúce výsledky automatickým preformulovaním