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