Zitierungen in Ergebnissen nutzen
Auf dieser Seite
Nachvollziehbare Antworten durch Zitierungen
Wenn ein Nutzer Ihrer Anwendung eine faktische Frage stellt, möchte er die Informationen überprüfen. Die Zitierungen der Grok-API erfüllen genau diesen Bedarf: Jede über die Web-Suche abgerufene Tatsache wird mit ihrer Quelle versehen. So können Sie Schnittstellen erstellen, bei denen jede Behauptung anklickbar und überprüfbar ist.

Die API bietet zwei sich ergänzende Zitierungsmechanismen: globale Zitierungen und Inline-Zitierungen. Das Verständnis ihrer Funktionsweise ermöglicht es Ihnen, professionelle und transparente Nutzererlebnisse zu gestalten.
Globale Zitierungen: Die vollständige Quellenliste
Globale Zitierungen werden standardmäßig im Attribut citations der Antwort zurückgegeben. Sie enthalten eine Liste aller von dem Modell konsultierten URLs, auch solcher, die nicht direkt im Antworttext referenziert werden.
response = client.responses.create(
model="grok-4.5",
input="Was sind die neuesten KI-Regulierungen in Europa?",
tools=[{"type": "web_search"}]
)
# Zugriff auf globale Zitierungen
for citation in response.citations:
print(f"Quelle: {citation.url}")
Es ist keine zusätzliche Konfiguration erforderlich. Dies ist das native Verhalten der API.
Inline-Zitierungen: Referenzen im Text
Inline-Zitierungen fügen Markdown-Links direkt in den Antworttext ein, im Format [[N]](url), wobei N eine fortlaufende Nummer ist, die bei 1 beginnt. Wird dieselbe Quelle mehrfach zitiert, wird die ursprüngliche Nummer wiederverwendet.
Das Standardverhalten hängt vom verwendeten SDK ab:
- Direct Responses API: Inline-Zitierungen standardmäßig aktiviert
- xAI SDK: Inline-Zitierungen standardmäßig deaktiviert (Opt-in erforderlich)
Aktivieren von Inline-Zitierungen mit dem xAI SDK
response = client.responses.create(
model="grok-4.5",
input="Aktueller Status des europäischen KI-Gesetzes",
tools=[{"type": "web_search"}],
include=["inline_citations"]
)
Deaktivieren von Inline-Zitierungen auf der Responses API
response = client.responses.create(
model="grok-4.5",
input="Aktueller Status des europäischen KI-Gesetzes",
tools=[{"type": "web_search"}],
include=["no_inline_citations"]
)
Das Schema der strukturierten Annotation
Jede Inline-Zitierung generiert ein Annotationsobjekt mit präzisen Metadaten. Diese Struktur ermöglicht eine fortgeschrittene programmatische Verarbeitung:
{
"type": "url_citation",
"url": "https://eur-lex.europa.eu/eli/reg/2024/1689",
"start_index": 145,
"end_index": 178,
"title": "1"
}
Die Felder start_index und end_index folgen der Python-Slice-Konvention. Sie können sie verwenden, um den exakt zitierten Text auszulesen oder eine benutzerdefinierte HTML-Darstellung zu erstellen:
text = response.output_text
for annotation in response.annotations:
cited_text = text[annotation.start_index:annotation.end_index]
print(f"Zitiert: {cited_text}")
print(f"Quelle: {annotation.url}")
Streaming-Verhalten
Beim Streaming erscheinen Inline-Zitierungen schrittweise in den Text-Blöcken. Vollständige Annotationen sind jedoch nur in der finalen Antwort verfügbar. Planen Sie eine zweistufige Verarbeitung, wenn Ihre Schnittstelle Quellen in Echtzeit anzeigt.
Aufbau einer Schnittstelle mit Quellen
Hier ist ein Beispiel für die Umwandlung von Zitierungen in strukturiertes HTML:
def format_response_with_sources(response):
text = response.output_text
sources = []
# Sammeln eindeutiger Quellen
seen_urls = set()
for citation in response.citations:
if citation.url not in seen_urls:
sources.append(citation.url)
seen_urls.add(citation.url)
# Render erstellen
html = f"<div class='response'>{text}</div>"
html += "<div class='sources'><h4>Quellen</h4><ul>"
for i, url in enumerate(sources, 1):
html += f"<li><a href='{url}'>[{i}] {url}</a></li>"
html += "</ul></div>"
return html
Sammlungs-Zitierungen
Wenn Sie das Tool collections_search neben web_search verwenden, nutzen Zitierungen aus Ihren hochgeladenen Dokumenten ein spezifisches URI-Format: collections://collection_id/files/file_id. Unterscheiden Sie diese von Standard-Web-Zitierungen, um die Frontend-Darstellung anzupassen.
Praktische Übung
Erstellen Sie eine Anwendung, die Grok-Suchergebnisse mit einem Fußnotensystem anzeigt. Jede Tatsache sollte auf ihre ursprüngliche Quelle verlinken. Testen Sie dies mit Fragen zu aktuellen Ereignissen und überprüfen Sie manuell, dass die Links gültig und relevant sind.
Kernaussagen
- Globale Zitierungen (URL-Liste) werden standardmäßig zurückgegeben, ohne Konfiguration
- Inline-Zitierungen (Links im Text) werden über den Parameter
includeaktiviert - Das Standardverhalten für Inline-Zitierungen variiert je nach SDK
- Jede Annotation enthält die URL, Positionsindizes und die Zitationsnummer
- Beim Streaming sind vollständige Annotationen nur in der finalen Antwort verfügbar
- Sammlungs-Zitierungen verwenden ein distinctes URI-Format (
collections://)