Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Citaties in resultaten benutten

Les 3 van 14 Bijgewerkt op 30 juli 2026 Beginner
Op deze pagina
  1. Traceerbare antwoorden met citaties
  2. Globale citaties: de complete bronnenlijst
  3. Inline citaties: referenties in de tekst
  4. Het gestructureerde annotatieschema
  5. Gedrag bij streaming
  6. Een interface met bronnen bouwen
  7. Citaties uit collecties
  8. Praktijkoefening
  9. Belangrijkste punten

Traceerbare antwoorden met citaties

Wanneer een gebruiker uw applicatie een feitelijke vraag stelt, wil die de informatie kunnen verifiëren. De citaties van de Grok API voldoen precies aan deze behoefte: elk feit dat via webzoekopdrachten wordt opgehaald, wordt voorzien van zijn bron. Hiermee bouwt u interfaces waarin elke bewering aanklikbaar en verifieerbaar is.

Citaties en bronnen in Grok-antwoorden

De API biedt twee complementaire citatiemechanismen: globale citaties en inline citaties. Inzicht in de werking hiervan stelt u in staat professionele en transparante gebruikerservaringen te creëren.

Globale citaties: de complete bronnenlijst

Globale citaties worden standaard teruggegeven in het attribuut citations van het antwoord. Ze bevatten een lijst van alle URL’s die door het model zijn geraadpleegd, zelfs die niet direct in de antwoordtekst worden genoemd.

response = client.responses.create(
    model="grok-4.5",
    input="What are the latest AI regulations in Europe?",
    tools=[{"type": "web_search"}]
)

# Access global citations
for citation in response.citations:
    print(f"Source: {citation.url}")

Er is geen extra configuratie vereist. Dit is het native gedrag van de API.

Inline citaties: referenties in de tekst

Inline citaties voegen Markdown-links direct in de antwoordtekst in, met de notatie [[N]](url) waarbij N een opeenvolgend nummer is dat bij 1 begint. Als dezelfde bron meerdere keren wordt geciteerd, wordt het oorspronkelijke nummer hergebruikt.

Het standaardgedrag hangt af van de gebruikte SDK:

  • Direct Responses API: inline citaties standaard ingeschakeld
  • xAI SDK: inline citaties standaard uitgeschakeld (opt-in)

Inline citaties inschakelen met de xAI SDK

response = client.responses.create(
    model="grok-4.5",
    input="Current status of the European AI Act",
    tools=[{"type": "web_search"}],
    include=["inline_citations"]
)

Inline citaties uitschakelen via de Responses API

response = client.responses.create(
    model="grok-4.5",
    input="Current status of the European AI Act",
    tools=[{"type": "web_search"}],
    include=["no_inline_citations"]
)

Het gestructureerde annotatieschema

Elke inline citatie genereert een annotatieobject met nauwkeurige metadata. Deze structuur maakt geavanceerde programmatische verwerking mogelijk:

{
  "type": "url_citation",
  "url": "https://eur-lex.europa.eu/eli/reg/2024/1689",
  "start_index": 145,
  "end_index": 178,
  "title": "1"
}

De velden start_index en end_index volgen de Python-slice-conventie. U kunt ze gebruiken om de exact geciteerde tekst te extraheren of om aangepaste HTML-rendering te maken:

text = response.output_text

for annotation in response.annotations:
    cited_text = text[annotation.start_index:annotation.end_index]
    print(f"Cited text: {cited_text}")
    print(f"Source: {annotation.url}")

Gedrag bij streaming

Bij gebruik van streaming verschijnen inline citaties geleidelijk in de tekstchunks. Volledige annotaties zijn echter pas beschikbaar in het definitieve antwoord. Houd rekening met een tweefasenverwerking als uw interface bronnen in real-time weergeeft.

Een interface met bronnen bouwen

Hier volgt een voorbeeld van hoe u citaties omzet in gestructureerde HTML:

def format_response_with_sources(response):
    text = response.output_text
    sources = []

    # Collect unique sources
    seen_urls = set()
    for citation in response.citations:
        if citation.url not in seen_urls:
            sources.append(citation.url)
            seen_urls.add(citation.url)

    # Build the render
    html = f"<div class='response'>{text}</div>"
    html += "<div class='sources'><h4>Sources</h4><ul>"
    for i, url in enumerate(sources, 1):
        html += f"<li><a href='{url}'>[{i}] {url}</a></li>"
    html += "</ul></div>"

    return html

Citaties uit collecties

Als u het hulpmiddel collections_search gebruikt naast web_search, gebruiken citaties uit uw geüploade documenten een specifiek URI-formaat: collections://collection_id/files/file_id. Maak onderscheid tussen deze en standaard webcitaties om de frontend-rendering aan te passen.

Praktijkoefening

Bouw een applicatie die Grok-zoekresultaten weergeeft met een voetnotensysteem. Elk feit moet linken naar de oorspronkelijke bron. Test met vragen over actuele gebeurtenissen en verifieer handmatig dat de links geldig en relevant zijn.

Belangrijkste punten

  • Globale citaties (URL-lijst) worden standaard teruggegeven, zonder configuratie
  • Inline citaties (links in tekst) schakelt u in via de parameter include
  • Het standaardgedrag voor inline citaties verschilt per SDK
  • Elke annotatie bevat de URL, positie-indexen en het citatienummer
  • Bij streaming zijn volledige annotaties pas beschikbaar in het definitieve antwoord
  • Citaties uit collecties gebruiken een ander URI-formaat (collections://)