استدعاء الأدوات هو الطريقة التي يتصرف بها النموذج اللغوي في العالم: يطلب من شيفرتك أن تبحث عن شيء أو تنفّذ استعلامًا أو تعدّل ملفًا، ثم يستخدم النتيجة.
كيف يعمل
يصف دليل OpenAI حلقة بين تطبيقك والنموذج:
- أرسل الأدوات. يُدرج الطلب الدوال، لكلٍّ منها اسم ووصف ومخطط JSON Schema للمعاملات.
- استقبل استدعاء أداة. إن احتاج النموذج إلى أداة، يُرجع اسم الدالة ومعاملات JSON بدل إجابة نهائية.
- شغّلها. تنفّذ شيفرتك الدالة. ويضع دليل OpenAI هذه الخطوة على “the application side” (ترجمة: جانب التطبيق)؛ فالنموذج لا يشغّل الشيفرة بنفسه أبدًا.
- أعد النتيجة مع معرّف الاستدعاء المطابق.
- استقبل الإجابة، أو استدعاء أداة آخر. وكرّر حسب الحاجة.
في صيغة 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. فبدونه لا يستطيع النموذج مطابقة النتائج مع الاستدعاءات.