Comhráite Slabhraithe
Ar an leathanach seo
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.
An Chéad Iarratas
Seol do leid tosaigh. Faigh ID na freagra (resp-xxx).
Iarratais Ina Dhiaidh Sin
Cuir previous_response_id leis do theachtaireacht nua. Déanann an freastalaí an comhthéacs a athchruthú.
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: truenó 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_idcomhrá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í