---
title: "ما هو استدعاء الأدوات (function calling) في LLM API؟"
description: "يتيح استدعاء الأدوات لنموذج LLM أن يطلب من شيفرتك تشغيل دالة بمعاملات JSON. كيف تعمل حلقة الطلب والنتيجة، وكم تكلّف من الرموز، وكيف يستخدمها الوكلاء."
url: https://broadrouter.com/ar/glossary/tool-calling/
lang: ar
updated: 2026-11-14
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

تُرجمت هذه الصفحة من الإنجليزية بمساعدة الذكاء الاصطناعي. [اقرأ الأصل الإنجليزي](https://broadrouter.com/glossary/tool-calling/) (حُدّث في 2026-11-14).

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

آخر تحديث 2026-11-14

استدعاء الأدوات، ويُسمّى أيضًا استدعاء الدوال (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، يبدو تعريف الأداة هكذا:

```json
{
  "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` نفسه والنتيجة، ثم تستدعي الواجهة من جديد.

## لماذا يهم

-   **الوكلاء.** وكلاء البرمجة وروبوتات الدعم ومساعدو البيانات هم في الغالب حلقات من استدعاءات الأدوات.
-   **التكلفة.** كل جولة طلبٌ جديد يعيد إرسال المحادثة وتعريفات الأدوات ونتائجها بوصفها [رموز إدخال](https://broadrouter.com/ar/glossary/input-and-output-tokens/). والحلقات الطويلة تجعل [الإدخال المخزّن مؤقتًا](https://broadrouter.com/ar/glossary/cached-input-tokens/) وثبات ترتيب الأدوات أمرين مهمين.
-   **الأمان.** المعاملات تأتي من النموذج. تحقّق منها قبل تشغيل أي شيء يغيّر البيانات أو ينفق المال.

أما للرد الذي يجب أن يطابق مخططًا دون الحاجة إلى دالة، فإن [المخرجات المنظَّمة](https://broadrouter.com/ar/glossary/structured-output/) هي الأداة الأبسط.

## في BroadNet Inference

يُدرج توثيق BroadNet استدعاء الأدوات لنموذجَي [GLM 5.3](https://broadrouter.com/ar/models/glm-5.3/) و[Qwen3.8 27B](https://broadrouter.com/ar/models/qwen3.8-27b/)، وكلاهما يدعم المخرجات المنظَّمة والاستدلال المنطقي. ولا يذكر التوثيق دعم الأدوات في DeepSeek V4.1 Flash ولا BroadNet Gemma 4 VL 26B. اختبر حلقة أدواتك على النموذج الذي تنوي إطلاقه.

يستدل النموذجان المُدرجان قبل الإجابة، والاستدلال المنطقي يُحتسب ضمن `max_tokens`، فاترك مساحة كافية وإلا قد يُقطع استدعاء الأداة. راجع [رموز الاستدلال المنطقي](https://broadrouter.com/ar/glossary/reasoning-tokens/). أما أدوات الوكلاء التي تأتي بصيغة أدواتها الخاصة، فراجع [دليل Cline](https://broadrouter.com/ar/guides/cline-openai-compatible/) و[دليل Vercel AI SDK](https://broadrouter.com/ar/guides/vercel-ai-sdk-openai-compatible/).

## أخطاء شائعة

-   تحليل `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، فاختبرها قبل أن تعتمد عليها هناك.

## انظر أيضًا

-   [المخرجات المنظَّمة (Structured output)](https://broadrouter.com/ar/glossary/structured-output/) (مصطلح)
-   [رموز الإدخال والإخراج (Input and output tokens)](https://broadrouter.com/ar/glossary/input-and-output-tokens/) (مصطلح)
-   [رموز الإدخال المخزّنة مؤقتًا (Cached input tokens)](https://broadrouter.com/ar/glossary/cached-input-tokens/) (مصطلح)
-   [واجهة API متوافقة مع OpenAI (OpenAI-compatible API)](https://broadrouter.com/ar/glossary/openai-compatible-api/) (مصطلح)
-   [وكيل الذكاء الاصطناعي (AI agent)](https://broadrouter.com/ar/glossary/agent/) (مصطلح)
-   [MCP (بروتوكول سياق النموذج)](https://broadrouter.com/ar/glossary/mcp/) (مصطلح)
-   [وضع JSON (JSON mode)](https://broadrouter.com/ar/glossary/json-mode/) (مصطلح)
-   [حقن الأوامر (Prompt injection)](https://broadrouter.com/ar/glossary/prompt-injection/) (مصطلح)
-   [tool\_choice (اختيار الأداة)](https://broadrouter.com/ar/glossary/tool-choice/) (مصطلح)
-   [استدعاءات الأدوات المتوازية (Parallel tool calls)](https://broadrouter.com/ar/glossary/parallel-tool-calls/) (مصطلح)
-   [مخطط JSON (JSON Schema)](https://broadrouter.com/ar/glossary/json-schema/) (مصطلح)
-   [استخدام OpenAI Python SDK مع BroadNet Inference](https://broadrouter.com/ar/guides/openai-python-sdk/) (دليل)
-   [استخدام Cline مع BroadNet Inference (مزوّد OpenAI Compatible)](https://broadrouter.com/ar/guides/cline-openai-compatible/) (دليل)
-   [استخدام Vercel AI SDK مع BroadNet Inference](https://broadrouter.com/ar/guides/vercel-ai-sdk-openai-compatible/) (دليل)
-   [كيف تشغّل وكلاء برمجة متوازيين على LLM API بسعر ثابت](https://broadrouter.com/ar/blog/run-parallel-coding-agents-flat-rate/) (مقال)
-   [متى تستحق نافذة سياق بمليون رمز (ومتى لا تستحق)؟](https://broadrouter.com/ar/blog/million-token-context-window-guide/) (مقال)

جرّبه على مهامك الفعلية. تبدأ الحسابات الجديدة برصيد قدره $5 لاستخدام Gemma والتفريغ الصوتي. أما DeepSeek وGLM وQwen3.8 فتتطلب شحن الرصيد.

[ابدأ الآن](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-glossary-tool-calling&utm_content=page-cta) ·

**المصادر**

-   [OpenAI، دليل استدعاء الدوال](https://developers.openai.com/api/docs/guides/function-calling)
-   [مرجع OpenAI API، إنشاء إكمال محادثة (tools)](https://developers.openai.com/api/reference/resources/chat/subresources/completions/methods/create)
-   [المرجع التقني لـ BroadNet Inference API، النماذج (بالإنجليزية)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-glossary-tool-calling&utm_content=sources#models)
