المنهج الدراسي الدرس 141 من 250 · المخرجات المهيكلة واستدعاء الوظائف/الأدوات
المخرجات المهيكلة واستدعاء الوظائف/الأدوات

موزع الأدوات / الموجه

قرأ النموذج مخططات الأدوات الخاصة بك وأجاب باستدعاء أداة: كائن محلل مثل {"name": "add", "arguments": {"a": 4, "b": 5}}. الآن يجب على برنامجك أن يقوم فعليا بـ run الوظيفة الصحيحة. هذه هي مهمة الـ dispatcher (أو الموجه): ابحث عن الأداة المسماة، وتحقق من أن الوسائط هي بالضبط ما تتوقعه الوظيفة، واستدعها، وأرجع النتيجة. هذا هو السطر الذي تتحول فيه كلمات LLM إلى تأثير جانبي حقيقي في نظامك، لذا هو أيضا المكان الذي يجب أن تكون فيه صارما.

في حلقة حقيقية، يأتي مباشرة بعد تحليل رد النموذج:

call = parse_tool_call(model_reply)        # {"name": ..., "arguments": {...}}
result = dispatch(call, TOOL_REGISTRY)     # runs the matching Python function
# feed result back to the model as the tool's observation

أنت تقوم ببناء dispatch(call, registry)، حيث يقوم registry بربط أسماء الأدوات بدوال Python. يجب عليه:

  • اقرأ call["name"] وcall["arguments"] (الوسائط الافتراضية إلى {}).
  • ارفض أداة غير معروفة. إذا لم يكن الاسم موجودا في السجل، ارفع ValueError -> لا تقم أبدا بعدم فعل شيء بصمت، ولا تقم أبدا بتشغيل أداة هلوس بها النموذج.
  • تحقق من الوسائط.استخدم inspect.signature للحصول على أسماء بارامترات الدالة والتأكد من أن مفاتيح الوسائط المقدمة تطابقها تماما -> يجب أن يرفع خطأ في حال فقدان وسيط أو وجود وسيط إضافي غير متوقع.
  • استدعاء وإرجاع. استدعِ الدالة مع func(**arguments) وأرجع نتيجتها.
import inspect
expected = set(inspect.signature(func).parameters)
if set(arguments) != expected:
    raise ValueError("bad arguments")
return func(**arguments)

لماذا كل هذا التشدد بشأن arguments؟ إن استدعاء أداة يعمل بـ arguments خاطئة إما أن يتسبب في تعطل البرنامج في عمق الـ function الخاصة بك، أو الأسوأ من ذلك، يقوم بالفعل خاطئ بهدوء. الهدف الأساسي هو الفشل بوضوح عند الحدود. قم ببنائه بحيث تعيد أداتان مختلفتان (على سبيل المثال calculator و lookup) كل واحدة منهما نتيجتها الخاصة، وترفع أداة غير معروفة استثناء، كما يرفع كل من argument مفقود أو argument إضافي استثناء.

دورك

اكتب dispatch(call, registry) حيث call هو {"name": ..., "arguments": {...}} وregistry يربط الأسماء بالدوال. ارفع خطأً عند اسم أداة غير معروف. استخدم inspect.signature للتأكد من وجود كل معامل مطلوب (required) وعدم وجود إضافات غير متوقعة (المعامل ذو القيمة الافتراضية اختياري، لذا لا بأس بحذفه). يربط inspect.signature(func).parameters كل اسم بكائن معامل p؛ وتكون p.default is inspect.Parameter.empty True تماماً عندما لا يكون للمعامل قيمة افتراضية، أي أنه مطلوب، ثم استدعِ func(**arguments) وأرجِع النتيجة. يجب أن تُرجع أداتان مختلفتان كل منهما نتيجتها الخاصة.

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

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

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