Citatų naudojimas rezultatuose
Šiame puslapyje
Atsekami atsakymai su citatomis
Kai naudotojas tavo programėlės klausia faktinio klausimo, jis nori patikrinti gautą informaciją. Grok API citatos tiksliai atitinka šį poreikį: kiekvienas faktas, gautas per interneto paiešką, turi savo šaltinį. Tai leidžia kurti sąsajas, kuriose kiekvienas teiginys yra paspaudžiamas ir patikrinamas.

API siūlo du papildančius citavimo mechanizmus: bendrąsias citatas ir įterptines citatas. Supratęs, kaip jos veikia, galėsi kurti profesionalią ir skaidrią naudotojo patirtį.
Bendrosios citatos: pilnas šaltinių sąrašas
Bendrosios citatos pagal nutylėjimą grąžinamos atsakymo atribute citations. Jose pateikiamas visų URL adresų, kuriuos modelis konsultavo, sąrašas, net jei jie nėra tiesiogiai minimi atsakymo tekste.
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}")
Jokios papildomos konfigūracijos nereikia. Tai yra natūralus API elgesys.
Įterptinės citatos: nuorodos tekste
Įterptinės citatos į atsakymo tekstą įtraukia „Markdown“ nuorodas naudodamos formatą [[N]](url), kur N yra eilės numeris, pradedant nuo 1. Jei tas pats šaltinis cituojamas kelis kartus, naudojamas originalus numeris.
Numatytasis elgesys priklauso nuo naudojamo SDK:
- Tiesioginis „Responses“ API: įterptinės citatos įjungtos pagal nutylėjimą
- xAI SDK: įterptinės citatos išjungtos pagal nutylėjimą (reikia aktyvuoti)
Įterptinių citatų įjungimas naudojant 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"]
)
Įterptinių citatų išjungimas „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"]
)
Struktūruota anotacijų schema
Kiekviena įterptinė citata sugeneruoja anotacijos objektą su tiksliomis metaduomenimis. Ši struktūra leidžia atlikti pažangų programinį apdorojimą:
{
"type": "url_citation",
"url": "https://eur-lex.europa.eu/eli/reg/2024/1689",
"start_index": 145,
"end_index": 178,
"title": "1"
}
Laukai start_index ir end_index laikosi „Python“ pjaustymo (slice) konvencijos. Gali juos naudoti norėdamas išgauti tikslų cituojamą tekstą arba sukurti tinkintą HTML atvaizdavimą:
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}")
Srautinio perdavimo elgsena
Naudojant srautinį perdavimą, įterptinės citatos teksto fragmentuose atsiranda palaipsniui. Tačiau pilnos anotacijos prieinamos tik galutiniame atsakyme. Jei tavo sąsaja šaltinius rodo realiuoju laiku, suplanuok dviejų etapų apdorojimą.
Sąsajos su šaltiniais kūrimas
Štai pavyzdys, kaip paversti citatas struktūruotu HTML kodu:
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
Kolekcijų citatos
Jei kartu su web_search naudoji įrankį collections_search, citatos iš tavo įkeltų dokumentų naudoja specifinį URI formatą: collections://collection_id/files/file_id. Atskirk jas nuo standartinių interneto citatų, kad galėtum pritaikyti front-endo atvaizdavimą.
Praktinė užduotis
Sukurk programėlę, kuri rodo Grok paieškos rezultatus su išnašų sistema. Kiekvienas faktas turi turėti nuorodą atgal į originalų šaltinį. Išbandyk ją su klausimais apie dabartinius įvykius ir rankiniu būdu patikrink, ar nuorodos galioja ir yra aktualios.
Svarbiausi punktai
- Bendrosios citatos (URL sąrašas) grąžinamos pagal nutylėjimą, be konfigūracijos
- Įterptinės citatos (nuorodos tekste) įjungiamos per parametrą
include - Numatytasis įterptinių citatų elgesys skiriasi priklausomai nuo SDK
- Kiekvienoje anotacijoje yra URL, pozicijos indeksai ir citatos numeris
- Srautinio perdavimo metu pilnos anotacijos prieinamos tik galutiniame atsakyme
- Kolekcijų citatos naudoja atskirą URI formatą (
collections://)