Messages et rôles
Le tableau messages transporte le contexte sous forme de séquence ordonnée. Le rôle system établit les règles de la tâche, user ajoute une requête, et assistant et tool préservent l’historique d’exécution.
Ne construisez pas l’historique en concaténant des chaînes : conservez le rôle et l’ordre d’origine de chaque message.
Complétion de 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
}'Contrôler la sortie
- model désigne une famille et une variante de modèle.
- temperature, top_p et une limite de sortie contrôlent la variabilité et la taille de la réponse.
- N’envoyez que les paramètres répertoriés comme pris en charge par le modèle sélectionné.
Boucle fiable
Distinguez un échec de transport d’une réponse de modèle dotée d’un finish_reason. Un refus ou une limite de contexte constitue une donnée d’interface, et non une raison de substituer un résultat.
Lorsque vos règles de conservation des données l’autorisent, stockez le corps de la requête source et la réponse normalisée sans identifiants d’accès.