Udnyttelse af citater i resultater
På denne side
Sporbar svar med citater
Når en bruger stiller din applikation et faktaspørgsmål, ønsker vedkommende at kunne verificere informationen. Grok API’s citater imødekommer præcis dette behov: hver faktaoplysning, der hentes via websøgning, leveres med sin kilde. Dette giver dig mulighed for at bygge grænseflader, hvor hvert udsagn er klikbart og verificerbart.

API’et tilbyder to komplementære citatmekanismer: globale citater og inline-citater. Når du forstår, hvordan de fungerer, kan du skabe professionelle og transparente brugeroplevelser.
Globale citater: Den komplette kildeliste
Globale citater returneres som standard i attributten citations i svaret. De indeholder en liste over alle URL’er, som modellen har konsulteret, også dem der ikke er direkte refereret til i selve svarsteksten.
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}")
Der kræves ingen yderligere konfiguration. Dette er API’ets native adfærd.
Inline-citater: Referencer i teksten
Inline-citater indsætter Markdown-links direkte i svarsteksten ved hjælp af formatet [[N]](url), hvor N er et løbenummer startende fra 1. Hvis samme kilde citeres flere gange, genbruges det oprindelige nummer.
Standardadfærden afhænger af det SDK, du bruger:
- Direct Responses API: inline-citater aktiveret som standard
- xAI SDK: inline-citater deaktiveret som standard (skal aktiveres eksplicit)
Aktiver inline-citater med 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"]
)
Deaktiver inline-citater på 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"]
)
Det strukturerede annotationsskema
Hvert inline-citat genererer et annotationsobjekt med præcise metadata. Denne struktur muliggør avanceret programmatisk behandling:
{
"type": "url_citation",
"url": "https://eur-lex.europa.eu/eli/reg/2024/1689",
"start_index": 145,
"end_index": 178,
"title": "1"
}
Felterne start_index og end_index følger Pythons slice-konvention. Du kan bruge dem til at udtrække den præcist citerede tekst eller skabe custom HTML-rendering:
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}")
Adfærd ved streaming
Når du bruger streaming, vises inline-citater progressivt i tekstchunks. Komplette annotationer er dog kun tilgængelige i det endelige svar. Planlæg for totrinsbehandling, hvis din grænseflade skal vise kilder i realtid.
Byg en grænseflade med kilder
Her er et eksempel på, hvordan du transformerer citater til struktureret 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
Samlingscitater
Hvis du bruger værktøjet collections_search sammen med web_search, bruger citater fra dine uploadede dokumenter et specifikt URI-format: collections://collection_id/files/file_id. Skeln mellem disse og almindelige webcitater for at tilpasse front-end-renderingen.
Praktisk øvelse
Opret en applikation, der viser Grok-søgeresultater med et fodnotesystem. Hver faktaoplysning skal linke tilbage til sin oprindelige kilde. Test med spørgsmål om aktuelle begivenheder, og verificér manuelt, at linkene er gyldige og relevante.
Vigtige pointer
- Globale citater (URL-liste) returneres som standard uden konfiguration
- Inline-citater (links i tekst) aktiveres via parameteren
include - Standardadfærd for inline-citater varierer afhængigt af SDK
- Hver annotation indeholder URL, positionsindeks og citatnummer
- Ved streaming er komplette annotationer kun tilgængelige i det endelige svar
- Samlingscitater bruger et særskilt URI-format (
collections://)