ویژگی اجرای کد Gemini API مدل را قادر می‌سازد تا کد پایتون را تولید و اجرا کند و تا زمانی که به خروجی نهایی برسد، به‌طور مکرر از نتایج یاد بگیرد. می‌توانید از این قابلیت اجرای کد برای ساخت برنامه‌هایی استفاده کنید که از استدلال مبتنی بر کد بهره می‌برند و خروجی متن تولید می‌کنند. به عنوان مثال، می توانید از اجرای کد در برنامه ای استفاده کنید که معادلات را حل می کند یا متن را پردازش می کند.
اجرای کد هم در AI Studio و هم در Gemini API موجود است. در AI Studio، می‌توانید اجرای کد را در تنظیمات پیشرفته فعال کنید. Gemini API اجرای کد را به عنوان ابزاری مشابه فراخوانی تابع فراهم می کند. پس از اینکه اجرای کد را به عنوان یک ابزار اضافه کردید، مدل تصمیم می‌گیرد چه زمانی از آن استفاده کند.
با اجرای کد شروع کنید
این بخش فرض می کند که شما یک Gemini SDK را نصب کرده اید و یک کلید API را پیکربندی کرده اید، همانطور که در شروع سریع نشان داده شده است.
اجرای کد در مقابل فراخوانی تابع
اجرای کد و فراخوانی تابع ویژگی های مشابهی هستند:
- اجرای کد به مدل اجازه می دهد تا کد را در باطن API در یک محیط ثابت و ایزوله اجرا کند.
- فراخوانی تابع به شما امکان می دهد توابعی را که مدل درخواست می کند، در هر محیطی که می خواهید اجرا کنید.
به طور کلی، اگر می تواند مورد استفاده شما را مدیریت کند، بهتر است از اجرای کد استفاده کنید. اجرای کد برای استفاده ساده‌تر است (شما فقط آن را فعال می‌کنید) و در یک درخواست GenerateContent حل می‌شود (بنابراین یک بار هزینه را متحمل می‌شود). فراخوانی تابع یک درخواست GenerateContent اضافی برای ارسال خروجی از هر فراخوانی تابع نیاز دارد (در نتیجه هزینه های متعددی را متحمل می شود).
در اکثر موارد، اگر توابع خود را دارید که می‌خواهید به صورت محلی اجرا کنید، باید از فراخوانی تابع استفاده کنید، و اگر می‌خواهید API کد پایتون را برای شما بنویسد و اجرا کند و نتیجه را برگرداند، باید از اجرای کد استفاده کنید.
صورتحساب
هیچ هزینه اضافی برای فعال کردن اجرای کد از Gemini API وجود ندارد. صورتحساب شما با نرخ فعلی نشانه های ورودی و خروجی دریافت می شود.
در اینجا چند چیز دیگر در مورد صدور صورتحساب برای اجرای کد وجود دارد:
- شما فقط یک بار برای نشانه‌های ورودی که به مدل ارسال می‌کنید صورتحساب دریافت می‌کنید و برای نشانه‌های خروجی نهایی که توسط مدل به شما بازگردانده می‌شود صورتحساب دریافت می‌کنید.
- توکن هایی که کد تولید شده را نشان می دهند به عنوان نشانه های خروجی شمارش می شوند.
- نتایج اجرای کد نیز به عنوان نشانه های خروجی محاسبه می شود.
محدودیت ها
- مدل فقط می تواند کد تولید و اجرا کند. نمی تواند مصنوعات دیگر مانند فایل های رسانه ای را برگرداند.
- این ویژگی از ورودی/خروجی فایل پشتیبانی نمی‌کند یا از مواردی استفاده نمی‌کند که خروجی غیر متنی دارند (مثلاً نمودارهای داده).
- اجرای کد می تواند حداکثر 30 ثانیه قبل از اتمام زمان اجرا شود.
- در برخی موارد، فعال کردن اجرای کد می‌تواند منجر به رگرسیون در سایر حوزه‌های خروجی مدل شود (مثلاً نوشتن یک داستان).
- تفاوت هایی در توانایی مدل های مختلف برای استفاده موفقیت آمیز از اجرای کد وجود دارد. Gemini 1.5 Pro بر اساس آزمایش ما بهترین مدل با عملکرد است.