Využití citací ve výsledcích
Na této stránce
Vysledovatelné odpovědi s citacemi
Když se uživatel zeptá tvé aplikace na faktickou otázku, chce si informace ověřit. Citace v API Grok tento požadavek přesně splňují: každý fakt získaný prostřednictvím vyhledávání na webu je opatřen zdrojem. To ti umožňuje budovat rozhraní, kde je každé tvrzení klikací a ověřitelné.

API nabízí dva doplňkové mechanismy citací: globální citace a inline citace. Pochopení jejich fungování ti umožní vytvářet profesionální a transparentní uživatelské zážitky.
Globální citace: Kompletní seznam zdrojů
Globální citace jsou vráceny ve výchozím nastavení v atributu citations odpovědi. Obsahují seznam všech URL adres, které model konzultoval, včetně těch, které nejsou přímo uvedeny v textu odpovědi.
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}")
Není vyžadována žádná další konfigurace. Toto je nativní chování API.
Inline citace: Reference v textu
Inline citace vkládají odkazy Markdown přímo do textu odpovědi pomocí formátu [[N]](url), kde N je sekvenční číslo začínající od 1. Pokud je stejný zdroj citován vícekrát, původní číslo se znovu použije.
Výchozí chování závisí na použitém SDK:
- Přímé Responses API: inline citace jsou ve výchozím nastavení povoleny
- xAI SDK: inline citace jsou ve výchozím nastavení zakázány (nutné explicitní povolení)
Povolení inline citací pomocí 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"]
)
Zakázání inline citací v 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"]
)
Strukturované schéma anotací
Každá inline citace generuje objekt anotace s přesnými metadaty. Tato struktura umožňuje pokročilé programové zpracování:
{
"type": "url_citation",
"url": "https://eur-lex.europa.eu/eli/reg/2024/1689",
"start_index": 145,
"end_index": 178,
"title": "1"
}
Pole start_index a end_index se řídí konvencí řezů (slice) v Pythonu. Můžeš je využít k extrakci přesně citovaného textu nebo k vytvoření vlastního vykreslování 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}")
Chování při streamování
Při použití streamování se inline citace objevují postupně v textových blocích (chunks). Kompletní anotace jsou však k dispozici až ve finální odpovědi. Pokud tvé rozhraní zobrazuje zdroje v reálném čase, naplánuj si dvoufázové zpracování.
Vytvoření rozhraní se zdroji
Zde je příklad transformace citací na strukturované 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
Citace z kolekcí
Pokud používáš nástroj collections_search společně s web_search, citace z tvých nahraných dokumentů používají specifický formát URI: collections://collection_id/files/file_id. Rozlišuj tyto citace od standardních webových citací, abys mohl přizpůsobit vykreslování na straně klienta (front-end).
Praktické cvičení
Vytvoř aplikaci, která zobrazuje výsledky vyhledávání Grok se systémem poznámek pod čarou. Každý fakt by měl odkazovat zpět na svůj původní zdroj. Otestuj to na otázkách týkajících se aktuálního dění a ručně ověř, zda jsou odkazy platné a relevantní.
Klíčové poznatky
- Globální citace (seznam URL) jsou vráceny ve výchozím nastavení bez nutnosti konfigurace
- Inline citace (odkazy v textu) jsou povoleny prostřednictvím parametru
include - Výchozí chování inline citací se liší podle použitého SDK
- Každá anotace obsahuje URL, indexy pozic a číslo citace
- Při streamování jsou kompletní anotace k dispozici až ve finální odpovědi
- Citace z kolekcí používají odlišný formát URI (
collections://)