Automatsko citiranje i najbolje prakse
Na ovoj stranici
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
| Polje | Opis |
|---|---|
type | Uvijek url_citation |
url | URL izvora |
title | Naslov izvorne stranice |
start_index | Početna pozicija u tekstu |
end_index | Završ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.idradi sljedivostiusage.total_tokensradi potrošnjeusage.cost_in_nano_usdradi 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_searchilix_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.