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

Formáid freagartha: id, choices, agus finish_reason

Ceacht 8 as 12 Nuashonraithe 3 Samhain 2026 Forbróir
Ar an leathanach seo
  1. Anatamaíocht freagartha Chat Completions
  2. Struchtúr iomlán na freagartha
  3. An t-eagar choices
  4. Luachanna finish_reason
  5. Cásanna éagsúla a láimhseáil
  6. Príomhphointí

Nuashonraithe an 3 Samhain, 2026 bunaithe ar thagairt API Chat Completions xAI: níl ach stop, length, agus, i sruthú, end_turn nó null doiciméadaithe le haghaidh finish_reason; níl na luachanna tool_calls agus content_filter ón seanleagan liostaithe, agus braitear glaonna uirlisí trí message.tool_calls. Tá max_tokens imithe in éag in ionad max_completion_tokens. Foinse: Chat Completions.

Anatamaíocht freagartha Chat Completions

Tugann gach glao ar an bpointe deiridh Chat Completions oibiacht JSON ar ais atá struchtúrtha le réimsí caighdeánaithe. Tá sé ríthábhachtach an struchtúr seo a thuiscint chun sonraí a eastósct go ceart, chun cásanna imeallacha a láimhseáil, agus chun do chomhtháthuithe a dhífhabhtú.

id
Aitheantóir uathúil
choices
Eagar freagartha
usage
Comhairitheoirí token
system_fingerprint
Méarlorg an chórais

Struchtúr iomlán na freagartha

Seo sampla de ghnáthfhreagra a thugann an API ar ais:

{
  "id": "chatcmpl-abc123xyz",
  "object": "chat.completion",
  "created": 1712345678,
  "model": "grok-4.20-0309-reasoning",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Is brainse de fhoghlaim mheaisín é an fhoghlaim dhomhain..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 42,
    "completion_tokens": 156,
    "total_tokens": 198
  },
  "system_fingerprint": "fp_abc123"
}

Réimsí leibhéil barr

  • id: Aitheantóir uathúil don chríochnú (formáid chatcmpl-...). Úsáideach le haghaidh rianaithe agus dífhabhtaithe.
  • object: I gcónaí "chat.completion". Ligeann sé duit an cineál freagartha seo a idirdhealú ó phointí deiridh eile.
  • created: Stampa ama Unix nuair a cruthaíodh an fhreagra.
  • model: An tsamhail a ghin an fhreagra. D’fhéadfadh sé a bheith beagán difriúil ón tsamhail a iarradh má úsáideann tú ailias.
  • choices: Eagar ina bhfuil an fhreagra nó na freagraí a gineadh.
  • usage: Comhairitheoirí token le haghaidh billeála.
  • system_fingerprint: Méarlorg ar an gcumraíocht chórais a úsáideadh.

An t-eagar choices

Is eagar é an réimse choices a bhíonn de ghnáth ina aon eilimint amháin (innéacs 0). Tá an méid seo a leanas i ngach eilimint:

  • index: Suíomh san eagar (tosaíonn sé ag 0)
  • message: Oibiacht le role (i gcónaí "assistant") agus content (an téacs a gineadh)
  • finish_reason: An fáth ar stop an ghiniúint

Chun an fhreagra téacs a eastóscadh:

# Python
response_text = response.choices[0].message.content
// JavaScript
const responseText = response.choices[0].message.content;

Luachanna finish_reason

Léiríonn an réimse finish_reason cén fáth ar stop an tsamhail ag giniúint téacs:

stop

"finish_reason": "stop"

Chríochnaigh an tsamhail a freagra go nádúrtha. Is é seo an cás is coitianta agus is inmhianaithe: dúirt an tsamhail gach rud a bhí le rá aici.

length

"finish_reason": "length"

Stop an ghiniúint toisc gur sroicheadh an teorainn aschuir—max_completion_tokens, a tháinig in ionad max_tokens atá imithe in éag anois, agus ní áirítear ach an fhreagra infheicthe. Dá bhrí sin, tá an fhreagra giorraithe: méadaigh an teorainn nó atoscaigh iarratas leanúnachta.

end_turn nó null i sruthú

I sruthú, iompraíonn gach píosa idirmheánach "end_turn" nó null in finish_reason; ní léiríonn ach an píosa deiridh an fáth stoptha.

Cad nach ndoiciméadaíonn an tagairt

Ní dhoiciméadaíonn tagairt API xAI ach na luachanna seo. Ní luaitear content_filter ná an luach a thugtar le linn glaonna uirlisí: chun a fháil amach an iarrann an tsamhail uirlis, seiceáil láithreacht message.tool_calls seachas luach finish_reason.

Cásanna éagsúla a láimhseáil

Sa táirgeadh, caithfidh tú seiceáil a dhéanamh ar finish_reason chun d’iompar a oiriúnú:

choice = response.choices[0]

if choice.message.tool_calls:
    # Ba mhaith leis an tsamhail glao a chur ar uirlis amháin nó níos mó
    for tool_call in choice.message.tool_calls:
        print(f"Uirlis iarrtha: {tool_call.function.name}")

elif choice.finish_reason == "length":
    # Freagra giorraithe: cuir an t-úsáideoir ar an eolas nó lean ar aghaidh
    print(choice.message.content)
    print("[Freagra giorraithe: méadaigh max_completion_tokens]")

else:
    # Freagra iomlán
    print(choice.message.content)

Príomhphointí

  • Tá id uathúil, eagar choices, agus oibiacht usage sa fhreagra
  • Tá an téacs a gineadh suite in choices[0].message.content
  • Léiríonn finish_reason cén fáth ar stop an ghiniúint: doiciméadaíonn an tagairt stop agus length (agus end_turn nó null i sruthú)
  • Seiceáil finish_reason chun freagraí giorraithe a aimsiú, agus message.tool_calls le haghaidh glaonna uirlisí
  • Aithníonn system_fingerprint an chumraíocht chórais a úsáideadh don ghiniúint