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

دالة -> مخطط الأداة (التأمل الذاتي)

Tool calling (المعروف أيضاً باسم function calling) يسمح للنموذج بطلب تشغيل دالة من برنامجك: أنت تعلن عن مجموعة من الأدوات، ويرد النموذج باسم الأداة والوسائط، وأنت تقوم بتنفيذها. لكن النموذج لا يمكنه رؤية Python الخاصة بك -> هو يرى فقط schema: وهو وصف JSON لكل اسم أداة ومعاملاتها. كتابة تلك المخططات يدوياً لكل دالة أمر ممل ويخرج عن التزامن في اللحظة التي تغير فيها توقيعاً. الحل هو introspection: توليد المخطط مباشرة من الدالة.

تقوم وحدة inspect في Python بقراءة توقيع الدالة أثناء وقت التشغيل. يبدو المخطط الذي تتوقعه واجهات برمجة تطبيقات استدعاء الأدوات كالتالي:

{
  "name": "get_weather",
  "parameters": {
    "type": "object",
    "properties": {"city": {"type": "string"}, "days": {"type": "integer"}},
    "required": ["city"]
  }
}

أنت تبني tool_schema(func) الذي ينتج ذلك بالضبط. فكرتان تقومان بكل العمل:

  • قم بمطابقة أنواع Python مع أنواع JSON-schema.اقرأ تعليق كل معامل وترجمه: int -> "integer", float -> "number", str -> "string", bool -> "boolean". اجعل أي شيء آخر افتراضيا "string".
  • يتم اشتقاق المطلوب من القيم الافتراضية. المعامل الذي يحتوي على لا قيمة افتراضية مطلوب؛ المعامل الذي يحتوي على قيمة افتراضية اختياري. inspect.Parameter.empty هو الرمز لـ "لا توجد قيمة افتراضية".
import inspect
sig = inspect.signature(func)
for name, param in sig.parameters.items():
    is_required = param.default is inspect.Parameter.empty
    json_type = ...   # from param.annotation

استخدم func.__name__ لاسم الأداة. قم ببنائه بحيث تنتج وظيفتان بتعليقات مختلفة مخططين مختلفين بوضوح، يظهر بارامتر int كـ "integer" وبارامتر str كـ "string"، يتم استبعاد بارامتر افتراضي من required، بينما يتم تضمين بارامتر غير افتراضي فيه. هذا هو العقد الذي تعتمد عليه كل عملية تكامل لاستدعاء الأدوات.

دورك

اكتب tool_schema(func) الذي يفحص دالة باستخدام inspect.signature ويعيد {"name": func.__name__, "parameters": {"type": "object", "properties": {param: {"type": json_type}}, "required": [...]}}. قم بربط int->"integer"، float->"number"، str->"string"، bool->"boolean" (القيمة الافتراضية "string")، وضع باراميتر في required فقط عندما لا يكون له قيمة افتراضية.

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

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

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