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