استدعاء الأدوات يتيح للنموذج أن يطلب من شيفرتك تشغيل دالة. ويقرر tool_choice ما إذا كان ذلك اختياريًا أو إلزاميًا أو معطّلًا.
كيف يعمل
ترسل tools (أسماء الدوال وأوصافها ومعاملاتها بصيغة JSON Schema) ومعها tool_choice اختياريًا.
| قيمة OpenAI | المعنى | المقابل لدى Anthropic |
|---|---|---|
"auto" |
يختار النموذج رسالة أو استدعاءً واحدًا أو أكثر؛ القيمة الافتراضية حين تُرسل أدوات | {"type": "auto"} |
"required" |
“The model must call one or more tools” (ترجمة: يجب أن يستدعي النموذج أداة واحدة أو أكثر) | {"type": "any"} |
{"type": "function", "function": {"name": "get_weather"}} |
يفرض تلك الأداة بعينها | {"type": "tool", "name": "get_weather"} |
"none" |
بلا استدعاءات أدوات؛ القيمة الافتراضية حين لا توجد أدوات | {"type": "none"} |
ويصف دليل استدعاء الدوال لدى OpenAI أيضًا خيار الأدوات المسموح بها (allowed tools)، الذي يحصر الاستدعاءات في مجموعة فرعية مع إبقاء قائمة الأدوات الكاملة دون تغيير، ويقترحه لأجل التخزين المؤقت للأوامر.
{"model": "broadnet/glm-5.3",
"messages": [{"role": "user", "content": "Weather in Riyadh?"}],
"tools": [{"type": "function", "function": {"name": "get_weather",
"parameters": {"type": "object", "properties": {"city": {"type": "string"}},
"required": ["city"]}}}],
"tool_choice": {"type": "function", "function": {"name": "get_weather"}}}
ويشير توثيق Anthropic إلى أن الواجهة، مع any أو tool، تملأ بداية الرد مسبقًا، فلا يكتب النموذج أي نص قبل الاستدعاء، وإلى أن بعض نماذج Claude ترفض فرض استخدام الأداة وتُرجع خطأ 400.
لماذا يهم
- سلاسل معالجة موثوقة. خطوة الاستخراج التي يجب أن تنتهي باستدعاء لا ينبغي أن تتلقى ردًا نصيًا ثرثارًا. وفرض الاستدعاء يلغي هذا الاحتمال.
- أدوار آمنة. ضبط
noneفي دور التلخيص الأخير يمنع النموذج من بدء جولة أدوات أخرى مع إبقاء قائمة الأدوات نفسها. - التخزين المؤقت. تقول Anthropic إن تغيير
tool_choiceيُبطل كتل الرسائل المخزنة مؤقتًا، فأبقه ثابتًا عبر الأدوار قدر الإمكان.
في BroadNet Inference
يوثّق المرجع التقني لـ BroadNet استدعاء الأدوات في GLM 5.3 وQwen3.8 27B فقط، ولا يوثّق tool_choice. اختبر كل قيمة تنوي استخدامها: أرسل required أو اسم دالة، وتأكد من أن الرد يحتوي على tool_calls. وإذا لم يعمل الفرض كما ينبغي، فاستخدم auto مع تعليمات واضحة وتحقق من النتيجة، أو استخدم المخرجات المنظَّمة على النماذج نفسها. ويتضمن مقال استدعاء الأدوات في النماذج المفتوحة حلقة تحقق وإعادة محاولة.
أخطاء شائعة
- فرض أداة في كل دور من حلقة الوكيل، فلا يستطيع أبدًا تقديم إجابة نهائية.
- افتراض أن
requiredتعني أداة بعينها. إنها تعني أي أداة.