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_call_id ونتيجة مسلسلة موجزة، ثم واصل المحادثة بالسياق نفسه.

أبقِ فشل تنفيذ الأداة منفصلًا عن فشل النموذج: أعد سببًا منظّمًا يمكن للنموذج شرحه للمستخدم.