المنهج الدراسي الدرس 117 من 250 · استدعاء نموذج لغوي كبير حقيقي
استدعاء نموذج لغوي كبير حقيقي

دورة استدعاء الأداة ذهاباً وإياباً

استدعاء الأدوات هو رقصة من خطوتين. ترسل رسالة المستخدم مع مخططات الأدوات الخاصة بك؛ يجيب النموذج بكتلة tool_use تقول "استدعِ get_weather مع {city: 'Paris'}"؛ يقوم الكود الخاص بك بتشغيل تلك الدالة ويرسل الإجابة مرة أخرى كـ tool_result؛ ثم يستخدم النموذج ذلك لكتابة الرد النهائي. يبني هذا الدرس الخطوة الوسطى -> الجزء الذي يتحول فيه طلب النموذج إلى استدعاء Python حقيقي ويتم تغليف النتيجة للرحلة العائدة.

هذه هي الحلقة الحقيقية (للتوضيح فقط -> نحن لا نستدعي الشبكة):

resp = client.messages.create(model="claude-opus-5-5", max_tokens=1024,
                              tools=TOOLS, messages=history)
# resp.stop_reason == "tool_use". The model may ask for SEVERAL tools at once:
# append its turn once, run every tool_use block, and send ALL the results
# back together in ONE user message.
history.append({"role": "assistant", "content": resp.content})
results = []
for block in resp.content:
    if block.type == "tool_use":
        result = TOOLS_BY_NAME[block.name](**block.input)
        results.append({"type": "tool_result", "tool_use_id": block.id,
                        "content": str(result)})
history.append({"role": "user", "content": results})
final = client.messages.create(model="claude-opus-5-5", max_tokens=1024,
                               tools=TOOLS, messages=history)

التفاصيل غير القابلة للتفاوض: تقوم باستدعاء الدالة التي أطلق عليها النموذج اسمًا مع الوسائط التي قدمها، وتقوم بعمل echo لـ tool_use_id الخاص بها في tool_result حتى يتمكن النموذج من مطابقة كل إجابة مع طلبه، وعندما يطلب دور واحد عدة أدوات فإنك تعيد كل نتيجة في رسالة مستخدم واحدة (تقسيمها عبر رسائل متعددة يعلم النموذج التوقف عن الطلب بالتوازي). في هذا الدرس تتعامل مع أبسط حالة وهي استدعاء أداة واحدة؛ الدرس 4 يتعامل مع عدة أدوات. نحن نمثل الاستجابة كـ dict بسيط لكي تعمل دون اتصال بالإنترنت:

{"content": [{"type": "tool_use", "id": "toolu_1",
              "name": "get_weather", "input": {"city": "Paris"}}],
 "stop_reason": "tool_use"}

أنت تقوم ببناء run_tool_call(resp, tools)، حيث يقوم tools بربط اسم أداة بدالة Python. يجب عليه:

  • ابحث عن أول block في resp["content"] الذي يكون type الخاص به هو "tool_use".
  • ابحث عن tools[name] واستدعِه مع input الخاص بالكتلة كوسائط مسمّاة: tools[name](**block["input"]). إذا لم يكن الاسم في tools، فارفع خطأً (KeyError أو ValueError) -> لا تشغّل أبداً أداة توهّمها النموذج.
  • أعد رسالة المستخدم اللاحقة التي تحمل النتيجة مرة أخرى:
{"role": "user",
 "content": [{"type": "tool_result",
              "tool_use_id": <the block's id>,
              "content": str(result)}]}

حوّل النتيجة إلى نص باستخدام str(result) -> ينتقل محتوى tool_result كنص. ابنِه بحيث ينتج استدعاءان مختلفان للأدوات (اسم ومُدخل مختلفان) رسالتي tool_result مختلفتين، ويُعاد tool_use_id الأصلي كما هو، ويرفع اسم أداة غير معروف خطأً.

دورك

اكتب run_tool_call(resp, tools). ابحث عن أول كتلة {"type": "tool_use", "id", "name", "input"} في resp["content"]، وقم باستدعاء tools[name](**input)، وأرجع الرسالة التالية {"role": "user", "content": [{"type": "tool_result", "tool_use_id": <id>, "content": str(result)}]}. ارفع خطأ عند اسم أداة غير موجود في tools.

هل لاحظت مشكلة في هذا الدرس؟ أبلغ عنها · اسأل عن هذا الدرس

سيفتح هذا التمرين قريبا

أنهِ الدرس السابق ليفتح هذا الدرس. الدورة كاملة مجانية، ولا تحتاج إلى حساب، ويمكنك قراءة هذا الدرس الآن.