Ċitazzjonijiet Awtomatiċi u L-Aħjar Prattiki
F'din il-paġna
Tweġibiet Ibbasati fuq Sorsi Affidabbli
Meta l-mudell juża t-tiftix fil-web jew it-tiftix fuq X, l-API tar-Risposti tinkludi awtomatikament ċitazzjonijiet fir-risposta. Dawn iċ-ċitazzjonijiet jippermettu lill-utenti tiegħek jivverifikaw is-sorsi u jibnu fid fit-tweġibiet iġġenerati.
Kif Jaħdmu ċ-Ċitazzjonijiet
Iċ-ċitazzjonijiet jidhru fl-array annotations ta’ kull oġġett ta’ kontenut:
{
"output": [{
"type": "message",
"content": [{
"type": "output_text",
"text": "Skont l-aħħar dejta, is-suq tal-AI...",
"annotations": [
{
"type": "url_citation",
"url": "https://example.com/article",
"title": "Analiżi tas-Suq tal-AI fl-2026",
"start_index": 35,
"end_index": 68
}
]
}]
}]
}
Oqsma taċ-Ċitazzjoni
| Qasam | Deskrizzjoni |
|---|---|
type | Dejjem url_citation |
url | L-URL tas-sors |
title | It-titlu tal-paġna tas-sors |
start_index | Il-pożizzjoni tal-bidu fit-test |
end_index | Il-pożizzjoni tat-tmiem fit-test |
Uri ċ-Ċitazzjonijiet fl-Applikazzjoni Tiegħek
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="X'inhu l-aħħar avvanz fl-AI?",
tools=[{"type": "web_search"}]
)
text = response.output[0].content[0].text
annotations = response.output[0].content[0].annotations
# Ibni t-test b'noti f'qiegħ il-paġna
footnotes = []
for i, ann in enumerate(annotations, 1):
footnotes.append(f"[{i}] {ann.title} — {ann.url}")
print(text)
print("\n--- Sorsi ---")
for fn in footnotes:
print(fn)
F’HTML
def render_with_citations(text, annotations):
# Issortja skont il-pożizzjoni (mit-tmiem għall-bidu biex tevita li tbiddel l-indiċi)
sorted_anns = sorted(annotations, key=lambda a: a.start_index, reverse=True)
html = text
for i, ann in enumerate(sorted_anns):
ref_num = len(sorted_anns) - i
link = f'<a href="{ann.url}" title="{ann.title}" target="_blank">[{ref_num}]</a>'
html = html[:ann.end_index] + link + html[ann.end_index:]
return html
L-Aħjar Prattiki għall-Produzzjoni
1. Dejjem Ivvvalida l-Istat
response = client.responses.create(...)
if response.status != "completed":
handle_error(response)
return
2. Immaniġġja Tweġibiet Vojt
if not response.output or not response.output[0].content:
return "Il-mudell ma ġġenerax tweġiba."
text = response.output[0].content[0].text
3. Irreġistra Metriċi
Għal kull talba fil-produzzjoni, irreġistra:
response.idgħat-traċċabbiltàusage.total_tokensgħall-konsumusage.cost_in_nano_usdgħall-ispejjeż- Il-ħin tar-risposta fuq in-naħa tal-klijent
- L-istat tar-risposta
4. Issikra ċ-Ċavetta tal-API Tiegħek
- Aħżinha f’varjabbli tal-ambjent, qatt mhux fil-kodiċi
- Uża maniġer tas-sigrieti fil-produzzjoni (Vault, AWS Secrets Manager)
- Ibdel iċ-ċwievet tiegħek regolarment
- Qatt tesponihom fuq in-naħa tal-klijent (browser)
5. Immaniġġja l-Kontenut Iġġenerat
It-tweġibiet tal-mudell jista’ jkun fihom kontenut mhux xieraq minkejja l-filtri. Implimenta saff ta’ moderazzjoni jekk qed turi tweġibiet pubblikament.
6. Ippjana għall-Iskalabbiltà
- Uża l-istreaming biex tnaqqas il-ħin ta’ stennija perċepit
- Implimenta sistema ta’ queue għat-talbiet tqal
- Ikkaxxja (cache) tweġibiet frekwenti
- Monitorja l-kwoti tal-limitazzjoni tar-rata (rate limiting) tiegħek
Lista ta’ Verifika għad-Dispiegament
- Timeout imsettjat għal 3600 sekonda
- Erġa’ pprova (retry) b’backoff esponenzjali
- Limitazzjoni tar-rata fuq in-naħa tal-klijent
- Irreġistra metriċi (tokens, spejjeż, latenza)
- Immaniġġja l-iżbalji (401, 429, 500, timeout)
- Iċċavetta tal-API sikura
- Moderazzjoni tal-kontenut jekk meħtieġ
- Monitoraġġ tal-ispejjeż u twissijiet
- Circuit breaker għar-reżiljenza
Punti Ewlenin
- Iċ-ċitazzjonijiet huma awtomatiċi meta l-mudell juża
web_searchjewx_search - Dawn fihom l-URL, it-titlu, u l-pożizzjoni fit-test
- Dejjem ivvalida l-istat u immaniġġja tweġibiet vojta
- Issikra ċ-ċavetta tal-API tiegħek—qatt fis-sors tal-kodiċi jew fuq in-naħa tal-klijent
- Implimenta r-reġistrazzjoni, ir-riprova, il-limitazzjoni tar-rata, u l-monitoraġġ qabel ma tmur fil-produzzjoni
Ittestja l-Għarfien Tiegħek
L-API tar-Risposti fil-fond: iċ-ċekking finali.
1. X'toffri l-API tar-Risposti meta mqabbla mal-Chat Completions?
Tweġiba: Il-format modern: persistenza tar-risposta fuq is-server (GET/DELETE, katina bl-ID), għodod integrati, u karatteristiċi riċenti—l-API fejn xAI tiffoka l-evoluzzjoni.
2. Kif tgħaqqad konversazzjoni?
Tweġiba: Billi tirreferenzja r-risposta preċedenti: il-kuntest jinżamm fuq is-server—l-ebda ħtieġa li terġa’ tibgħat l-istorja sħiħa f’kull dawra.
3. X'inhu r-raġunar ikkrittjat?
Tweġiba: Ir-raġunar intern tal-mudell irritornat f’forma kkrittjata: użabbli f’dawri sussegwenti mingħajr ma jkun jista’ jinqara—il-proċess tal-ħsieb jivvjaġġa, il-kunfidenzjalità tibqa’.
4. X'jippermetti t-taħlit ta' għodod tas-server u tal-klijent?
Tweġiba: Tgħaqqad għodod integrati eżegwiti minn xAI (tiftix fil-web, eċċ.) u l-funzjonijiet personalizzati tiegħek eżegwiti mill-kodiċi tiegħek—kull għodda fil-post it-tajjeb, orkestrata fl-istess talba.
5. X'inhuma l-aħjar prattiki għall-produzzjoni?
Tweġiba: Immaniġġja t-timeout u r-riprova, traċċa l-fatturar (tokens, għodod), u sfrutta ċ-ċitazzjonijiet awtomatiċi għal tweġibiet verifikabbli—robustezza u fid flimkien.
Persistenza, għodod, raġunar ikkrittjat, ċitazzjonijiet: l-API tar-Risposti hija l-fondazzjoni moderna—l-applikazzjonijiet Grok tiegħek huma mibnija hawn.