ویژگی اجرای کد Gemini API مدل را قادر میسازد تا کد پایتون را تولید و اجرا کند و تا زمانی که به خروجی نهایی برسد، بهطور مکرر از نتایج یاد بگیرد. میتوانید از این قابلیت اجرای کد برای ساخت برنامههایی استفاده کنید که از استدلال مبتنی بر کد بهره میبرند و خروجی متن تولید میکنند. به عنوان مثال، می توانید از اجرای کد در برنامه ای استفاده کنید که معادلات را حل می کند یا متن را پردازش می کند.
اجرای کد هم در AI Studio و هم در Gemini API موجود است. در AI Studio، میتوانید اجرای کد را در پانل سمت راست زیر ابزارها فعال کنید. Gemini API اجرای کد را به عنوان ابزاری مشابه فراخوانی تابع فراهم می کند. پس از اینکه اجرای کد را به عنوان یک ابزار اضافه کردید، مدل تصمیم میگیرد چه زمانی از آن استفاده کند.
محیط اجرای کد شامل کتابخانه های زیر است: altair
، chess
، cv2
، matplotlib
، mpmath
، numpy
، pandas
، pdfminer
، reportlab
، seaborn
، sklearn
، statsmodels
، striprtf
، sympy
و tabulate
. شما نمی توانید کتابخانه های خود را نصب کنید.
با اجرای کد شروع کنید
این بخش فرض می کند که مراحل راه اندازی و پیکربندی نشان داده شده در شروع سریع را تکمیل کرده اید.
ورودی/خروجی (I/O)
با شروع Gemini 2.0 Flash ، اجرای کد از ورودی فایل و خروجی نمودار پشتیبانی می کند. با استفاده از این قابلیتهای ورودی و خروجی جدید، میتوانید فایلهای CSV و متنی را آپلود کنید، درباره فایلها سؤال بپرسید، و نمودارهای Matplotlib را به عنوان بخشی از پاسخ تولید کنید.
قیمت گذاری ورودی/خروجی
هنگام استفاده از اجرای کد ورودی/خروجی، برای نشانههای ورودی و نشانههای خروجی هزینه دریافت میکنید:
نشانه های ورودی:
- درخواست کاربر
نشانه های خروجی:
- کد تولید شده توسط مدل
- خروجی اجرای کد در محیط کد
- خلاصه تولید شده توسط مدل
جزئیات ورودی/خروجی
هنگامی که با اجرای کد ورودی/خروجی کار می کنید، از جزئیات فنی زیر آگاه باشید:
- حداکثر زمان اجرای محیط کد 30 ثانیه است.
- اگر محیط کد خطایی ایجاد کند، مدل ممکن است تصمیم بگیرد خروجی کد را دوباره تولید کند. این می تواند تا 5 بار اتفاق بیفتد.
- حداکثر اندازه ورودی فایل توسط پنجره نشانه مدل محدود شده است. در AI Studio، با استفاده از Gemini Flash 2.0، حداکثر اندازه فایل ورودی 1 میلیون توکن است (تقریباً 2 مگابایت برای فایل های متنی از انواع ورودی پشتیبانی شده). اگر فایلی را بارگذاری کنید که خیلی بزرگ است، AI Studio به شما اجازه ارسال آن را نمی دهد.
یک دور | دو جهته (Multimodal Live API) | |
---|---|---|
مدل های پشتیبانی شده | تمامی مدل های Gemini 2.0 | فقط مدل های آزمایشی فلش |
انواع ورودی فایل پشتیبانی می شود | png.، .jpeg، .csv، .xml، .cpp، .java، .py، .js، .ts | png.، .jpeg، .csv، .xml، .cpp، .java، .py، .js، .ts |
طرحبندی کتابخانهها پشتیبانی میشود | Matplotlib | Matplotlib |
استفاده از چند ابزار | خیر | بله |
صورتحساب
هیچ هزینه اضافی برای فعال کردن اجرای کد از Gemini API وجود ندارد. بر اساس مدل Gemini که استفاده میکنید، با نرخ فعلی نشانههای ورودی و خروجی صورتحساب دریافت خواهید کرد.
در اینجا چند چیز دیگر در مورد صدور صورتحساب برای اجرای کد وجود دارد:
- شما فقط یک بار برای نشانههای ورودی که به مدل ارسال میکنید صورتحساب دریافت میکنید و برای نشانههای خروجی نهایی که توسط مدل به شما بازگردانده میشود صورتحساب دریافت میکنید.
- توکن هایی که کد تولید شده را نشان می دهند به عنوان نشانه های خروجی شمارش می شوند. کد تولید شده می تواند شامل متن و خروجی چندوجهی مانند تصاویر باشد.
- نتایج اجرای کد نیز به عنوان نشانه های خروجی محاسبه می شود.
- بر اساس مدل Gemini که استفاده می کنید، صورتحساب شما با نرخ فعلی نشانه های ورودی و خروجی محاسبه می شود.
- اگر Gemini هنگام ایجاد پاسخ شما از اجرای کد استفاده می کند، درخواست اصلی، کد تولید شده و نتیجه کد اجرا شده برچسب نشانه های میانی هستند و به عنوان نشانه های ورودی صورتحساب می شوند.
- سپس Gemini یک خلاصه تولید می کند و کد تولید شده، نتیجه کد اجرا شده و خلاصه نهایی را برمی گرداند. اینها به عنوان نشانه های خروجی صورتحساب می شوند.
- Gemini API شامل یک تعداد توکن میانی در پاسخ API است، بنابراین میدانید که چرا نشانههای ورودی اضافی فراتر از درخواست اولیه خود دریافت میکنید.
محدودیت ها
- مدل فقط می تواند کد تولید و اجرا کند. نمی تواند مصنوعات دیگر مانند فایل های رسانه ای را برگرداند.
- در برخی موارد، فعال کردن اجرای کد میتواند منجر به رگرسیون در سایر حوزههای خروجی مدل شود (مثلاً نوشتن یک داستان).
- تفاوت هایی در توانایی مدل های مختلف برای استفاده موفقیت آمیز از اجرای کد وجود دارد.