BroadRouter
ابدأ الآن

استدعاءات الأدوات المتوازية (Parallel tool calls)

آخر تحديث

استدعاءات الأدوات المتوازية هي أن يعيد النموذج أكثر من استدعاء أداة في استجابة واحدة، مثل قراءة ثلاثة ملفات دفعة واحدة. وفي صيغة OpenAI تصل على شكل عدة عناصر في tool_calls، وضبط parallel_tool_calls على false يقصر النموذج على صفر أو استدعاء واحد في كل دور.

يُسمّى أيضًا: الاستدعاءات المتوازية للأدوات، استدعاء الدوال المتوازي، استدعاء عدة أدوات، parallel tool calls، parallel tool calling، parallel function calling، parallel_tool_calls، multiple tool calls

الوكيل الذي يحتاج إلى ثلاثة ملفات لا يلزمه أن يطلبها ذهابًا وإيابًا واحدًا تلو الآخر. فمع استدعاءات الأدوات المتوازية يطلب النموذج الثلاثة دفعة واحدة.

كيف يعمل

في استجابة استدعاء الأدوات، يكون message.tool_calls قائمة. ومع الاستدعاءات المتوازية تحتوي على أكثر من عنصر، لكل منها id خاص به واسم دالة ووسائط JSON.

"tool_calls": [
  {"id": "call_1", "type": "function", "function": {"name": "read_file", "arguments": "{\"path\": \"a.py\"}"}},
  {"id": "call_2", "type": "function", "function": {"name": "read_file", "arguments": "{\"path\": \"b.py\"}"}}
]

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

  • OpenAI: القيمة الافتراضية لـ parallel_tool_calls هي true. وضبطها على false “ensures exactly zero or one tool is called.” (ترجمة: يضمن استدعاء صفر أو أداة واحدة بالضبط.) ويحذّر الدليل من أن إحدى لقطات النماذج كانت تكرر أحيانًا استدعاء الأداة نفسها، ويوصي بإيقاف الميزة معها.
  • Anthropic: الاستخدام المتوازي مفعّل افتراضيًا. أوقفه بضبط disable_parallel_tool_use: true داخل كائن tool_choice. وتقول Anthropic إن API “doesn’t prescribe an execution order” (ترجمة: لا تفرض ترتيبًا للتنفيذ)، وإن جميع نتائج الأدوات ينبغي أن تعود في رسالة مستخدم واحدة حتى يستمر التوازي في العمل.

لماذا يهم

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

في BroadNet Inference

يوثّق المرجع التقني لـ BroadNet استدعاء الأدوات لنموذجَي GLM 5.3 وQwen3.8 27B، ولا يوثّق parallel_tool_calls. اختبر هل يعيد أمرك عدة استدعاءات وهل تُحترم القيمة false. والاستدعاءات المتوازية تصل في استجابة واحدة، فلا تزيد عدد طلباتك. أما تشغيل الأدوات فعليك أنت. ولاحظ أن جلسة الخطة غير المحدودة في BroadNet تسمح بطلب واحد في كل مرة، وهي لنموذج DeepSeek V4.1 Flash فقط؛ وعلى مفاتيح الدفع حسب الاستخدام يبلغ حد التزامن 4 من الطلبات قيد التنفيذ. وتحتوي مقالة استدعاء الأدوات مع النماذج المفتوحة على حلقة عمل جاهزة.

أخطاء شائعة

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

أسئلة شائعة

هل تعني استدعاءات الأدوات المتوازية طلبات API متوازية؟

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

كيف أوقف استدعاءات الأدوات المتوازية؟

في صيغة OpenAI اضبط parallel_tool_calls على false؛ وتقول OpenAI إن هذا "ensures exactly zero or one tool is called." (ترجمة: يضمن استدعاء صفر أو أداة واحدة بالضبط.) وفي API الخاصة بـ Anthropic اضبط disable_parallel_tool_use على true داخل tool_choice.

هل يدعم BroadNet Inference المعامل parallel_tool_calls؟

لا يوثّق المرجع التقني لـ BroadNet المعامل parallel_tool_calls. واستدعاء الأدوات موثّق لنموذجَي GLM 5.3 وQwen3.8 27B؛ اختبر هل يعيدان عدة استدعاءات وهل يُحترم هذا الخيار.

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