cicora.ai
מפרט APIמדיניות מסירה

ניתוב

בטאו את דרישות הביצוע בהעדפות הספק ושמרו את התוצאה בפועל לצורכי נראות.

מדריך שילוב: בחרו פרמטרים ויכולות זמינות בהגדרות ה-API של החשבון ובקטלוג המודלים של הסביבה שלכם.

הגדרת העדפות

השדה provider מגדיר כללי בחירת ביצוע לבקשה אחת. התייחסו אליו כמדיניות, ולא כהבטחה לנתיב פנימי מסוים.

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

העדפות ניתוב בבקשה
json
{
  "model": "openai/gpt-5.6-sol",
  "messages": [{"role": "user", "content": "Classify this support ticket."}],
  "provider": {
    "order": ["provider-a", "provider-b"],
    "allow_fallbacks": true,
    "require_parameters": true
  }
}

מגבלות שימושיות

  • order קובע את עדיפות האפשרויות המותרות.
  • allow_fallbacks קובע אם בקשה יכולה לעבור לחלופה.
  • require_parameters מסייע לדחות נתיב שאינו יכול לעמוד בחוזה שהוצהר.

נראות

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

כאשר האפשרויות מוצו, השיבו באופן צפוי: החזירו את הסיבה המקורית והציעו ניסיון חוזר בתצורה תואמת.