תכונת ביצוע הקוד של Gemini API מאפשרת למודל ליצור ולהריץ קוד Python, וללמוד באופן איטרטיבי מהתוצאות עד שהוא מגיע לפלט הסופי. אפשר להשתמש ביכולת הזו של ביצוע הקוד כדי לפתח אפליקציות שיפיקו תועלת מחשיבה מבוססת-קוד ומפיקות פלט טקסט. לדוגמה, אתם יכולים להשתמש בביצוע קוד באפליקציה שפותרת משוואות או מעבדת טקסט.
ביצוע קוד זמין גם ב-AI Studio וגם ב-Gemini API. ב-AI Studio, אפשר להפעיל את הפעלת הקוד בקטע הגדרות מתקדמות. Gemini API מספק הפעלת קוד ככלי, בדומה להפעלת פונקציות. אחרי שמוסיפים הפעלת קוד ככלי, המודל מחליט מתי להשתמש בו.
התחלת העבודה עם ביצוע קוד
 להצגה ב-ai.google.dev
|
 הפעלה ב-Google Colab
|
 הצגת המקור ב-GitHub
|
הקטע הזה מבוסס על ההנחה שהתקנתם את Gemini SDK והגדרתם מפתח API, כמו שמוסבר בquickstart.
ביצוע קוד לעומת קריאה לפונקציות
הפעלת קוד והפעלת פונקציות הן תכונות דומות:
- הפעלת קוד מאפשרת למודל להריץ קוד בקצה העורפי של ה-API בסביבה קבועה ומבודדת.
- שליחת פונקציות מאפשרת להריץ את הפונקציות שהמודל מבקש, בכל סביבה שרוצים.
באופן כללי, מומלץ להשתמש בביצוע קוד אם הוא יכול לטפל בתרחיש לדוגמה שלכם. קל יותר להשתמש בקוד (רק מפעילים אותו) והוא מטופל בבקשת GenerateContent אחת (וכתוצאה מכך נוצר חיוב יחיד). כדי לשלוח חזרה את הפלט מכל קריאה לפונקציה נדרשת בקשת GenerateContent נוספת (וכך יצטברו חיובים מרובים).
ברוב המקרים, כדאי להשתמש בקריאות לפונקציות אם יש לכם פונקציות משלכם שאתם רוצים להריץ באופן מקומי. כדאי גם להריץ קוד אם אתם רוצים שה-API יכתוב ויריץ קוד Python בשבילכם ויחזיר את התוצאה.
חיוב
ההפעלה של קוד מה-Gemini API לא כרוכה בתשלום נוסף. תחויבו לפי השיעור הנוכחי של אסימוני הקלט והפלט.
כמה דברים נוספים שכדאי לדעת לגבי חיוב עבור ביצוע קוד:
- מחויבים רק פעם אחת על אסימוני הקלט שמעבירים למודל, ומחויבים על אסימוני הפלט הסופי שהמודל מחזיר.
- אסימונים שמייצגים קוד שנוצר נספרים כאסימוני פלט.
- תוצאות של ביצוע קוד נספרות גם כאסימוני פלט.
מגבלות
- המודל יכול רק ליצור ולהריץ קוד. הוא לא יכול להחזיר ארטיפקטים אחרים, כמו קובצי מדיה.
- התכונה לא תומכת בקלט/פלט של קובץ או בתרחישים לדוגמה שכוללים פלט שאינו טקסט (למשל, תרשימי נתונים).
- ביצוע קוד יכול לפעול עד 30 שניות לפני שהזמן הקצוב יסתיים.
- במקרים מסוימים, הפעלת קוד יכולה להוביל לרגרסיות בתחומים אחרים של פלט המודל (למשל כתיבת סיפור).
- יש הבדלים מסוימים ביכולת של המודלים השונים להשתמש בהצלחה בהפעלת קוד. לפי הבדיקות שלנו, Gemini 1.5 Pro הוא המודל עם הביצועים הכי טובים.