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

L-Istat Legacy u l-Prinċipju Mingħajr Stat

Lezzjoni 1 / 12 Aġġornat 3 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. L-Endpoint tal-Chat Completions fl-Ekosistema ta’ xAI
  2. Endpoint Mingħajr Stat: Ibgħat Kollox ma’ Kull Talba
  3. Punti Ewlenin

Aġġornat fit-3 ta’ Novembru, 2026 abbażi tal-aħjar prattiki ta’ xAI: xAI issa tikklassifika l-Chat Completions bħala deprekat u tirrakkomanda l-API tar-Risposti għall-mudelli tar-raġunament ta’ Grok. Ir-raġuni konkreta: il-Chat Completions ma fihx qasam għar-raġunament ikkrittografat tal-mudell, għalhekk kull konversazzjoni b’diversi dawriet jew sejħa ta’ għodda titlef ir-raġunament mid-dawriet preċedenti. Karatteristiċi ġodda jaslu wkoll l-ewwel fuq l-API tar-Risposti. Sorsi: xAI Best Practices · Chat Completions (legacy).

L-Endpoint tal-Chat Completions fl-Ekosistema ta’ xAI

L-API ta’ xAI toffri żewġ endpoints ewlenin biex tinteraġixxi mal-mudelli ta’ Grok: l-API tar-Risposti (l-endpoint primarju) u l-endpoint tal-Chat Completions. Dan tal-aħħar huwa mmarkat bħala legacy: jibqa’ funzjonali għalkollox, iżda l-karatteristiċi ġodda issa huma prijorità għall-API tar-Risposti.

Għaliex għandek tħares lejh allura? Għax il-Chat Completions jibqa’ l-aktar endpoint adottat b’mod wiesa’ fl-ekosistema. L-SDKs kollha eżistenti ta’ OpenAI, frameworks bħal LangChain jew LlamaIndex, u eluf ta’ tutorials jużaw dan il-format. Jekk qed temigra minn fornitur ieħor jew taħdem ma’ għodod ta’ partijiet terzi, x’aktarx li dan huwa l-endpoint li se tuża l-ewwel.

Legacy
Status uffiċjali
Mingħajr stat
L-ebda stat fuq is-server
OpenAI
Format kompatibbli
3600s
Timeout rakkomandat

Endpoint Mingħajr Stat: Ibgħat Kollox ma’ Kull Talba

Il-prinċipju fundamentali tal-Chat Completions huwa li huwa mingħajr stat: is-server ma jżomm l-ebda storja tal-konversazzjoni. Ma’ kull sejħa, trid tinkludi l-istorja sħiħa tal-messaġġi preċedenti fit-talba tiegħek.

Speċifikament, dan ifisser li għal konversazzjoni b’10 skambji, it-11-il talba tiegħek trid fiha l-10 messaġġi preċedenti (utent + assistent) flimkien mal-messaġġ il-ġdid. L-applikazzjoni tiegħek timmaniġġja din l-istorja.

{
  "model": "grok-4.20-0309-reasoning",
  "messages": [
    {"role": "system", "content": "You are a helpful assistant."},
    {"role": "user", "content": "Hello!"},
    {"role": "assistant", "content": "Hello! How can I help you?"},
    {"role": "user", "content": "Explain deep learning to me."}
  ]
}

F’dan l-eżempju, l-ewwel tliet messaġġi jirrappreżentaw l-istorja tal-konversazzjoni. Biss l-aħħar wieħed huwa l-messaġġ il-ġdid tal-utent. Il-mudell jeħtieġ dan il-kuntest kollu biex jipproduċi tweġiba koerenti.

Implikazzjonijiet Prattiċi

Dan l-approċċ mingħajr stat għandu diversi implikazzjonijiet:

  • Kontroll sħiħ: inti tiddeċiedi eżattament liema messaġġi jintbagħtu lill-mudell. Tista’ tiffiltra, tagħmel sommarju, jew timmodifika l-istorja qabel kull sejħa.
  • Ispejjeż proporzjonali: kull talba tiġi fatturata għat-tokens kollha mibgħuta, inkluża l-istorja. Itwal tkun il-konversazzjoni, aktar jiswef kull skambju.
  • L-ebda persistenza fuq is-server: l-ebda data ma tinħażen fuq in-naħa ta’ xAI bejn it-talbiet. Dan huwa vantaġġ għall-privatezza, iżda jeħtieġ li timmaniġġja l-persistenza int stess.

Tqabbil mal-API tar-Risposti

L-API tar-Risposti, min-naħa l-oħra, hija b’stat: iżżomm l-istorja fuq is-server permezz ta’ previous_response_id. M’għandekx bżonn terġa’ tibgħat il-messaġġi preċedenti—biżżejjed identifikatur sempliċi. Ir-risposti jistgħu jinħażnu sa 30 jum b’store: true.

L-għażla bejn iż-żewġ tiddependi mill-każ ta’ użu tiegħek. Jekk qed taħdem ma’ SDK eżistenti ta’ OpenAI jew qed temigra minn fornitur ieħor, il-Chat Completions huwa l-punt tat-tluq loġiku. Għal proġett ġdid, l-API tar-Risposti hija rrakkomandata.

Punti Ewlenin

  • Il-Chat Completions huwa mmarkat bħala legacy iżda jibqa’ funzjonali għalkollox u kompatibbli mal-ekosistema ta’ OpenAI
  • L-endpoint huwa mingħajr stat: trid terġa’ tibgħat l-istorja sħiħa ma’ kull talba
  • L-ispiża ta’ kull talba tinkludi t-tokens kollha tal-istorja
  • L-API tar-Risposti toffri alternattiva b’stat b’persistenza fuq is-server
  • Għall-mudelli tar-raġunament, huwa rrakkomandat timeout ta’ 3600 sekonda