Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Iskorištavanje citata u rezultatima

Lekcija 3 od 14 Ažurirano 30. srpnja 2026. Početnik
Na ovoj stranici
  1. Odgovori s mogućnošću praćenja putem citata
  2. Globalni citati: Potpuni popis izvora
  3. Inline citati: Reference u tekstu
  4. Shema strukturirane anotacije
  5. Ponašanje kod streamanja
  6. Izgradnja sučelja s izvorima
  7. Citati iz kolekcija
  8. Praktična vježba
  9. Ključne točke

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.

Citati i izvori u odgovorima Groka

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://)