سجل الأدوات + الموزع
كل "AI agent" قرأت عنه ينتهي عند مكون واحد غير جذاب وهو tool registry. يرسل النموذج شيئا مثل {"tool": "search", "args": {"query": "weather"}}، ويجب على your code العثور على وظيفة Python الصحيحة، والتحقق من أن arguments منطقية، وتشغيلها، وإعادة النتيجة. إذا أخطأت في هذه الطبقة، فسيكون الـ agent بأكمله على بعد argument واحد خاطئ من الانهيار في production. يبني هذا الدرس الأول من المشروع هذه الطبقة بالضبط، وستعيد استخدام الفكرة في كل درس بعدها.
أنت تبني الموزع لوكيل بحث. يحتاج إلى أداتين للبدء: أداة search(query) تبحث عن حقيقة، وأداة calc(op, a, b) تقوم بالعمليات الحسابية. يقوم السجل بربط tool name بزوج: الدالة، وargument schema (مجموعة أسماء الوسائط التي تقبلها الأداة). الموزع هو البوابة التي يمر من خلالها كل شيء.
class Registry:
def __init__(self):
self.tools = {} # name -> {"fn": callable, "args": set_of_arg_names}
def register(self, name, fn, args):
self.tools[name] = {"fn": fn, "args": set(args)}
def dispatch(self, name, args):
# 1. unknown tool name -> raise KeyError
# 2. args keys != schema -> raise ValueError (missing OR extra)
# 3. otherwise -> call fn(**args) and return the result
...يجب أن تفرض dispatch rules (هذا هو الهدف الأساسي من التمرين):
- اسم أداة غير معروفة -> raise
KeyError. طلب الوكيل شيئا غير موجود. - يجب أن تتطابق مفاتيح
argsdict مع المخطط المسجل تماماً. إذا كان هناك مفقود وسيط أو وسيط إضافي -> raiseValueError. هذا ما يمنع{"q": ...}(مفتاح خاطئ) من عدم القيام بأي شيء بصمت. - A استدعاء صالح -> قم بتشغيل
fn(**args)وأعد ما يعيده.
لماذا set للمخطط؟ لأن التحقق يصبح مجرد تعيين المساواة: set(args) == self.tools[name]["args"]. إذا كانت النتيجة خاطئة، حدد ما إذا كانت المفاتيح ناقصة أو زائدة وارفع ValueError في كلتا الحالتين. الاستدعاء مع fn(**args) يوزع dict إلى keyword arguments، لذا فإن function signature يقوم بالربط النهائي.
A الذي يقرأ "بنيت عميلاً يستخدم الأدوات" يسأل حقاً: هل تعاملت مع المسار غير السعيد؟ العميل الذي يتم إرساله هو الذي يرفض فيه dispatcher المكالمات السيئة بصوت عالٍ بدلاً من إفساد التشغيل. اضغط على Run لتسجيل أداتين ومراقبة نجاح المكالمات الجيدة بينما تثير المكالمات السيئة استثناءات.
قم ببناء فئة Registry. يقوم register(name, fn, args) بتخزين الدالة ومخطط أسماء وسائطها (استخدم set). يجب على dispatch(name, args) القيام بما يلي: إثارة KeyError لاسم أداة غير معروف؛ إثارة ValueError إذا كانت مفاتيح args لا تطابق المخطط تماما (ناقصة أو إضافية)؛ وإلا استدعِ fn(**args) وأعد النتيجة. قم بتسجيل أداة search(query) وأداة calc(op, a, b) حتى يكون لدى الموزع شيء حقيقي لتوجيهه إليه.
سيفتح هذا التمرين قريبا
أنهِ الدرس السابق ليفتح هذا الدرس. الدورة كاملة مجانية، ولا تحتاج إلى حساب، ويمكنك قراءة هذا الدرس الآن.
يقوم هذا المتصفح بحظر ملفات تعريف الارتباط لـ learn.floati.life، لذا لا يمكن فتح الدروس التي أنهيتها هنا بالترتيب. اسمح بملفات تعريف الارتباط لهذا الموقع وأعد التحميل.