Utnyttja citeringar i svar
På denna sida
Spårbara svar med citeringar
När en användare ställer en faktabaserad fråga till din applikation vill hen kunna verifiera informationen. Grok API:s citeringar möter exakt detta behov: varje faktauppgift som hämtas via webbsökning levereras tillsammans med sin källa. Detta låter dig bygga gränssnitt där varje påstående är klickbart och verifierbart.

API:et erbjuder två komplementära citeringsmekanismer: globala citeringar och inline-citeringar. Att förstå hur de fungerar låter dig skapa professionella och transparenta användarupplevelser.
Globala citeringar: Den kompletta källförteckningen
Globala citeringar returneras som standard i attributet citations i svaret. De innehåller en lista över alla URL:er som modellen har konsulterat, även de som inte refereras till direkt i svarstexten.
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}")
Ingen ytterligare konfiguration krävs. Detta är API:ets naturliga beteende.
Inline-citeringar: Referenser i texten
Inline-citeringar infogar Markdown-länkar direkt i svarstexten, med formatet [[N]](url) där N är ett löpande nummer som börjar på 1. Om samma källa citeras flera gånger återanvänds det ursprungliga numret.
Standardbeteendet beror på vilken SDK du använder:
- Direct Responses API: inline-citeringar aktiverade som standard
- xAI SDK: inline-citeringar inaktiverade som standard (måste aktiveras manuellt)
Aktivera inline-citeringar 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"]
)
Inaktivera inline-citeringar 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 strukturerade annotationsschemat
Varje inline-citering genererar ett annotationsobjekt med exakt metadata. Denna struktur möjliggör avancerad programmatisk bearbetning:
{
"type": "url_citation",
"url": "https://eur-lex.europa.eu/eli/reg/2024/1689",
"start_index": 145,
"end_index": 178,
"title": "1"
}
Fälten start_index och end_index följer Pythons slice-konvention. Du kan använda dem för att extrahera den exakta citerade texten eller skapa anpassad 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}")
Beteende vid strömning
När du använder strömning visas inline-citeringar progressivt i textblocken. Fullständiga annotationer finns dock endast tillgängliga i det slutgiltiga svaret. Planera för tvåstegsbearbetning om ditt gränssnitt visar källor i realtid.
Bygga ett gränssnitt med källor
Här är ett exempel på hur du omvandlar citeringar till strukturerad 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
Samlingsciteringar
Om du använder verktyget collections_search tillsammans med web_search använder citeringar från dina uppladdade dokument ett specifikt URI-format: collections://collection_id/files/file_id. Skilj dessa från vanliga webbciteringar för att anpassa renderingen i front-end.
Praktisk övning
Skapa en applikation som visar Grok-sökresultat med ett fotnotssystem. Varje faktauppgift ska länka tillbaka till sin ursprungliga källa. Testa med frågor om aktuella händelser och verifiera manuellt att länkarna är giltiga och relevanta.
Viktiga punkter
- Globala citeringar (URL-lista) returneras som standard, utan konfiguration
- Inline-citeringar (länkar i text) aktiveras via parametern
include - Standardbeteendet för inline-citeringar varierar beroende på SDK
- Varje annotation innehåller URL, positionsindex och citeringsnummer
- Vid strömning finns fullständiga annotationer endast tillgängliga i det slutgiltiga svaret
- Samlingsciteringar använder ett distinkt URI-format (
collections://)