BroadRouter
ابدأ الآن

tool_choice (اختيار الأداة)

آخر تحديث

tool_choice معامل في الطلب يتحكم في استخدام الأدوات. في Chat Completions من OpenAI قد تكون قيمته auto (يقرر النموذج)، أو required (يجب أن يستدعي أداة أو أكثر)، أو none (بلا أدوات)، أو اسم دالة لفرض استدعائها. والخيارات المقابلة لدى Anthropic هي auto وany وtool وnone.

يُسمّى أيضًا: اختيار الأداة، فرض استدعاء الأداة، إجبار النموذج على استدعاء دالة، tool choice، forced tool call، forced function call

استدعاء الأدوات يتيح للنموذج أن يطلب من شيفرتك تشغيل دالة. ويقرر 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 تعني أداة بعينها. إنها تعني أي أداة.

أسئلة شائعة

ما القيمة الافتراضية لـ tool_choice؟

في واجهة OpenAI هي none حين لا تُرسل أدوات، وauto حين توجد أدوات. وتستخدم Anthropic القيم الافتراضية نفسها.

متى أفرض استدعاء أداة؟

حين يكون الاستدعاء هو الإجابة المقبولة الوحيدة، مثل مصنّف يجب أن يستدعي submit_label. أما لرد JSON ثابت، فالمخرجات المنظَّمة غالبًا أبسط.

هل تدعم BroadNet Inference المعامل tool_choice؟

توثّق BroadNet استدعاء الأدوات في GLM 5.3 وQwen3.8 27B، لكن مرجعها التقني لا يوثّق tool_choice. اختبر كل قيمة قبل الاعتماد عليها.

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