Citaties in resultaten benutten
Op deze pagina
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.

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://)