Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Izmantot atsauces rezultātos

Nodarbība 3 no 14 Atjaunota 2026. gada 30. jūlijs Iesācējs
Šajā lapā
  1. Izsekojamas atbildes ar atsaucēm
  2. Globālās atsauces: Pilns avotu saraksts
  3. Iekšteksta atsauces: Atsauces tekstā
  4. Strukturētā anotāciju shēma
  5. Plūsmas (Streaming) uzvedība
  6. Saskarnes izveide ar avotiem
  7. Kolekciju atsauces
  8. Praktiskais uzdevums
  9. Galvenās atziņas

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.

Atsauces un avoti Grok atbildēs

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