سرفصل‌ها درس 140 از 250 · خروجی‌های ساختاریافته و فراخوانی تابع/ابزار
خروجی‌های ساختاریافته و فراخوانی تابع/ابزار

تابع -> اسکیمای ابزار (بازتاب)

فراخوانی ابزار (یا همان فراخوانی تابع) به مدل اجازه می‌دهد از برنامه‌ی شما بخواهد تابعی را اجرا کند: شما مجموعه‌ای از ابزارها را معرفی می‌کنید، مدل با نام ابزار و آرگومان‌ها پاسخ می‌دهد و شما آن را اجرا می‌کنید. اما مدل نمی‌تواند پایتون شما را ببیند – آن فقط یک … می‌بیند. شِما: یک توصیف JSON از نام و پارامترهای هر ابزار. نوشتن دستی این اسکیماها برای هر تابع خسته‌کننده است و به محض تغییر یک امضا از هم خارج می‌شود. راه‌حل این است خودنگری: تولید اسکیما مستقیماً از تابع.

پایتون inspect ماژول در زمان اجرا امضای یک تابع را می‌خواند. ساختار داده‌ای که APIهای فراخوانی ابزارها انتظار دارند به این صورت است:

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

شما در حال ساختن هستید tool_schema(func) که دقیقاً همان را تولید می‌کند. دو ایده تمام کار را انجام می‌دهند:

  • انواع پایتون را به انواع اسکیمای JSON نگاشت کنید. توضیحات هر پارامتر را بخوانید و ترجمه کنید: 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 param به صورت ظاهر می‌شود "integer" و یک str به عنوان "string"، یک پارامتر پیش‌فرض از requiredو یک مورد غیرمعیوب در آن وجود دارد. این قراردادی است که هر یکپارچه‌سازی فراخوانی ابزار بر آن تکیه می‌کند.

نوبت شما

نوشتن tool_schema(func) که یک تابع را با inspect.signature و بازمی‌گرداند {"name": func.__name__, "parameters": {"type": "object", "properties": {param: {"type": json_type}}, "required": [...]}}. Map int->"integer", float->"number", str->"string", bool->"boolean" (پیش‌فرض "string")، و یک پارامتر در required فقط زمانی که مقدار پیش‌فرض ندارد.

مشکلی در این درس دیدید؟ گزارشش کنید · دربارهٔ این درس بپرسید

این تمرین به‌زودی باز می‌شود

درس پیش از آن را تمام کنید تا این یکی باز شود. کل دوره رایگان است، حساب کاربری لازم نیست، و می‌توانید همین الان این درس را بخوانید.