Zum Hauptinhalt springen
Deutsch— Sprache auswählen
Menü

Zitierungen in Ergebnissen nutzen

Lektion 3 von 14 Aktualisiert am 30. Juli 2026 Anfänger
Auf dieser Seite
  1. Nachvollziehbare Antworten durch Zitierungen
  2. Globale Zitierungen: Die vollständige Quellenliste
  3. Inline-Zitierungen: Referenzen im Text
  4. Das Schema der strukturierten Annotation
  5. Streaming-Verhalten
  6. Aufbau einer Schnittstelle mit Quellen
  7. Sammlungs-Zitierungen
  8. Praktische Übung
  9. Kernaussagen

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.

Zitierungen und Quellen in Grok-Antworten

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 include aktiviert
  • 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://)