התכונה 'הרצת קוד ב-Gemini API' מאפשרת למודל ליצור ולהריץ קוד Python, וללמוד באופן איטרטיבי מהתוצאות עד שהוא מגיע לפלט הסופי. אפשר להשתמש ביכולת הזו להרצת קוד כדי ליצור אפליקציות שמפיקות פלט טקסט ומנצלות את היתרונות של ניתוח מבוסס-קוד. לדוגמה, אפשר להשתמש בהרצת קוד באפליקציה שמחשבת משוואות או מעבדת טקסט.
אפשר להריץ קוד גם ב-AI Studio וגם ב-Gemini API. ב-AI Studio, אפשר להפעיל את ביצוע הקוד בחלונית השמאלית בקטע Tools. Gemini API מספק הפעלת קוד ככלי, בדומה לקריאה לפונקציה. אחרי שמוסיפים את הכלי 'הרצת קוד', המודל מחליט מתי להשתמש בו.
סביבת ביצוע הקוד כוללת את הספריות הבאות:
altair, chess, cv2, matplotlib, mpmath, numpy, pandas,
pdfminer, reportlab, seaborn, sklearn, statsmodels, striprtf,
sympy ו-tabulate. אי אפשר להתקין ספריות משלכם.
תחילת העבודה עם ביצוע קוד
בקטע הזה נניח שהשלמתם את שלבי ההגדרה וההתאמה אישית שמפורטים במדריך למתחילים.
קלט/פלט (I/O)
החל מ-Gemini 2.0 Flash, ביצוע הקוד תומך בקלט של קבצים ובפלט של גרפים. בעזרת יכולות הקלט והפלט החדשות האלה, תוכלו להעלות קובצי CSV וקובצי טקסט, לשאול שאלות על הקבצים וליצור תרשים Matplotlib כחלק מהתגובה.
תמחור של קלט/פלט
כשמשתמשים בקלט/פלט של ביצוע קוד, אתם מחויבים על אסימוני קלט ואסימוני פלט:
טוקני קלט:
- הנחיה למשתמש
אסימוני פלט:
- קוד שנוצר על ידי המודל
- פלט של ביצוע קוד בסביבת הקוד
- סיכום שנוצר על ידי המודל
פרטי קלט/פלט
כשעובדים עם קלט/פלט של ביצוע קוד, חשוב לשים לב לפרטים הטכניים הבאים:
- זמן הריצה המקסימלי של סביבת הקוד הוא 30 שניות.
- אם סביבת הקוד יוצרת שגיאה, יכול להיות שהמודל יחליט ליצור מחדש את פלט הקוד. אפשר לעשות זאת עד 5 פעמים.
- גודל הקלט המקסימלי של הקובץ מוגבל על ידי חלון אסימון המודל. ב-AI Studio, באמצעות Gemini Flash 2.0, גודל הקובץ המקסימלי של הקלט הוא מיליון טוקנים (כ-2MB לקובצי טקסט מסוגים נתמכים של קלט). אם תעלו קובץ גדול מדי, לא תוכלו לשלוח אותו ב-AI Studio.
| פנייה אחת | דו-כיווני (Multimodal Live API) | |
|---|---|---|
| מודלים נתמכים | כל הדגמים של Gemini 2.0 | רק מודלים ניסיוניים של Flash |
| סוגי הקלט של קבצים שנתמכים | .png, .jpeg, .csv, .xml, .cpp, .java, .py, .js, .ts | .png, .jpeg, .csv, .xml, .cpp, .java, .py, .js, .ts |
| ספריות ליצירת תרשימים נתמכות | Matplotlib | Matplotlib |
| שימוש במכשיר רב-כלי | לא | כן |
חיוב
אין חיוב נוסף על הפעלת קוד מ-Gemini API. החיוב יתבצע לפי התעריף הנוכחי של אסימוני הקלט והפלט, בהתאם למודל Gemini שבו אתם משתמשים.
ריכזנו כאן כמה דברים נוספים שכדאי לדעת על החיוב על ביצוע קוד:
- אתם מחויבים רק פעם אחת על טוקני הקלט שאתם מעבירים למודל, ועל טוקני הפלט הסופיים שהמודל מחזיר לכם.
- אסימונים שמייצגים קוד שנוצר נספרים כאסימוני פלט. הקוד שנוצר יכול לכלול טקסט ופלט רב-מודלי כמו תמונות.
- גם תוצאות של הרצת קוד נספרות כאסימוני פלט.
מודל החיוב מוצג בתרשים הבא:
- החיוב מתבצע לפי התעריף הנוכחי של אסימוני הקלט והפלט, בהתאם למודל Gemini שבו אתם משתמשים.
- אם Gemini משתמש בהרצת קוד כדי ליצור את התשובה, ההנחיה המקורית, הקוד שנוצר והתוצאה של הקוד שהופעל מסומנים בתור אסימונים ביניים ומחויבים בתור אסימוני קלט.
- לאחר מכן, Gemini יוצר סיכום ומחזיר את הקוד שנוצר, את התוצאה של הקוד שהופעל ואת הסיכום הסופי. הם מחויבים כאסימוני פלט.
- ה-Gemini API כולל ספירת אסימונים ביניים בתגובה של ה-API, כדי שתוכלו לדעת למה אתם מקבלים אסימוני קלט נוספים מעבר להנחיה הראשונית.
מגבלות
- המודל יכול ליצור ולבצע קוד בלבד. לא ניתן להחזיר ארטיפקטים אחרים, כמו קובצי מדיה.
- במקרים מסוימים, הפעלת ביצוע הקוד יכולה להוביל לנסיגה באזורים אחרים של פלט המודל (לדוגמה, כתיבת סטורי).
- יש הבדלים מסוימים ביכולת של המודלים השונים להשתמש בהרצת קוד בצורה מוצלחת.