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

GET agus DELETE: Bainistiú Freagraí

Ceacht 7 as 16 Nuashonraithe 30 Iúil 2026 Forbróir
Ar an leathanach seo
  1. Thar Cruthú Amháin
  2. GET /v1/responses/{id}
  3. DELETE /v1/responses/{id}
  4. Dea-Chleachtais
  5. Príomhphointí

Thar Cruthú Amháin

Níl an API Freagraí teoranta do chruthú freagraí amháin. Tá dhá phointe deiridh chomhlántacha ann a ligeann duit freagraí stóráilte a fháil agus a scriosadh. Tá na hoibríochtaí seo riachtanach chun feidhmchláir láidre a thógáil le bainistiú staire.

GET /v1/responses/{id}

Freagra a Fháil

curl https://api.x.ai/v1/responses/resp-abc123def456 \
  -H "Authorization: Bearer $XAI_API_KEY"

Tugann an API ar ais an réad JSON céanna go díreach agus a fuarthas le linn an chruthaithe:

{
  "id": "resp-abc123def456",
  "object": "response",
  "created_at": 1712000000,
  "status": "completed",
  "model": "grok-4.20-0309-reasoning",
  "output": [...],
  "usage": {...}
}

Cásanna Úsáide Prácteacha

Atosú Comhrá: Stórálann d’fheidhmchlár an response_id deireanach i seisiún an úsáideora. Nuair a athcheanglaíonn tú, faigh an freagra chun an comhthéacs roimhe seo a thaispeáint.

# Filleann an t-úsáideoir tar éis briseadh
last_response_id = get_from_session(user_id)
previous = client.responses.retrieve(last_response_id)

# Taispeáin an malartú deireanach
print(f"Last response: {previous.output[0].content[0].text[:200]}...")

# Lean ar aghaidh leis an gcomhrá
new_response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Where were we?",
    previous_response_id=last_response_id
)

Iniúchadh Costais: Déan iteráid ar do chuid freagraí stóráilte chun tomhaltas a anailísiú de réir úsáideora nó gné.

response = client.responses.retrieve("resp-abc123")
cost_usd = response.usage.cost_in_nano_usd / 1e9
input_tokens = response.usage.input_tokens
output_tokens = response.usage.output_tokens
print(f"Cost: ${cost_usd:.6f} | In: {input_tokens} | Out: {output_tokens}")

Láimhseáil Earráidí

Mura bhfuil an freagra ann (scriosta nó imithe in éag), filleann an API earráid 404:

{
  "error": {
    "message": "Response not found",
    "type": "not_found_error"
  }
}

Láimhseáil an cás seo i do chód:

try:
    response = client.responses.retrieve("resp-expired123")
except Exception as e:
    print(f"Response not found: {e}")
    # Tosaigh comhrá nua

DELETE /v1/responses/{id}

Freagra a Scriosadh

curl -X DELETE https://api.x.ai/v1/responses/resp-abc123def456 \
  -H "Authorization: Bearer $XAI_API_KEY"

Filleann an scriosadh stádas 200 ar éirí leis. Tá an oibríocht do-aisiompaithe.

Tionchar ar Chomhráite Slabhraithe

Nuair a scriosann tú freagra a bhfuil tagairt déanta air ag cinn eile trí previous_response_id, imíonn comhthéacs an fhreagra sin ón slabhra. Ní scriostar freagraí ina dhiaidh sin, ach cailleann siad rochtain ar an gcomhthéacs roimhe seo.

resp-1 → resp-2 → resp-3 → resp-4
         ↑ deleted

Má scriosann tú resp-2, fanann resp-3 agus resp-4 ann, ach níl an comhthéacs ó resp-1 agus resp-2 inrochtana a thuilleadh d’iarratais slabhraithe nua.

Glantachán Uathoibrithe

Chun feidhmchláir táirgeachta, cuir glantachán tréimhsiúil i bhfeidhm:

import datetime

def cleanup_old_responses(response_ids, max_age_days=7):
    for rid in response_ids:
        try:
            resp = client.responses.retrieve(rid)
            age = datetime.datetime.now().timestamp() - resp.created_at
            if age > max_age_days * 86400:
                client.responses.delete(rid)
                print(f"Deleted: {rid}")
        except Exception:
            pass  # Scriosta cheana féin nó imithe in éag

Dea-Chleachtais

  • Stóráil IDanna: Coinnigh response_idanna i do bhunachar sonraí in éineacht le meiteashonraí an chomhrá
  • Déan glantachán go rialta: Ná fan leis an éag uathoibríoch 30 lá do shonraí íogaire
  • Láimhseáil 404anna: Is féidir le freagra imeacht idir iarratais (éag, scriosadh de láimh)
  • Doiciméadaigh do shlabhraí: Chun dífhabhtaithe, rianaigh naisc previous_response_id idir do chuid freagraí

Príomhphointí

  • Faigheann GET /v1/responses/{id} freagra lena chuid ábhair agus meiteashonraí go léir
  • Scriosann DELETE /v1/responses/{id} freagra go buan – oibríocht do-aisiompaithe
  • Briseann scriosadh freagra idirmheánaigh comhthéacs an tslabhra comhrá
  • Láimhseáil earráidí 404: téann freagraí in éag go huathoibríoch tar éis 30 lá
  • Coinnigh response_idanna i do bhunachar sonraí féin le haghaidh inrianaitheachta