cicora.ai
API spetsifikatsiyasiTools va function calling

Tools va function calling

Funksiyalarni JSON Schema bilan tavsiflang, chaqiruvni ilovangizda bajaring va natijani tarixga qaytaring.

Integratsiya ma’lumotnomasi: muhitingiz uchun parametrlar va mavjud imkoniyatlarni akkaunt API sozlamalari hamda model katalogidan tanlang.

Funksiya kontraktini tavsiflang

Tool nom, tushunarli tavsif va parametrlarning JSON Schema sidan iborat. Tavsif tool qachon tanlanishini tushuntiradi, sxema esa argumentlar shaklini cheklaydi.

Model chaqiruvni taklif qiladi; u o‘zi sizning tarmog‘ingizga, ma’lumotlar bazangizga yoki fayllaringizga kira olmaydi.

Function tool in a chat request
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"
}

O‘z tomoningizda bajarish

  • Tool nomini allowlist bo‘yicha tekshiring.
  • Ichki servisni chaqirishdan oldin argumentlarni sxemaga qarshi validatsiya qiling.
  • Tool harakatiga o‘z avtorizatsiyangizni, taym-autlarni va idempotentlikni qo‘llang.

Natijani qaytaring

tool_call_id va ixcham seriyalangan natijali tool xabarini qo‘shing, so‘ng shu kontekst bilan dialogni davom ettiring.

Tool bajarilish xatosini model xatosidan ajrating: model foydalanuvchiga tushuntira oladigan tuzilgan sababni yuboring.