Automatische citaten en best practices
Op deze pagina
Gefundeerde en betrouwbare antwoorden
Wanneer het model gebruikmaakt van webzoekopdrachten of X-zoekopdrachten, voegt de Responses API automatisch citaties toe aan het antwoord. Met deze citaten kunnen uw gebruikers bronnen verifiëren en vertrouwen krijgen in gegenereerde antwoorden.
Hoe citaten werken
Citaties verschijnen in de annotations-array van elk content-item:
{
"output": [{
"type": "message",
"content": [{
"type": "output_text",
"text": "According to the latest data, the AI market...",
"annotations": [
{
"type": "url_citation",
"url": "https://example.com/article",
"title": "AI Market Analysis in 2026",
"start_index": 35,
"end_index": 68
}
]
}]
}]
}
Velden voor citaten
| Veld | Beschrijving |
|---|---|
type | Altijd url_citation |
url | Bron-URL |
title | Titel van de bronpagina |
start_index | Startpositie in de tekst |
end_index | Eindpositie in de tekst |
Citaten weergeven in uw applicatie
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="What are the latest advancements in AI?",
tools=[{"type": "web_search"}]
)
text = response.output[0].content[0].text
annotations = response.output[0].content[0].annotations
# Tekst met voetnoten opbouwen
footnotes = []
for i, ann in enumerate(annotations, 1):
footnotes.append(f"[{i}] {ann.title} — {ann.url}")
print(text)
print("\n--- Sources ---")
for fn in footnotes:
print(fn)
In HTML
def render_with_citations(text, annotations):
# Sorteren op positie (van eind naar start om indexverschuiving te voorkomen)
sorted_anns = sorted(annotations, key=lambda a: a.start_index, reverse=True)
html = text
for i, ann in enumerate(sorted_anns):
ref_num = len(sorted_anns) - i
link = f'<a href="{ann.url}" title="{ann.title}" target="_blank">[{ref_num}]</a>'
html = html[:ann.end_index] + link + html[ann.end_index:]
return html
Best practices voor productie
1. Valideer altijd de status
response = client.responses.create(...)
if response.status != "completed":
handle_error(response)
return
2. Lege antwoorden afhandelen
if not response.output or not response.output[0].content:
return "The model did not generate a response."
text = response.output[0].content[0].text
3. Log metrieken
Log voor elk productie-verzoek:
response.idvoor traceerbaarheidusage.total_tokensvoor verbruikusage.cost_in_nano_usdvoor kosten- Responstijd aan de clientzijde
- Responsstatus
4. Beveilig uw API-sleutel
- Bewaar deze in een omgevingsvariabele, nooit in code
- Gebruik een secrets manager in productie (Vault, AWS Secrets Manager)
- Roteer uw sleutels regelmatig
- Stel ze nooit bloot aan de clientzijde (browser)
5. Beheer gegenereerde content
Modelantwoorden kunnen ongepaste content bevatten, ondanks filters. Implementeer een moderatielaag als u antwoorden openbaar toont.
6. Plan voor schaalbaarheid
- Gebruik streaming om de waargenomen wachttijd te verkorten
- Implementeer een wachtrijsysteem voor zware verzoeken
- Cache veelvoorkomende antwoorden
- Monitor uw rate limiting-quota
Implementatiecontrolelijst
- Time-out ingesteld op 3600 seconden
- Opnieuw proberen met exponentiële backoff
- Rate limiting aan de clientzijde
- Log metrieken (tokens, kosten, latentie)
- Foutafhandeling (401, 429, 500, time-out)
- Beveiligde API-sleutel
- Contentmoderatie indien nodig
- Kostenmonitoring en waarschuwingen
- Circuit breaker voor veerkracht
Belangrijkste punten
- Citaten zijn automatisch wanneer het model
web_searchofx_searchgebruikt - Ze bevatten de URL, titel en positie in de tekst
- Valideer altijd de status en handel lege antwoorden af
- Beveilig uw API-sleutel—nooit in broncode of aan de clientzijde
- Implementeer logging, opnieuw proberen, rate limiting en monitoring voordat u naar productie gaat
Test uw kennis
De Responses API tot in detail: de laatste controle.
1. Wat biedt de Responses API in vergelijking met Chat Completions?
Antwoord: Het moderne formaat: persistentie van antwoorden aan de serverzijde (GET/DELETE, ketenen op ID), ingebouwde tools en recente functies—de API waarop xAI zich richt voor evolutie.
2. Hoe ketent u een gesprek?
Antwoord: Door te verwijzen naar het vorige antwoord: context wordt aan de serverzijde bewaard—geen behoefte om bij elke beurt de volledige geschiedenis opnieuw te verzenden.
3. Wat is versleutelde redenering?
Antwoord: De interne redenering van het model, teruggegeven in versleutelde vorm: herbruikbaar in volgende beurten zonder leesbaar te zijn—het denkproces reist mee, de vertrouwelijkheid blijft behouden.
4. Wat maakt het mixen van server- en clienttools mogelijk?
Antwoord: Combineer ingebouwde tools die door xAI worden uitgevoerd (webzoekopdrachten, enz.) en uw aangepaste functies die door uw code worden uitgevoerd—elke tool op de juiste plek, georkestreerd in hetzelfde verzoek.
5. Wat zijn de best practices voor productie?
Antwoord: Handel time-out en opnieuw proberen af, volg facturatie (tokens, tools) en maak gebruik van automatische citaten voor verifieerbare antwoorden—robuustheid en vertrouwen samen.
Persistentie, tools, versleutelde redenering, citaten: de Responses API is de moderne basis—hier bouwt u uw Grok-toepassingen.