Tool Use في Claude للمتوسط: ازاي تخلي LLM يستدعي كودك بدل ما يهلوس

الـ loop ده مهم: النموذج ممكن يستدعي 1 أو 5 tools على التوالي قبل ما يكتفي. وقتها stop_reason بيتغيّر من "tool_use" لـ "end_turn". لو حذفت الـ loop وكتفيت بـ if واحد، شات البوت هيقطع في نص الـ reasoning لو النموذج محتاج tool ثاني.

أرقام من Berkeley Function Calling Leaderboard

BFCL هو المرجع الفعلي لقياس دقة استدعاء الـ tools في 2026. القياس بيتم على Abstract Syntax Tree بيقارن استدعاء النموذج بالاستدعاء الصحيح. على نسخة V3:

• GLM 4.5 في الصدارة بـ 76.7%.
• Qwen3 32B بـ 75.7%.
• على V4 الأحدث (multi-turn و agentic)، Llama 3.1 405B Instruct بـ 88.5%.

على شات بوت دعم فني تجاري عربي بمعدل 2,400 محادثة يومياً، قياس داخلي لفريق Optimizing بالعربي رصد إن تطبيق Tool Use بيرفع الدقة من 64% (تخمين النموذج وحده) لـ 91% (مع DB query حقيقي على المخزون). الـ trade-off: متوسط الـ latency يزيد من 1.1 ثانية لـ 2.4 ثانية بسبب الـ round trip الإضافي.

Trade-offs خفية لازم تعرفها

• Latency بيتضاعف: كل tool call = round trip إضافي للنموذج. لو فيه 3 tools متتالية، الـ response هيتأخر 3 أضعاف. الحل: تشغيل الـ tools على التوازي لما النموذج يطلب أكتر من tool في نفس الرد (parallel tool use مدعوم في Claude 4 family).
• التكلفة بتزيد قبل ما تكسب: الـ tools description بتتحط في كل request كـ system prompt. لو عندك 20 tool وكل واحد متوسطه 200 token، إنت بتدفع 4,000 token زيادة في كل استدعاء. استخدم Prompt Caching علشان تنزّل التكلفة دي 90%.
• تصميم الـ schema حرج: لو الـ description بتاع الـ tool ضعيف، النموذج هيستدعيه في الوقت الغلط أو يبعت inputs غلط. اكتب description مفصّل لكل field. مثلاً بدل "city: string" اكتب "city: اسم المدينة بالعربي أو الإنجليزي، مثلاً 'القاهرة' أو 'Tokyo'".
• error handling مسؤوليتك: الـ tool ممكن يفشل (API down، DB lock، rate limit). لازم ترجّع error واضح للنموذج بدل ما تطلع exception. الـ best practice: ابعت {"error": "rate_limited", "retry_after": 30} وخلّي النموذج يقرّر يحاول تاني ولا يعتذر للمستخدم.

متى لا تستخدم Tool Use

الافتراض الأساسي إن النموذج لوحده مش عارف الإجابة. خالف الافتراض ده وTool Use بيبقى ضرر. حالات بعينها:

• مهام لغوية بحتة: تلخيص، ترجمة، إعادة صياغة، تصحيح إملائي. النموذج عارف يعملها وحده. إضافة tools هتزوّد latency وtokens بدون فايدة.
• workflow ثابت ومعروف الخطوات سلفاً: لو الـ pipeline هو fetch → transform → save في كل مرة بدون قرار، اعمل function calls عادية من الكود ومتخليش النموذج يقرّر. هتوفر round trip كامل.
• عمليات حساسة جداً: تحويلات مالية، حذف سجلات. خلي النموذج يرجّع الـ intent بس، وكودك يطلب confirmation يدوية قبل التنفيذ. سيب الـ Tool ينفّذ بنفسه بس في الحاجات اللي reversible.

الخطوة التالية

افتح Anthropic Console، اعمل tool واحد بسيط (مثلاً get_current_time اللي بيرجع datetime.now())، وجرّب الـ loop اللي فوق. لو الـ stop_reason رجع "end_turn" من أول استدعاء بدون ما النموذج يطلب الـ tool، ده معناه إن وصف الـ tool مش واضح لـ Claude. حسّن الـ description و استلم. ولو لقيت إن الـ tools description بتاكل tokens كتير، اقرأ مقال Prompt Caching للمتوسط على نفس الموقع وطبّق الـ cache_control على array الـ tools.

مصادر

• توثيق Claude Tool Use الرسمي: platform.claude.com/docs/en/agents-and-tools/tool-use/overview
• Advanced Tool Use announcement من Anthropic Engineering: anthropic.com/engineering/advanced-tool-use
• Berkeley Function Calling Leaderboard V4: gorilla.cs.berkeley.edu/leaderboard.html
• ورقة ReAct: Reasoning and Acting in Language Models — Yao et al. 2022: arxiv.org/abs/2210.03629
• ورقة BFCL: From Tool Use to Agentic Evaluation — Patil et al. 2025 (ICML): proceedings.mlr.press/v267/patil25a.html