Wykorzystywanie cytowań w wynikach
Na tej stronie
Odpowiedzi możliwe do zweryfikowania dzięki cytowaniom
Gdy użytkownik zadaje Twojej aplikacji pytanie faktograficzne, chce mieć możliwość weryfikacji podanych informacji. Cytowania w API Grok idealnie odpowiadają na tę potrzebę: każdy fakt uzyskany poprzez wyszukiwanie w sieci jest opatrzony źródłem. Pozwala to budować interfejsy, w których każde twierdzenie jest klikalne i możliwe do sprawdzenia.

API oferuje dwa uzupełniające się mechanizmy cytowania: cytowania globalne i cytowania śródtekstowe. Zrozumienie ich działania pozwala tworzyć profesjonalne i przejrzyste doświadczenia użytkownika.
Cytowania globalne: kompletna lista źródeł
Cytowania globalne są zwracane domyślnie w atrybucie citations odpowiedzi. Zawierają listę wszystkich adresów URL consulted przez model, nawet tych, które nie zostały bezpośrednio przywołane w tekście odpowiedzi.
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}")
Nie jest wymagana żadna dodatkowa konfiguracja. Jest to natywne zachowanie API.
Cytowania śródtekstowe: odniesienia w treści
Cytowania śródtekstowe wstawiają linki Markdown bezpośrednio do tekstu odpowiedzi, używając formatu [[N]](url), gdzie N to numer sekwencyjny zaczynający się od 1. Jeśli to samo źródło jest cytowane wielokrotnie, oryginalny numer jest ponownie wykorzystywany.
Domyślne zachowanie zależy od używanego SDK:
- Bezpośrednie API Responses: cytowania śródtekstowe włączone domyślnie
- xAI SDK: cytowania śródtekstowe wyłączone domyślnie (opcjonalne włączenie)
Włączanie cytowań śródtekstowych w 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"]
)
Wyłączanie cytowań śródtekstowych w API Responses
response = client.responses.create(
model="grok-4.5",
input="Current status of the European AI Act",
tools=[{"type": "web_search"}],
include=["no_inline_citations"]
)
Ustrukturyzowany schemat adnotacji
Każde cytowanie śródtekstowe generuje obiekt adnotacji zawierający precyzyjne metadane. Struktura ta umożliwia zaawansowane przetwarzanie programistyczne:
{
"type": "url_citation",
"url": "https://eur-lex.europa.eu/eli/reg/2024/1689",
"start_index": 145,
"end_index": 178,
"title": "1"
}
Pola start_index i end_index遵循 konwencję wycinania (slice) w Pythonie. Możesz ich użyć do wyodrębnienia dokładnie cytowanego tekstu lub stworzenia niestandardowego renderowania HTML:
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}")
Zachowanie podczas streamingu
Podczas korzystania ze streamingu, cytowania śródtekstowe pojawiają się stopniowo w fragmentach tekstu. Jednak kompletne adnotacje są dostępne wyłącznie w ostatecznej odpowiedzi. Zaplanuj przetwarzanie dwuetapowe, jeśli Twój interfejs wyświetla źródła w czasie rzeczywistym.
Budowanie interfejsu ze źródłami
Oto przykład przekształcania cytowań w ustrukturyzowany 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
Cytowania z kolekcji
Jeśli używasz narzędzia collections_search obok web_search, cytowania pochodzące z przesłanych przez Ciebie dokumentów używają specyficznego formatu URI: collections://collection_id/files/file_id. Rozróżniaj je od standardowych cytowań sieciowych, aby dostosować renderowanie front-endu.
Ćwiczenia praktyczne
Stwórz aplikację wyświetlającą wyniki wyszukiwania Grok z systemem przypisów dolnych. Każdy fakt powinien linkować z powrotem do swojego oryginalnego źródła. Przetestuj aplikację, zadając pytania dotyczące bieżących wydarzeń, i ręcznie zweryfikuj, czy linki są ważne i istotne.
Kluczowe wnioski
- Cytowania globalne (lista URL) są zwracane domyślnie, bez konieczności konfiguracji
- Cytowania śródtekstowe (linki w tekście) są włączane poprzez parametr
include - Domyślne zachowanie cytowań śródtekstowych różni się w zależności od SDK
- Każda adnotacja zawiera adres URL, indeksy pozycji oraz numer cytowania
- W streamingu kompletne adnotacje są dostępne wyłącznie w ostatecznej odpowiedzi
- Cytowania z kolekcji używają odrębnego formatu URI (
collections://)