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

Comhráite Slabhraithe

Ceacht 5 as 16 Nuashonraithe 30 Iúil 2026 Forbróir
Ar an leathanach seo
  1. Comhráite gan Stair a Bhainistiú
  2. Sampla Python Iomlán
  3. Coibhéis curl
  4. Slabhhrú agus Treoracha
  5. Teorainneacha Slabhraithe
  6. Príomhphointí

Comhráite gan Stair a Bhainistiú

Is buntáiste mór den API Freagraí ná comhráite a shlabhrú trí previous_response_id. In ionad an stair iomlán a athsheoladh le gach iarratas, ní thugann tú ach ID na freagra roimhe sin. Déanann freastalaí xAI an comhthéacs iomlán a athchruthú go huathoibríoch.

1

An Chéad Iarratas

Seol do leid tosaigh. Faigh ID na freagra (resp-xxx).

2

Iarratais Ina Dhiaidh Sin

Cuir previous_response_id leis do theachtaireacht nua. Déanann an freastalaí an comhthéacs a athchruthú.

3

An Comhrá Iomlán

Slabhraigh oiread teachtaireachtaí agus is gá. Léiríonn gach freagra ar an gceann roimhe sin.

Sampla Python Iomlán

from openai import OpenAI

client = OpenAI(
    api_key="xai-...",
    base_url="https://api.x.ai/v1"
)

# Babhta 1: Réamhrá
response1 = client.responses.create(
    model="grok-4.20-0309-reasoning",
    instructions="Is múinteoir matamaitice foighneach agus soiléir tú.",
    input="Dia dhuit, ba mhaith liom díorthaigh a thuiscint."
)
print(response1.output[0].content[0].text)

# Babhta 2: Cuimhníonn an tsamhail ar an gcomhthéacs
response2 = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="An féidir leat sampla concreideach a thabhairt dom?",
    previous_response_id=response1.id
)
print(response2.output[0].content[0].text)

# Babhta 3: Doimhniú
response3 = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Agus conas a ríomhaim díorthach x² + 3x?",
    previous_response_id=response2.id
)
print(response3.output[0].content[0].text)

Tabhair faoi deara nach bhfuil sa gach iarratas tar éis an chéad cheann ach an teachtaireacht nua agus an tagairt don fhreagra roimhe sin. Déanann freastalaí xAI an stair iomlán a athchruthú go huathoibríoch.

Coibhéis curl

# Babhta 1
curl https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.20-0309-reasoning",
    "input": "Dia dhuit, mínigh bunús Python dom."
  }'
# Faigh an ID ón bhfreagra: "id": "resp-abc123"

# Babhta 2
curl https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.20-0309-reasoning",
    "input": "Conas a scríobhaim lúb for?",
    "previous_response_id": "resp-abc123"
  }'

Slabhhrú agus Treoracha

Fanann na instructions (leid córais) a shainítear sa chéad iarratas ar feadh an chomhrá shlabhraithe. Ní gá duit iad a athrá.

Má athraíonn tú instructions in iarratas slabhraithe, cuirfidh na treoracha nua in ionad na gcinn roimhe sin don iarratas sin agus do chinn ina dhiaidh sin.

Teorainneacha Slabhraithe

  • Ní mór don fhreagra thagartha a bheith ann ar an bhfreastalaí (ceachtar store: true nó iarratas le déanaí)
  • Carnann an slabhrú comharthaí staire – gearrtar táille ar an gcomhrá iomlán le gach iarratas
  • Níl aon teorainn le líon na mbabhtaí, ach baineann fuinneog comhthéacs na samhla i bhfeidhm

Príomhphointí

  • Slabhraíonn previous_response_id comhráite gan an stair a athsheoladh
  • Déanann an freastalaí an comhthéacs iomlán a athchruthú go huathoibríoch
  • Fanann treoracha córais ó bhabhta go babhta
  • Gearrtar táille ar an stair charntha iomlán le gach babhta
  • Ní mór don fhreagra thagartha a bheith stóráilte ar an bhfreastalaí