Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Automatische citaten en best practices

Les 16 van 16 Bijgewerkt op 30 juli 2026 Ontwikkelaar
Op deze pagina
  1. Gefundeerde en betrouwbare antwoorden
  2. Hoe citaten werken
  3. Citaten weergeven in uw applicatie
  4. Best practices voor productie
  5. Implementatiecontrolelijst
  6. Belangrijkste punten
  7. Test uw kennis

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

VeldBeschrijving
typeAltijd url_citation
urlBron-URL
titleTitel van de bronpagina
start_indexStartpositie in de tekst
end_indexEindpositie 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.id voor traceerbaarheid
  • usage.total_tokens voor verbruik
  • usage.cost_in_nano_usd voor 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_search of x_search gebruikt
  • 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.