Izkoriščanje navajanj v rezultatih
Na tej strani
Sledljivi odgovori z navajanji
Ko uporabnik tvoji aplikaciji zastavi dejansko vprašanje, želi preveriti informacije. Navajanja API-ja Grok to potrebo natančno zadovoljijo: vsako dejstvo, pridobljeno prek spletnega iskanja, ima svoj vir. To ti omogoča gradnjo vmesnikov, kjer je vsaka trditev klikabilna in preverljiva.

API ponuja dva dopolnjujoča mehanizma za navajanje: globalna navajanja in vstavljena navajanja. Razumevanje njihovega delovanja ti omogoča ustvarjanje profesionalnih in preglednih uporabniških izkušenj.
Globalna navajanja: Celoten seznam virov
Globalna navajanja so privzeto vrnjena v atributu citations odgovora. Vsebujejo seznam vseh URL-jev, ki jih je model uporabil, tudi tistih, na katere se besedilo odgovora ne sklicuje neposredno.
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}")
Dodatna konfiguracija ni potrebna. To je osnovno vedenje API-ja.
Vstavljena navajanja: Sklici v besedilu
Vstavljena navajanja vstavijo povezave Markdown neposredno v besedilo odgovora z uporabo zapisa [[N]](url), kjer je N zaporedna številka, ki se začne z 1. Če se na isti vir sklicujemo večkrat, se ponovno uporabi prvotna številka.
Privzeto vedenje je odvisno od uporabljenega SDK:
- Neposredni API za odgovore: vstavljena navajanja so privzeto omogočena
- xAI SDK: vstavljena navajanja so privzeto onemogočena (po izbiri)
Omogoči vstavljena navajanja z 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"]
)
Onemogoči vstavljena navajanja v API-ju za odgovore
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
Vsako vstavljeno navajanje ustvari predmet anotacije s preciznimi metapodatki. Ta struktura omogoča napredno programsko obdelavo:
{
"type": "url_citation",
"url": "https://eur-lex.europa.eu/eli/reg/2024/1689",
"start_index": 145,
"end_index": 178,
"title": "1"
}
Polji start_index in end_index sledita konvenciji rezanja v Pythonu. Uporabiš ju lahko za ekstrakcijo točno citiranega besedila ali ustvarjanje prilagojenega upodabljanja 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}")
Vedenje pri pretakanju
Pri uporabi pretakanja se vstavljena navajanja postopoma pojavljajo v delčkih besedila. Vendar so popolne anotacije na voljo šele v končnem odgovoru. Načrtuj dvostopenjsko obdelavo, če tvoj vmesnik vire prikazuje v realnem času.
Gradnja vmesnika z viri
Tukaj je primer pretvorbe navajanj v 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
Navajanja zbirk
Če orodje collections_search uporabljaš skupaj z web_search, navajanja iz tvojih naloženih dokumentov uporabljajo določeno obliko URI: collections://collection_id/files/file_id. Razlikuj jih od standardnih spletnih navajanj, da prilagodiš upodabljanje v ospredju.
Praktična vaja
Ustvari aplikacijo, ki prikazuje rezultate iskanja Grok s sistemom opomb. Vsako dejstvo naj bo povezano nazaj na svoj izvirni vir. Preizkusi z vprašanji o trenutnih dogodkih in ročno preveri, ali so povezave veljavne in ustrezne.
Ključne ugotovitve
- Globalna navajanja (seznam URL-jev) so vrnjena privzeto, brez konfiguracije
- Vstavljena navajanja (povezave v besedilu) so omogočena prek parametra
include - Privzeto vedenje vstavljenih navajanj se razlikuje glede na SDK
- Vsaka anotacija vsebuje URL, indeksa položaja in številko navajanja
- Pri pretakanju so popolne anotacije na voljo šele v končnem odgovoru
- Navajanja zbirk uporabljajo drugačno obliko URI (
collections://)