Messages API

הרכבת הודעה

בקשה כוללת model, messages ו-max_tokens; הוראת המערכת נשלחת בשדה system נפרד. שמרו תפקידים וסדר הודעות כדי שניסיון חוזר יוכל לשחזר את ההקשר.

קריאות HTTP גולמיות משתמשות ב-https://cicora.ai/api/v1/messages, ואילו Messages SDK מקבל רק את שורש השער https://cicora.ai/api ומוסיף בעצמו /v1/messages.

curl --request POST https://cicora.ai/api/v1/messages \
  --header "Authorization: Bearer $CICORA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "anthropic/claude-sonnet-5",
    "max_tokens": 500,
    "system": "Answer with a compact checklist.",
    "messages": [{"role": "user", "content": "Prepare a release plan."}]
  }'

כלים והזרמה

• הוסיפו tools ו-tool_choice רק למודלים שתומכים בהם.
• טפלו במצב הזרמה כרצף אירועים ולא כאובייקט JSON יחיד.
• אשרו את מבנה ארגומנטי הכלי לפני ביצוע פעולה.

בחירת תבנית

אל תערבבו שדות משתי תבניות בבקשה אחת. בחרו chat או messages בגבול הלקוח ונרמלו את ההיסטוריה הפנימית פעם אחת.

בדקו מעבר באמצעות שיחה שמורה ללא פרטים מזהים, כולל תוצאת כלי והקשר ארוך.