Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Tsiteeringute kasutamine tulemustes

Õppetund 3 / 14 Värskendatud 30. juuli 2026 Algajatele
Sellel lehel
  1. Jälgitavad vastused tsiteeringutega
  2. Globaalsed tsiteeringud: täielik allikate loend
  3. Reasiseseid tsiteeringuid: viited tekstis
  4. Struktureeritud annotatsiooni skeem
  5. Voogedastuse käitumine
  6. Allikatega kasutajaliidese loomine
  7. Kogumite tsiteeringud
  8. Praktiline harjutus
  9. Peamised punktid

Jälgitavad vastused tsiteeringutega

Kui kasutaja esitab sinu rakendusele faktilise küsimuse, soovib ta saadud teavet kontrollida. Grok API tsiteeringud rahuldavad seda vajadust täpselt: iga veebiotsingu kaudu leitud fakt on varustatud allikaga. See võimaldab sul luua kasutajaliideseid, kus iga väide on klõpsatav ja kontrollitav.

Tsiteeringud ja allikad Groki vastustes

API pakub kahte täiendavat tsiteerimismehhanismi: globaalsed tsiteeringud ja reasiseseid tsiteeringuid. Nende toimimise mõistmine võimaldab sul luua professionaalse ja läbipaistva kasutajakogemuse.

Globaalsed tsiteeringud: täielik allikate loend

Globaalsed tsiteeringud tagastatakse vaikimisi vastuse atribuudis citations. Need sisaldavad loendit kõigist URL-dest, mida mudel konsulteeris, isegi kui neid ei ole vastuse tekstis otseselt viidatud.

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}")

Lisaseadistusi pole vaja. See on API loomupärane käitumine.

Reasiseseid tsiteeringuid: viited tekstis

Reasiseseid tsiteeringuid lisatakse vastuse teksti otse Markdowni linkidena, kasutades formaati [[N]](url), kus N on järjestikune number alates 1-st. Kui sama allikat tsiteeritakse mitu korda, kasutatakse algset numbrit uuesti.

Vaikimisi käitumine sõltub kasutatavast SDK-st:

  • Otsene Responses API: reasiseseid tsiteeringuid on vaikimisi lubatud
  • xAI SDK: reasiseseid tsiteeringuid on vaikimisi keelatud (tuleb eraldi lubada)

Reasiseste tsiteeringute lubamine xAI SDK-ga

response = client.responses.create(
    model="grok-4.5",
    input="Current status of the European AI Act",
    tools=[{"type": "web_search"}],
    include=["inline_citations"]
)

Reasiseste tsiteeringute keelamine Responses API-s

response = client.responses.create(
    model="grok-4.5",
    input="Current status of the European AI Act",
    tools=[{"type": "web_search"}],
    include=["no_inline_citations"]
)

Struktureeritud annotatsiooni skeem

Iga reasisene tsiteering genereerib annotatsiooniobjekti täpse metaandmetega. See struktuur võimaldab täiustatud programmeeritavat töötlemist:

{
  "type": "url_citation",
  "url": "https://eur-lex.europa.eu/eli/reg/2024/1689",
  "start_index": 145,
  "end_index": 178,
  "title": "1"
}

Väljad start_index ja end_index järgivad Pythoni viilastamise konventsiooni. Saad neid kasutada täpse tsiteeritud teksti eraldamiseks või kohandatud HTML-esituse loomiseks:

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}")

Voogedastuse käitumine

Voogedastuse kasutamisel ilmuvad reasiseseid tsiteeringuid tekstiosades järk-järgult. Täielikud annotatsioonid on siiski kättesaadavad ainult lõplikus vastuses. Planeeri kaheastmeline töötlemine, kui sinu liides kuvab allikaid reaalajas.

Allikatega kasutajaliidese loomine

Siin on näide tsiteeringute teisendamisest struktureeritud HTML-iks:

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

Kogumite tsiteeringud

Kui kasutad tööriista collections_search koos web_search-iga, kasutavad sinu üleslaaditud dokumentidest pärit tsiteeringud spetsiifilist URI formaati: collections://collection_id/files/file_id. Erista neid tavalistest veebitsiteeringutest, et kohandada front-end’i esitust.

Praktiline harjutus

Loo rakendus, mis kuvab Groki otsingutulemused koos jalusviidete süsteemiga. Iga fakt peaks linkima tagasi oma algallikale. Testi seda aktuaalseid sündmusi puudutavate küsimustega ja kontrolli käsitsi, et lingid on kehtivad ja asjakohased.

Peamised punktid

  • Globaalsed tsiteeringud (URL-ide loend) tagastatakse vaikimisi ilma seadistusteta
  • Reasiseseid tsiteeringuid (lingid tekstis) lubatakse parameetri include kaudu
  • Reasiseste tsiteeringute vaikimisi käitumine varieerub sõltuvalt SDK-st
  • Iga annotatsioon sisaldab URL-i, positsiooni indekseid ja tsiteeringu numbrit
  • Voogedastuse korral on täielikud annotatsioonid kättesaadavad ainult lõplikus vastuses
  • Kogumite tsiteeringud kasutavad eristuvat URI formaati (collections://)