Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Críochnuithe Comhrá vs API Freagraí: Comparáid

Ceacht 11 as 12 Nuashonraithe 30 Iúil 2026 Forbróir
Ar an leathanach seo
  1. Dhá chríochphointe, dhá fhealsúnacht
  2. Bainistiú stáit: an difríocht bhunúsach
  3. Uirlisí agus gnéithe eisiacha
  4. Cathain Críochnuithe Comhrá a úsáid?
  5. Cathain an API Freagraí a úsáid?
  6. Príomhphointí

Dhá chríochphointe, dhá fhealsúnacht

Tairgeann xAI dhá chríochphointe chun idirghníomhú le samhlacha Grok: Críochnuithe Comhrá (/v1/chat/completions) agus an API Freagraí (/v1/responses). Tá sé ríthábhachtach na difríochtaí eatarthu a thuiscint chun an críochphointe ceart a roghnú do do thionscadal agus chun aon aistriú féideartha a phleanáil.

Gné Críochnuithe Comhrá API Freagraí
Stádas Seanbhunaithe (Legacy) Príomhúil (molta)
Bainistiú stáit Gan stát (seol an stair) Le stát (previous_response_id)
Stóráil freastalaí Níl Tá (30 lá le store: true)
Comhrá Eagar teachtaireachtaí Slabhraithe de réir ID
Uirlisí freastalaí Glao feidhme amháin web_search, x_search, code_interpreter, functions
Réasúnaíocht chriptithe Níl Tá (encrypted_content)
Gnéithe nua Ní thugtar tosaíocht dóibh Tugtar tosaíocht dóibh
Comhoiriúnacht OpenAI Lán Páirteach

Bainistiú stáit: an difríocht bhunúsach

Críochnuithe Comhrá: is tusa a bhainistíonn an stair

Le gach iarratas, caithfidh tú an comhrá iomlán a athsheoladh:

# Críochnuithe Comhrá — athsheol gach rud gach uair
response = client.chat.completions.create(
    model="grok-4.20-0309-reasoning",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Hello, my name is Alice."},
        {"role": "assistant", "content": "Hello Alice! How can I help you?"},
        {"role": "user", "content": "What is my first name?"}
    ]
)

API Freagraí: bainistíonn an freastalaí an stair

Leis an API Freagraí, is leor aitheantóir simplí chun comhrá a leanúint:

# API Freagraí — ní ach ID an fhreagra roimhe seo
response1 = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Hello, my name is Alice."
)

response2 = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="What is my first name?",
    previous_response_id=response1.id
)

Coinníonn an freastalaí an comhthéacs agus athchruthaíonn sé an stair go huathoibríoch. Ní íocann tú níos lú tócan (bíonn an stair fós iníoctha), ach déanann tú do chód a shimpliú agus laghdaíonn tú méid do chuid iarratas.

Uirlisí agus gnéithe eisiacha

Tugann an API Freagraí rochtain ar uirlisí freastalaí nach dtairgeann Críochnuithe Comhrá:

  • web_search: cuardach gréasáin i bhfíor-am
  • x_search: cuardach laistigh de phoist X (Twitter)
  • code_interpreter: feidhmiú cód Python taobh freastalaí

Tá na huirlisí seo comhtháite go díreach san iarratas:

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="What is the latest news on AI?",
    tools=[{"type": "web_search"}]
)

Tacaíonn Críochnuithe Comhrá le glao feidhme (uirlisí sainithe ag an bhforbróir), ach ní thacaíonn sé leis na huirlisí freastalaí seo a bhainistíonn xAI.

Cathain Críochnuithe Comhrá a úsáid?

Is é Críochnuithe Comhrá fós an rogha cheart i roinnt cásanna:

  • Aistriú ó OpenAI: oibríonn do chód atá ann cheana gan mórán athraithe
  • Ilsholáthraí: ba mhaith leat aistriú idir OpenAI, Anthropic, agus xAI leis an gcód céanna
  • Creatláir tríú páirtí: Úsáideann LangChain, LlamaIndex, Haystack, agus an chuid is mó de na creatláir formáid Críochnuithe Comhrá
  • Rialú iomlán: ba mhaith leat an stair a bhainistiú leat féin (achoimriú, scagadh, modhnú)

Cathain an API Freagraí a úsáid?

Is fearr an API Freagraí do:

  • Tionscadail nua: bain tairbhe as na gnéithe is déanaí ón tús
  • Uirlisí freastalaí: teastaíonn cuardach gréasáin, feidhmiú cód, nó cuardach X uait
  • Comhráite fada: ní gá an stair a athsheoladh le gach iarratas
  • Réasúnaíocht chriptithe: rochtain ar ábhar réasúnaíochta le haghaidh leanúnachais idir iarratais

Príomhphointí

  • Tá Críochnuithe Comhrá gan stát (bainistíonn tusa an stair), tá an API Freagraí le stát (bainistíonn an freastalaí é)
  • Tairgeann an API Freagraí uirlisí freastalaí eisiacha: web_search, x_search, code_interpreter
  • Tá comhoiriúnacht iomlán OpenAI ag Críochnuithe Comhrá, tá an API Freagraí sonrach do xAI
  • Gearrann an dá chríochphointe táille ar stair an chomhrá iomláin
  • Úsáid Críochnuithe Comhrá le haghaidh comhoiriúnachta, agus an API Freagraí le haghaidh gnéithe nua