Tsiteeringute kasutamine tulemustes
Sellel lehel
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.

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