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