התכונה להפעלת קוד ב-Gemini API מאפשרת למודל ליצור ולהפעיל בקוד Python וללמוד באופן איטרטיבי מהתוצאות עד שהוא מגיע הפלט הסופי. היכולת הזו להריץ את הקוד יכולה לשמש לפיתוח אפליקציות שמפיקות חשיבה שמבוססת על קוד ומפיקות פלט טקסט. עבור לדוגמה, אפשר להשתמש בביצוע קוד באפליקציה שפותרת משוואות או לעיבוד טקסט.
ביצוע קוד זמין גם ב-AI Studio וגם ב-Gemini API. ב-AI Studio, יכולים להפעיל את הקוד בקטע הגדרות מתקדמות. ממשק Gemini API מספקת הפעלת קוד ככלי, הפעלת פונקציות. אחרי ההוספה הרצת קוד ככלי, המודל מחליט מתי להשתמש בו.
התחלת העבודה עם ביצוע קוד
![]() |
![]() |
![]() |
הקטע הזה יוצא מנקודת הנחה שהתקנתם Gemini SDK והגדרתם API המקש, כפי שמוצג במדריך למתחילים.
ביצוע קוד לעומת קריאה לפונקציות
הפעלת קוד והפעלת פונקציות תכונות דומות:
- הפעלת קוד מאפשרת למודל להריץ קוד בקצה העורפי של ה-API במיקום קבוע ומבודד הסביבה.
- שליחת פונקציות מאפשרת להריץ את הפונקציות שהמודל מבקש, בכל סביבה שתרצו.
באופן כללי, כדאי להשתמש בביצוע קוד אם הוא יכול להתמודד עם השימוש שלך
מותאמת אישית. קל יותר להשתמש בקוד (פשוט מפעילים אותו) ומופיעה
בקשת GenerateContent
אחת (וכך תחויבו בחיוב יחיד). שימוש
כדי לשלוח חזרה את הפלט של ההתקשרות, נדרשת בקשת GenerateContent
נוספת
מכל בקשה להפעלת פונקציה (וכך תצברו חיובים מרובים).
ברוב המקרים כדאי להשתמש בקריאות פונקציות אם יש לכם פונקציות משלכם שרוצים להריץ באופן מקומי, וצריך להשתמש בהרצת קוד את ה-API כדי לכתוב ולהריץ קוד Python ולהחזיר את התוצאה.
חיוב
אין חיוב נוסף על הפעלה של קוד ההפעלה Gemini API. תחויבו לפי שיעור הקלט והפלט הנוכחי אסימונים.
כמה דברים נוספים שכדאי לדעת לגבי חיוב עבור ביצוע קוד:
- תחויבו רק פעם אחת על אסימוני הקלט שתעבירו למודל, אתם מחויבים על אסימוני הפלט הסופיים שהמודל מחזיר.
- אסימונים שמייצגים קוד שנוצר נספרים כאסימוני פלט.
- תוצאות של ביצוע קוד נספרות גם כאסימוני פלט.
מגבלות
- המודל יכול רק ליצור ולהריץ קוד. הוא לא יכול להחזיר פריטי מידע אחרים שנוצרו בתהליך הפיתוח (Artifact) למשל קובצי מדיה.
- התכונה לא תומכת בקלט/פלט של קובץ או בתרחישים לדוגמה שכוללים פלט שאינו טקסט (לדוגמה, תרשימי נתונים או העלאת קובץ CSV).
- ביצוע קוד יכול לפעול עד 30 שניות לפני שהזמן הקצוב יסתיים.
- במקרים מסוימים, הפעלת קוד יכולה להוביל לרגרסיות באזורים אחרים של הפלט של המודל (לדוגמה, כתיבת סיפור).
- יש הבדלים מסוימים ביכולת של המודלים השונים להשתמש בקוד ההפעלה הושלמה בהצלחה. Gemini 1.5 Pro הוא עם הביצועים הכי טובים מבוסס על הבדיקה שלנו.