Messaggi e ruoli
L'array messages contiene il contesto come sequenza ordinata. System stabilisce le regole dell'attività, user aggiunge una richiesta, mentre assistant e tool conservano la cronologia di esecuzione.
Non costruire la cronologia concatenando stringhe: conserva il ruolo e l'ordine originale di ogni messaggio.
Completamento chat
bash
curl --request POST https://cicora.ai/api/v1/chat/completions \
--header "Authorization: Bearer $CICORA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "openai/gpt-5.6-sol",
"messages": [
{"role": "system", "content": "Be concise and cite assumptions."},
{"role": "user", "content": "Draft a release checklist."}
],
"temperature": 0.2
}'Controlla l'output
- model identifica una famiglia e una variante del modello.
- temperature, top_p e un limite di output controllano la variabilità e la dimensione della risposta.
- Invia solo i parametri indicati come supportati per il modello selezionato.
Ciclo affidabile
Distingui un errore di trasporto da una risposta del modello con finish_reason. Un rifiuto o un limite di contesto è un dato dell'interfaccia, non un motivo per sostituire un risultato.
Quando le tue regole di conservazione dei dati lo consentono, memorizza il corpo della richiesta sorgente e la risposta normalizzata senza credenziali.