L-I sfruttar taċ-Ċitazzjonijiet fir-Riżultati
F'din il-paġna
- Tweġibiet Traċċabbli b’Ċitazzjonijiet
- Ċitazzjonijiet Globali: Il-Lista Sħiħa tas-Sorsi
- Ċitazzjonijiet Inline: Referenzi fit-Test
- L-Iskema ta’ Annotazzjoni Strutturata
- Imġiba waqt l-Istreamjar (Streaming)
- Bini ta’ Interfaċċa bis-Sorsi
- Ġbir ta’ Ċitazzjonijiet (Collection Citations)
- Prattika Pratika
- Punti Ewlenin
Tweġibiet Traċċabbli b’Ċitazzjonijiet
Meta utent jistaqsi lill-applikazzjoni tiegħek mistoqsija fattwali, irid jivverifika l-informazzjoni. Iċ-ċitazzjonijiet tal-API ta’ Grok jissodisfaw eżattament din il-ħtieġa: kull fatt miksub permezz tat-tiftix fil-web jiġi bis-sors tiegħu. Dan jippermettilek tibni interfaċċi fejn kull affermazzjoni tkun tista’ tiġi kklikkjata u vverifikata.

L-API toffri żewġ mekkaniżmi ta’ ċitazzjoni kumplimentari: ċitazzjonijiet globali u ċitazzjonijiet inline. Li tifhem kif jaħdmu jippermettilek toħloq esperjenzi tal-utent professjonali u trasparenti.
Ċitazzjonijiet Globali: Il-Lista Sħiħa tas-Sorsi
Iċ-ċitazzjonijiet globali jiġu rritornati b’mod awtomatiku fl-attribut citations tar-rispons. Dawn fihom lista tal-URLs kollha kkonsultati mill-mudell, anke dawk mhux imsemmija direttament fit-test tar-rispons.
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}")
M’hemm bżonn l-ebda konfigurazzjoni addizzjonali. Dan huwa l-imġiba nattiva tal-API.
Ċitazzjonijiet Inline: Referenzi fit-Test
Iċ-ċitazzjonijiet inline jdaħħlu links Markdown direttament fit-test tar-rispons, bl-użu tal-format [[N]](url) fejn N huwa numru sekwenzjali li jibda minn 1. Jekk l-istess sors jiġi ċċitat diversi drabi, in-numru oriġinali jerġa’ jintuża.
L-imġiba default tiddependi mill-SDK użat:
- Direct Responses API: ċitazzjonijiet inline attivati b’mod awtomatiku
- xAI SDK: ċitazzjonijiet inline diżattivati b’mod awtomatiku (opt-in)
Attiva ċ-Ċitazzjonijiet Inline bl-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"]
)
Diżattiva ċ-Ċitazzjonijiet Inline fuq ir-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"]
)
L-Iskema ta’ Annotazzjoni Strutturata
Kull ċitazzjoni inline tiġġenera oġġett ta’ annotazzjoni b’metadata preċiża. Din l-istruttura tippermetti pproċessar avvanzat programmatiku:
{
"type": "url_citation",
"url": "https://eur-lex.europa.eu/eli/reg/2024/1689",
"start_index": 145,
"end_index": 178,
"title": "1"
}
Il-kampi start_index u end_index isegwu l-konvenzjoni tas-slicing ta’ Python. Tista’ tużahom biex testraċċa eżattament it-test iċċitat jew toħloq rendering HTML personalizzat:
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}")
Imġiba waqt l-Istreamjar (Streaming)
Meta tuża l-istreamjar, iċ-ċitazzjonijiet inline jidhru progressivament fil-biċċiet (chunks) tat-test. Madankollu, l-annotazzjonijiet sħaħ huma disponibbli biss fir-rispons finali. Ippjana għal ipproċessar f’żewġ fażijiet jekk l-interfaċċa tiegħek turi s-sorsi f’ħin reali.
Bini ta’ Interfaċċa bis-Sorsi
Hawnhekk eżempju ta’ kif tikkonverti ċ-ċitazzjonijiet f’HTML strutturat:
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
Ġbir ta’ Ċitazzjonijiet (Collection Citations)
Jekk tuża l-għodda collections_search flimkien ma’ web_search, iċ-ċitazzjonijiet mid-dokumenti mħallgħa tiegħek jużaw format URI speċifiku: collections://collection_id/files/file_id. Agħmel distinzjoni bejn dawn u ċ-ċitazzjonijiet standard tal-web biex tadatta r-rendering tal-front-end.
Prattika Pratika
Oħloq applikazzjoni li turi r-riżultati tat-tiftix ta’ Grok b’sistema ta’ noti f’qiegħ il-paġna. Kull fatt għandu jkollu link lura għas-sors oriġinali tiegħu. Ittestja b’mistoqsijiet dwar l-aħbarijiet attwali u vverifika manwalment li l-links huma validi u rilevanti.
Punti Ewlenin
- Iċ-ċitazzjonijiet globali (lista ta’ URLs) jiġu rritornati b’mod awtomatiku, mingħajr konfigurazzjoni
- Iċ-ċitazzjonijiet inline (links fit-test) jiġu attivati permezz tal-parametru
include - L-imġiba default taċ-ċitazzjonijiet inline tvarja skont l-SDK
- Kull annotazzjoni fiha l-URL, l-indiċijiet tal-pożizzjoni, u n-numru taċ-ċitazzjoni
- Fl-istreamjar, l-annotazzjonijiet sħaħ huma disponibbli biss fir-rispons finali
- Iċ-ċitazzjonijiet tal-kollezzjonijiet jużaw format URI distint (
collections://)