الرسائل والأدوار
تحمل مصفوفة messages السياق كتسلسل مرتب. يضع system قواعد المهمة، ويضيف user طلبًا، ويحافظ assistant وtool على سجل التنفيذ.
لا تنشئ السجل بدمج السلاسل النصية: احتفظ بالدور والترتيب الأصلي لكل رسالة.
إكمال الدردشة
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
}'التحكم في المخرجات
- يحدد model عائلة النموذج وإصداره.
- تتحكم temperature وtop_p وحدّ المخرجات في تباين الاستجابة وحجمها.
- أرسل فقط المعلمات المدرجة على أنها مدعومة للنموذج المختار.
حلقة موثوقة
افصل عطل النقل عن استجابة النموذج التي تتضمن finish_reason. فالرفض أو حد السياق بيانات للواجهة وليس سببًا لاستبدال النتيجة.
عندما تسمح قواعد الاحتفاظ بالبيانات لديك، خزّن نص الطلب المصدر والاستجابة الموحّدة من دون بيانات اعتماد.