cicora.ai
מפרט APIקריאת פונקציות

כלים וקריאת פונקציות

תארו פונקציות באמצעות JSON Schema, בצעו את הקריאה ביישום והחזירו את התוצאה לשיחה.

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

תיאור חוזה פונקציה

כלי כולל שם, תיאור ברור ו-JSON Schema לפרמטרים. התיאור מציין מתי לבחור בכלי, והסכמה מגבילה את הארגומנטים.

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

כלי פונקציה בבקשת צ׳אט
json
{
  "model": "openai/gpt-5.6-sol",
  "messages": [{"role": "user", "content": "What is the weather in Tashkent?"}],
  "tools": [{
    "type": "function",
    "function": {
      "name": "get_weather",
      "description": "Read current weather for a city.",
      "parameters": {
        "type": "object",
        "properties": {"city": {"type": "string"}},
        "required": ["city"],
        "additionalProperties": false
      }
    }
  }],
  "tool_choice": "auto"
}

ביצוע בצד שלכם

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

החזרת התוצאה

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

הפרידו כשל בביצוע כלי מכשל מודל: החזירו סיבה מובנית שהמודל יכול להסביר למשתמש.