Izmantot atsauces rezultātos
Šajā lapā
Izsekojamas atbildes ar atsaucēm
Kad lietotājs tavai lietotnei uzdod faktuālu jautājumu, viņš vēlas pārbaudīt sniegto informāciju. Grok API atsauces precīzi apmierina šo vajadzību: katrs fakts, kas iegūts, veicot tīmekļa meklēšanu, nāk kopā ar savu avotu. Tas ļauj tev izveidot saskarnes, kurā katrs apgalvojums ir noklikšķināms un pārbaudāms.

API piedāvā divus papildinošus citēšanas mehānismus: globālās atsauces un iekšteksta atsauces. Izprotot to darbību, tu vari radīt profesionālu un caurspīdīgu lietotāja pieredzi.
Globālās atsauces: Pilns avotu saraksts
Globālās atsauces tiek atgrieztas pēc noklusējuma atbildes atribūtā citations. Tās satur visu URL sarakstu, kurus modelis ir konsultējis, pat tos, uz kuriem atbildes tekstā nav tieši atsaukts.
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}")
Neviena papildu konfigurācija nav nepieciešama. Tā ir API dabiskā uzvedība.
Iekšteksta atsauces: Atsauces tekstā
Iekšteksta atsauces ievieto Markdown saites tieši atbildes tekstā, izmantojot formātu [[N]](url), kur N ir secīgs numurs, sākot no 1. Ja uz vienu un to pašu avotu tiek atsaukts vairākas reizes, tiek izmantots sākotnējais numurs.
Uzvedība pēc noklusējuma ir atkarīga no izmantotā SDK:
- Tiešais Responses API: iekšteksta atsauces ir iespējotas pēc noklusējuma
- xAI SDK: iekšteksta atsauces ir atspējotas pēc noklusējuma (jāaktivizē manuāli)
Iespējot iekšteksta atsauces, izmantojot 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"]
)
Atspējot iekšteksta atsauces Responses API
response = client.responses.create(
model="grok-4.5",
input="Current status of the European AI Act",
tools=[{"type": "web_search"}],
include=["no_inline_citations"]
)
Strukturētā anotāciju shēma
Katra iekšteksta atsauce ģenerē anotācijas objektu ar precīzu metadatu kopu. Šī struktūra ļauj veikt uzlabotu programmatisku apstrādi:
{
"type": "url_citation",
"url": "https://eur-lex.europa.eu/eli/reg/2024/1689",
"start_index": 145,
"end_index": 178,
"title": "1"
}
Lauki start_index un end_index atbilst Python šķēlējumu (slice) konvencijai. Tu vari tos izmantot, lai izgūtu precīzi citēto tekstu vai izveidotu pielāgotu HTML attēlojumu:
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}")
Plūsmas (Streaming) uzvedība
Izmantojot datu plūsmu (streaming), iekšteksta atsauces parādās pakāpeniski teksta fragmentos. Tomēr pilnīgas anotācijas ir pieejamas tikai galīgajā atbildē. Ja tava saskarne avotus attēlo reāllaikā, plāno divu posmu apstrādi.
Saskarnes izveide ar avotiem
Lūk, piemērs, kā pārveidot atsauces strukturētā HTML formātā:
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
Kolekciju atsauces
Ja blakus web_search izmanto rīku collections_search, atsauces uz tavām augšupielādētajām dokumentiem izmanto specifisku URI formātu: collections://collection_id/files/file_id. Nošķir tās no standarta tīmekļa atsaucēm, lai pielāgotu front-end attēlojumu.
Praktiskais uzdevums
Izveido lietotni, kas attēlo Grok meklēšanas rezultātus ar zemsvītras piezīmju sistēmu. Katram faktam ir jābūt saitei atpakaļ uz tā sākotnējo avotu. Testē to ar jautājumiem par aktuāliem notikumiem un manuāli pārbaudi, vai saites ir derīgas un atbilstošas.
Galvenās atziņas
- Globālās atsauces (URL saraksts) tiek atgrieztas pēc noklusējuma bez konfigurācijas
- Iekšteksta atsauces (saites tekstā) tiek iespējotas, izmantojot parametru
include - Noklusējuma uzvedība iekšteksta atsauču ziņā atšķiras atkarībā no SDK
- Katra anotācija satur URL, pozīcijas indeksus un atsauces numuru
- Datu plūsmas režīmā pilnīgas anotācijas ir pieejamas tikai galīgajā atbildē
- Kolekciju atsauces izmanto atšķirīgu URI formātu (
collections://)