Využívanie citácií vo výsledkoch
Na tejto strane
Vysledovateľné odpovede s citáciami
Keď sa používateľ tvojej aplikácie opýta na faktickú otázku, chce si overiť získané informácie. Citácie v API Grok túto potrebu presne napĺňajú: každý fakt získaný prostredníctvom webového vyhľadávania je vybavený svojím zdrojom. To ti umožňuje budovať rozhrania, kde je každé tvrdenie klikateľné a overiteľné.

API ponúka dva doplnkové mechanizmy citácií: globálne citácie a inline citácie. Pochopenie ich fungovania ti umožní vytvárať profesionálne a transparentné používateľské skúsenosti.
Globálne citácie: Kompletný zoznam zdrojov
Globálne citácie sa vracajú predvolene v atribúte citations odpovede. Obsahujú zoznam všetkých URL adries, ktoré model konzultoval, dokonca aj tých, ktoré nie sú priamo uvedené v texte odpovede.
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 je potrebná žiadna dodatočná konfigurácia. Toto je natívne správanie API.
Inline citácie: Referencie v texte
Inline citácie vkladajú odkazy Markdown priamo do textu odpovede pomocou formátu [[N]](url), kde N je sekvenčné číslo začínajúce od 1. Ak sa ten istý zdroj cituje viackrát, pôvodné číslo sa znovu použije.
Predvolené správanie závisí od použitého SDK:
- Priame Responses API: inline citácie sú predvolene povolené
- xAI SDK: inline citácie sú predvolene zakázané (nutné explicitné povolenie)
Povolenie inline citácií pomocou 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ázanie inline citácií 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"]
)
Štruktúrovaná schéma anotácií
Každá inline citácia generuje objekt anotácie s presnými metadátami. Táto štruktúra umožňuje pokročilé programové spracovanie:
{
"type": "url_citation",
"url": "https://eur-lex.europa.eu/eli/reg/2024/1689",
"start_index": 145,
"end_index": 178,
"title": "1"
}
Polia start_index a end_index sa riadia konvenciou slice v Pythone. Môžeš ich použiť na extrakciu presne citovaného textu alebo na vytvorenie vlastného vykresľovania 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}")
Správanie pri streamovaní
Pri použití streamovania sa inline citácie objavujú postupne v chunkoch textu. Kompletné anotácie sú však dostupné až vo finálnej odpovedi. Ak tvoje rozhranie zobrazuje zdroje v reálnom čase, naplánuj si dvojfázové spracovanie.
Vytvorenie rozhrania so zdrojmi
Tu je príklad transformácie citácií na štruktúrované 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
Citácie z kolekcií
Ak používaš nástroj collections_search spolu s web_search, citácie z tvojich nahraných dokumentov používajú špecifický formát URI: collections://collection_id/files/file_id. Rozlišuj tieto citácie od štandardných webových citácií, aby si mohol prispôsobiť vykresľovanie na strane klienta (front-end).
Praktické cvičenie
Vytvor aplikáciu, ktorá zobrazuje výsledky vyhľadávania Grok so systémom poznámok pod čiarou. Každý fakt by mal odkazovať späť na svoj pôvodný zdroj. Otestuj to otázkami týkajúcimi sa aktuálneho diania a manuálne over, či sú odkazy platné a relevantné.
Kľúčové poznatky
- Globálne citácie (zoznam URL) sa vracajú predvolene bez potreby konfigurácie
- Inline citácie (odkazy v texte) sa povoľujú prostredníctvom parametra
include - Predvolené správanie inline citácií sa líši podľa použitého SDK
- Každá anotácia obsahuje URL, indexy pozície a číslo citácie
- Pri streamovaní sú kompletné anotácie dostupné až vo finálnej odpovedi
- Citácie z kolekcií používajú odlišný formát URI (
collections://)