Iskorištavanje citata u rezultatima
Na ovoj stranici
Odgovori s mogućnošću praćenja putem citata
Kada ti korisnik postavi činjenično pitanje, želi moći provjeriti informaciju. Citati Grok API-ja točno zadovoljavaju tu potrebu: svaka činjenica dohvaćena putem web pretraživanja dolazi sa svojim izvorom. To ti omogućuje izgradnju sučelja u kojima je svaka tvrdnja klikabilna i provjerljiva.

API nudi dva komplementarna mehanizma citiranja: globalne citate i inline citate. Razumijevanje njihova rada omogućuje ti stvaranje profesionalnih i transparentnih korisničkih iskustava.
Globalni citati: Potpuni popis izvora
Globalni citati vraćaju se zadano u atributu citations odgovora. Sadrže popis svih URL-ova koje je model konzultirao, čak i onih koji nisu izravno navedeni u tekstu odgovora.
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}")
Nije potrebna nikakva dodatna konfiguracija. To je izvorno ponašanje API-ja.
Inline citati: Reference u tekstu
Inline citati umeću Markdown poveznice izravno u tekst odgovora, koristeći format [[N]](url) gdje je N sekvencijalni broj koji počinje od 1. Ako se isti izvor citira više puta, originalni broj se ponovno koristi.
Zadano ponašanje ovisi o korištenom SDK-u:
- Izravni Responses API: inline citati zadano omogućeni
- xAI SDK: inline citati zadano onemogućeni (opt-in)
Omogući inline citate s xAI SDK-om
response = client.responses.create(
model="grok-4.5",
input="Current status of the European AI Act",
tools=[{"type": "web_search"}],
include=["inline_citations"]
)
Onemogući inline citate na Responses API-ju
response = client.responses.create(
model="grok-4.5",
input="Current status of the European AI Act",
tools=[{"type": "web_search"}],
include=["no_inline_citations"]
)
Shema strukturirane anotacije
Svaki inline citat generira objekt anotacije s preciznim metapodacima. Ova struktura omogućuje naprednu programsku obradu:
{
"type": "url_citation",
"url": "https://eur-lex.europa.eu/eli/reg/2024/1689",
"start_index": 145,
"end_index": 178,
"title": "1"
}
Polja start_index i end_index slijede konvenciju Python sliceova. Možeš ih iskoristiti za izvlačenje točno citiranog teksta ili stvaranje prilagođenog HTML renderiranja:
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}")
Ponašanje kod streamanja
Kada koristiš streamanje, inline citati se pojavljuju progresivno u tekstualnim chunkovima. Međutim, kompletne anotacije dostupne su tek u konačnom odgovoru. Isplaniraj dvostupanjsku obradu ako tvoje sučelje prikazuje izvore u stvarnom vremenu.
Izgradnja sučelja s izvorima
Evo primjera pretvaranja citata u strukturirani 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
Citati iz kolekcija
Ako koristiš alat collections_search uz web_search, citati iz tvojih učitanih dokumenata koriste specifičan URI format: collections://collection_id/files/file_id. Razlikuj ih od standardnih web citata kako bi prilagodio renderiranje na front-endu.
Praktična vježba
Stvori aplikaciju koja prikazuje rezultate Grok pretraživanja sa sustavom fusnota. Svaka činjenica treba voditi natrag na svoj izvorni izvor. Testiraj s pitanjima o aktualnim događajima i ručno provjeri jesu li poveznice valjane i relevantne.
Ključne točke
- Globalni citati (popis URL-ova) vraćaju se zadano, bez konfiguracije
- Inline citati (poveznice u tekstu) omogućuju se putem parametra
include - Zadano ponašanje inline citata varira ovisno o SDK-u
- Svaka anotacija sadrži URL, indekse pozicije i broj citata
- Kod streamanja, kompletne anotacije dostupne su tek u konačnom odgovoru
- Citati iz kolekcija koriste poseban URI format (
collections://)