Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Webresultaten configureren en sturen

Les 6 van 20 Bijgewerkt op 2 november 2026 Ontwikkelaar
Op deze pagina
  1. Webresultaten configureren en sturen
  2. De parameter search_context_size
  3. Zoekopdrachten sturen via de prompt
  4. Citaten extraheren en structureren
  5. Patroon: zoeken met kruisvalidatie
  6. Omgaan met geen resultaten
  7. Web Search met streaming
  8. Domeinen filteren en bronnen lijst
  9. Belangrijkste punten

Les bijgewerkt op 2 november 2026 op basis van OpenAI-documentatie: de Code Interpreter-tool vereist een container-parameter (toegevoegd aan alle voorbeelden), invoertekstdelen zijn van het type input_text, en webzoeken gebruikt de web_search-tool (web_search_preview is nu een verouderde tool zonder domeinfilters). Gegenereerde bestanden worden opgehaald met de functies fichiers_generes en telecharger uit Les 10. Bronnen: Code Interpreter · Web search.

Webresultaten configureren en sturen

Web Search inschakelen kost één regel code; betrouwbare antwoorden verkrijgen vereist drie instellingen die deze les uiteenzet. De eerste bepaalt hoeveel webinhoud in de context wordt geïnjecteerd, wat directe invloed heeft op uw factuur. De tweede stuurt de zoekopdrachten die het model zelf formuleert—want het schrijft ze, niet u. De derde betreft citaten; zonder deze is een onderbouwd antwoord slechts een bewering.

De parameter search_context_size

De parameter search_context_size regelt hoeveel webinhoud in de context van het model wordt geïnjecteerd. Dit wijzigt noch het aantal zoekopdrachten, noch de kwaliteit ervan: het bepaalt hoeveel tekst, zodra pagina’s zijn gevonden, daadwerkelijk in de prompt terechtkomt. Dit is een afweging tussen volledigheid en kosten, die u per taaktype moet afstemmen in plaats van eenmalig in te stellen en te vergeten.

from openai import OpenAI

client = OpenAI()

# Minimale context: snelle, beknopte antwoorden
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"
    }]
)

# Gemiddelde context: goed compromis (standaard)
response = client.responses.create(
    model="gpt-5.6-terra",
    input="Summarize AI market trends in Europe",
    tools=[{
        "type": "web_search",
        "search_context_size": "medium"
    }]
)

# Grote context: diepgaande analyse
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"
    }]
)

Impact op kosten en latentie

De vuistregel is simpel: verhoog de instelling alleen een stap als het verkregen antwoord u concreet heeft teleurgesteld. Voor een datum, een cijfer of een feitelijke bevestiging volstaat low; high gebruiken daarvoor is alsof u betaalt voor een volledig dossier om één regel te lezen.

GrootteContext-tokensLatentieKostenGebruik
lowMinimaalSnelLaagEenvoudige feiten, cijfers
mediumGematigdStandaardGemiddeldSamenvattingen, vergelijkingen
highMaximaalLangzamerHoogDiepgaande analyse

Zoekopdrachten sturen via de prompt

Dit is het punt dat de meeste mensen te laat ontdekken: het model formuleert zijn eigen zoekopdrachten. U typt “wat zijn de recente regelgevingswijzigingen?” en het vertaalt dit naar trefwoorden die u nooit te zien krijgt. De kwaliteit van het resultaat hangt daarom af van een herformulering waarover u slechts indirecte controle heeft—de systeemprompt. Noem de gezaghebbende bronnen in uw vakgebied en de periode die u interesseert: dat maakt het grootste verschil.

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"
    }]
)

Citaten extraheren en structureren

Citaten arriveren als annotaties die aan het antwoord zijn gekoppeld, niet in de tekst zelf. Deze scheiding is goed nieuws: het stelt u in staat bronnen weer te geven zoals u wilt, ze te verifiëren, of een antwoord zonder bronnen te verwerpen. In elke applicatie waar het antwoord gewicht in de schaal legt—juridisch, medisch, financieel—is het veiliger om ontbrekende annotaties als een fout te behandelen dan de tekst blindelings te vertrouwen.

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']}")

Patroon: zoeken met kruisvalidatie

Eén bron blijft één bron, zelfs als een model deze heeft gevonden. Voor informatie die een beslissing stuurt, vraagt u expliciet om bevestiging uit meerdere onafhankelijke bronnen en laat u het model tegenstrijdigheden markeren in plaats van deze stilzwijgend op te lossen: een meningsverschil tussen twee bronnen is op zichzelf informatie, vaak nuttiger dan het middelen van de twee.

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"
    }

Omgaan met geen resultaten

Er is één geval dat mensen vergeten af te handelen: de zoekopdracht levert niets op. Het risico is niet het ontbreken van een antwoord—het is dat het model, bij gebrek aan resultaten, antwoordt vanuit zijn interne kennis zonder dit te signaleren, waardoor u aannemelijke maar verouderde informatie krijgt. Vraag het model dit expliciet te melden en voorzie een herformulering.

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
    }

Web Search met streaming

Een webzoekopdracht duurt enkele seconden, soms langer als het model meerdere queries ketent. Met streaming ziet de gebruiker het antwoord opbouwen in plaats van naar een laadindicator te staren—en voor dit soort latentie is het perceptieverschil enorm tegen vrijwel geen implementatiekosten.

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 ---")

Domeinen filteren en bronnen lijst

De web_search-tool accepteert een filters-parameter die de zoekopdracht beperkt tot een lijst van toegestane domeinen (maximaal 100) of een lijst uitsluit (ook maximaal 100). Schrijf domeinen zonder http:// of https://. Filteren bestaat alleen bij web_search in de Responses API: de verouderde web_search_preview-tool negeert dit.

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)

De optie include=["web_search_call.action.sources"] retourneert de volledige lijst van geraadpleegde URL’s, vaak langer dan de lijst met citaten. Citaten zelf arriveren als url_citation-annotaties (URL, titel, positie in de tekst): de documentatie van OpenAI vraagt dat u deze zichtbaar en aanklikbaar weergeeft in uw interface.

Belangrijkste punten

  • search_context_size regelt het volume aan webdata dat wordt geïnjecteerd
  • filters beperkt of sluit domeinen uit (max 100); include lijst alle geraadpleegde bronnen
  • De systeemprompt leidt het model naar de juiste bronnen
  • Extraheer url_citation-annotaties om bronnen te traceren
  • Implementeer kruisvalidatie voor kritieke informatie
  • Handel ontbrekende resultaten af met automatische herformulering