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

Automatsko citiranje i najbolje prakse

Lekcija 16 od 16 Ažurirano 30. srpnja 2026. Programer
Na ovoj stranici
  1. Izvorni i pouzdani odgovori
  2. Kako funkcioniraju citati
  3. Prikaz citata u tvojoj aplikaciji
  4. Najbolje prakse za produkciju
  5. Kontrolni popis za implementaciju
  6. Ključne točke
  7. Provjeri svoje znanje

Izvorni i pouzdani odgovori

Kada model koristi web pretraživanje ili pretraživanje platforme X, Responses API automatski uključuje citata u odgovor. Ta ti citata omogućuju da tvoji korisnici verificiraju izvore i izgrade povjerenje u generirane odgovore.

Kako funkcioniraju citati

Citati se pojavljuju u polju annotations svakog elementa sadržaja:

{
  "output": [{
    "type": "message",
    "content": [{
      "type": "output_text",
      "text": "According to the latest data, the AI market...",
      "annotations": [
        {
          "type": "url_citation",
          "url": "https://example.com/article",
          "title": "AI Market Analysis in 2026",
          "start_index": 35,
          "end_index": 68
        }
      ]
    }]
  }]
}

Polja citata

PoljeOpis
typeUvijek url_citation
urlURL izvora
titleNaslov izvorne stranice
start_indexPočetna pozicija u tekstu
end_indexZavršna pozicija u tekstu

Prikaz citata u tvojoj aplikaciji

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="What are the latest advancements in AI?",
    tools=[{"type": "web_search"}]
)

text = response.output[0].content[0].text
annotations = response.output[0].content[0].annotations

# Izgradnja teksta s fusnotama
footnotes = []
for i, ann in enumerate(annotations, 1):
    footnotes.append(f"[{i}] {ann.title} — {ann.url}")

print(text)
print("\n--- Sources ---")
for fn in footnotes:
    print(fn)

U HTML-u

def render_with_citations(text, annotations):
    # Sortiranje po poziciji (od kraja prema početku kako bi se izbjeglo pomicanje indeksa)
    sorted_anns = sorted(annotations, key=lambda a: a.start_index, reverse=True)
    html = text
    for i, ann in enumerate(sorted_anns):
        ref_num = len(sorted_anns) - i
        link = f'<a href="{ann.url}" title="{ann.title}" target="_blank">[{ref_num}]</a>'
        html = html[:ann.end_index] + link + html[ann.end_index:]
    return html

Najbolje prakse za produkciju

1. Uvijek validiraj status

response = client.responses.create(...)
if response.status != "completed":
    handle_error(response)
    return

2. Rukuj praznim odgovorima

if not response.output or not response.output[0].content:
    return "The model did not generate a response."
text = response.output[0].content[0].text

3. Bilježi metrike

Za svaki zahtjev u produkciji zabilježi:

  • response.id radi sljedivosti
  • usage.total_tokens radi potrošnje
  • usage.cost_in_nano_usd radi troškova
  • Vrijeme odgovora na strani klijenta
  • Status odgovora

4. Osiguraj svoj API ključ

  • Pohrani ga u varijablu okruženja, nikada izravno u kod
  • U produkciji koristi upravitelja tajnama (Vault, AWS Secrets Manager)
  • Redovito rotiraj svoje ključeve
  • Nikada ih ne izlaži na strani klijenta (preglednik)

5. Upravljaj generiranim sadržajem

Odgovori modela mogu sadržavati neprimjeren sadržaj unatoč filterima. Implementiraj sloj moderacije ako odgovore prikazuješ javno.

6. Planiraj skalabilnost

  • Koristi streaming za smanjenje percipiranog vremena čekanja
  • Implementiraj sustav redova za zahtjevne zadatke
  • Predmemoriraj česte odgovore
  • Prati svoje kvote ograničenja stope (rate limiting)

Kontrolni popis za implementaciju

  • Timeout postavljen na 3600 sekundi
  • Ponovni pokušaji s eksponencijalnim kašnjenjem (exponential backoff)
  • Ograničenje stope na strani klijenta
  • Bilježenje metrika (tokeni, troškovi, latencija)
  • Rukovanje greškama (401, 429, 500, timeout)
  • Siguran API ključ
  • Moderacija sadržaja ako je potrebno
  • Nadzor troškova i alerti
  • Circuit breaker za otpornost

Ključne točke

  • Citati su automatski kada model koristi web_search ili x_search
  • Sadrže URL, naslov i poziciju u tekstu
  • Uvijek validiraj status i rukuj praznim odgovorima
  • Osiguraj svoj API ključ – nikada u izvornom kodu ili na strani klijenta
  • Implementiraj bilježenje, ponovne pokušaje, ograničenje stope i nadzor prije prelaska u produkciju

Provjeri svoje znanje

Responses API u dubinu: završna provjera.

1. Što nudi Responses API u usporedbi s Chat Completions?

Odgovor: Moderni format: trajnost odgovora na strani poslužitelja (GET/DELETE, lančanje po ID-u), ugrađeni alati i najnovije značajke – API na koji se xAI fokusira u svom razvoju.

2. Kako lančati razgovor?

Odgovor: Referenciranjem prethodnog odgovora: kontekst se čuva na strani poslužitelja – nema potrebe za ponovnim slanjem cijele povijesti u svakom koraku.

3. Što je šifrirano rezoniranje?

Odgovor: Interno rezoniranje modela vraćeno u šifriranom obliku: ponovno upotrebljivo u sljedećim koracima bez da bude čitljivo – proces razmišljanja putuje, povjerljivost ostaje očuvana.

4. Što omogućuje miješanje alata na poslužitelju i klijentu?

Odgovor: Kombinaciju ugrađenih alata koje izvršava xAI (web pretraživanje itd.) i tvojih prilagođenih funkcija koje izvršava tvoj kod – svaki alat na pravom mjestu, orkestriran u istom zahtjevu.

5. Koje su najbolje prakse za produkciju?

Odgovor: Rukuj timeoutom i ponovnim pokušajima, prati naplatu (tokeni, alati) i iskoristi automatske citate za provjerljive odgovore – robustnost i povjerenje zajedno.

Trajnost, alati, šifrirano rezoniranje, citati: Responses API je moderna temeljna platforma – tvoje Grok aplikacije grade se ovdje.