BroadRouter
ابدأ الآن

استدعاء الأدوات (Tool calling)

آخر تحديث

استدعاء الأدوات، ويُسمّى أيضًا استدعاء الدوال (function calling)، ميزة في واجهات LLM API يُرجع فيها النموذج طلبًا منظَّمًا لتشغيل دالة عرّفها المطوّر، مع معاملات بصيغة JSON. ويشغّل التطبيق الدالة ويعيد النتيجة؛ فالنموذج لا يشغّل الشيفرة بنفسه أبدًا.

يُسمّى أيضًا: استدعاء الأدوات، استدعاء الدوال، استخدام الأدوات، الأدوات، tool calling، function calling، tool use، tools، tool_calls

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

كيف يعمل

يصف دليل OpenAI حلقة بين تطبيقك والنموذج:

  1. أرسل الأدوات. يُدرج الطلب الدوال، لكلٍّ منها اسم ووصف ومخطط JSON Schema للمعاملات.
  2. استقبل استدعاء أداة. إن احتاج النموذج إلى أداة، يُرجع اسم الدالة ومعاملات JSON بدل إجابة نهائية.
  3. شغّلها. تنفّذ شيفرتك الدالة. ويضع دليل OpenAI هذه الخطوة على “the application side” (ترجمة: جانب التطبيق)؛ فالنموذج لا يشغّل الشيفرة بنفسه أبدًا.
  4. أعد النتيجة مع معرّف الاستدعاء المطابق.
  5. استقبل الإجابة، أو استدعاء أداة آخر. وكرّر حسب الحاجة.

في صيغة Chat Completions، يبدو تعريف الأداة هكذا:

{
  "type": "function",
  "function": {
    "name": "get_order_status",
    "description": "Look up an order by ID",
    "parameters": {
      "type": "object",
      "properties": { "order_id": { "type": "string" } },
      "required": ["order_id"]
    }
  }
}

يحمل الرد finish_reason: "tool_calls" وقائمة tool_calls. ولكل إدخال id واسم الدالة وarguments في صورة سلسلة JSON. تضيف رسالة بالدور role: "tool" مع tool_call_id نفسه والنتيجة، ثم تستدعي الواجهة من جديد.

لماذا يهم

  • الوكلاء. وكلاء البرمجة وروبوتات الدعم ومساعدو البيانات هم في الغالب حلقات من استدعاءات الأدوات.
  • التكلفة. كل جولة طلبٌ جديد يعيد إرسال المحادثة وتعريفات الأدوات ونتائجها بوصفها رموز إدخال. والحلقات الطويلة تجعل الإدخال المخزّن مؤقتًا وثبات ترتيب الأدوات أمرين مهمين.
  • الأمان. المعاملات تأتي من النموذج. تحقّق منها قبل تشغيل أي شيء يغيّر البيانات أو ينفق المال.

أما للرد الذي يجب أن يطابق مخططًا دون الحاجة إلى دالة، فإن المخرجات المنظَّمة هي الأداة الأبسط.

في BroadNet Inference

يُدرج توثيق BroadNet استدعاء الأدوات لنموذجَي GLM 5.3 وQwen3.8 27B، وكلاهما يدعم المخرجات المنظَّمة والاستدلال المنطقي. ولا يذكر التوثيق دعم الأدوات في DeepSeek V4.1 Flash ولا BroadNet Gemma 4 VL 26B. اختبر حلقة أدواتك على النموذج الذي تنوي إطلاقه.

يستدل النموذجان المُدرجان قبل الإجابة، والاستدلال المنطقي يُحتسب ضمن max_tokens، فاترك مساحة كافية وإلا قد يُقطع استدعاء الأداة. راجع رموز الاستدلال المنطقي. أما أدوات الوكلاء التي تأتي بصيغة أدواتها الخاصة، فراجع دليل Cline ودليل Vercel AI SDK.

أخطاء شائعة

  • تحليل arguments على أنها كائن. فهي تصل سلسلةً بصيغة JSON؛ فكّ ترميزها وعالج الأخطاء.
  • نسيان tool_call_id. فبدونه لا يستطيع النموذج مطابقة النتائج مع الاستدعاءات.

أسئلة شائعة

هل يشغّل النموذج دالتي؟

لا. يُرجع النموذج اسم الدالة والمعاملات فقط. وشيفرتك هي التي تقرر هل تشغّلها، ثم تشغّلها، وتعيد النتيجة في رسالة tool.

هل يستطيع النموذج استدعاء عدة أدوات دفعة واحدة؟

تسمح كثير من الواجهات باستدعاءات أدوات متوازية، فتُرجع عدة إدخالات في tool_calls ضمن استجابة واحدة. وتشغّل شيفرتك كلًّا منها وتُرجع نتيجة واحدة لكل tool_call_id.

أي نماذج BroadNet تدعم استدعاء الأدوات؟

يُدرج توثيق BroadNet الأدوات لنموذجَي GLM 5.3 وQwen3.8 27B، ولا يذكر دعمها في DeepSeek V4.1 Flash ولا BroadNet Gemma 4 VL 26B، فاختبرها قبل أن تعتمد عليها هناك.

اقرأها بصيغة Markdownاسأل ChatGPTاسأل Claudeاسأل Perplexity