Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Ċitazzjonijiet Awtomatiċi u L-Aħjar Prattiki

Lezzjoni 16 / 16 Aġġornat 30 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. Tweġibiet Ibbasati fuq Sorsi Affidabbli
  2. Kif Jaħdmu ċ-Ċitazzjonijiet
  3. Uri ċ-Ċitazzjonijiet fl-Applikazzjoni Tiegħek
  4. L-Aħjar Prattiki għall-Produzzjoni
  5. Lista ta’ Verifika għad-Dispiegament
  6. Punti Ewlenin
  7. Ittestja l-Għarfien Tiegħek

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

QasamDeskrizzjoni
typeDejjem url_citation
urlL-URL tas-sors
titleIt-titlu tal-paġna tas-sors
start_indexIl-pożizzjoni tal-bidu fit-test
end_indexIl-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.id għat-traċċabbiltà
  • usage.total_tokens għall-konsum
  • usage.cost_in_nano_usd għ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_search jew x_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.