מדריך למפתחים בנושא Gemini 3.8 Flash

‫Gemini 3.8 Flash הוא המודל הכי חכם שלנו עד עכשיו לביצוע משימות שדורשות עבודה קשה. הוא מספק שיפורים משמעותיים לעומת 3.7 Flash בתחומים של הנדסת תוכנה, משימות אג'נטיות וחשיבה רציונלית רב-שלבית קריטית בתחומים מיוחדים. ‫3.8 Flash מציע שיפורים משמעותיים לעומת 3.7 Flash, ולעיתים קרובות מתקרב לביצועים של מודלים פורצי דרך יקרים יותר.

במסמך הזה מוסבר מה חדש ב-‎3.8 Flash, איך הוא משתלב במשפחת מודלי Gemini, איך עוברים ל-‎3.8 Flash ומסופק מדריך למתחילים לשימוש ב-‎3.8 Flash.

איך הוא משתלב במשפחת Gemini?

סדרת Gemini Flash היא המודל העיקרי והמתקדם במשפחת Gemini 3, והיא מגשרת על הפער בין מודלים מסוג Pro עם יכולות חשיבה רציונלית עמוקות לבין מודלים מסוג Gemini Flash-Lite עם יכולת עיבוד גבוהה. בנוסף, היא מספקת יעילות גבוהה של טוקנים ועיבוד רב-שלבי של נתונים מרובי-מוֹדָלִים.

בהשוואה ל-‎3.7 Flash, גרסת ‎3.8 Flash מספקת דיוק טוב יותר וביצועים אמינים יותר, אבל צורכת יותר אסימונים. עם זאת, ב-‎3.8 Flash יש גם אפשרות לשלוט במאמץ באמצעות רמות חשיבה, כדי שתוכלו לווסת את הצריכה הזו. ברמת החשיבה הבינונית, אתם יכולים לפתור משימות מורכבות של סוכנים ועדיין לצרוך פחות טוקנים. אפשר גם להשתמש ברמות חשיבה נמוכות יותר למשימות שרגישות לזמן האחזור, כדי להימנע לחלוטין מתקורה של מחשוב. אם רוצים לבצע אופטימיזציה של יעילות החישוב, כדאי להשתמש ב-3.7 Flash.

מפרטים והשוואות בין מודלים

בטבלה הבאה מוצגת השוואה של חלק מהמפרטים בין 3.8 Flash,‏ 3.7 Flash ו-3.1 Pro:

בדף בנושא מודל Flash 3.8 מופיעה רשימה מלאה של היכולות, הכלים ואפשרויות הצריכה הנתמכים.

מה חדש ב-Gemini 3.8 Flash?

בטבלה הבאה מוצגת השוואה בין מדדי הביצועים של Gemini 3.8 Flash ו-3.7 Flash:

מדריך למתחילים

לפני שמתחילים, צריך לבצע אימות בפלטפורמת הסוכנים באמצעות Application Default Credentials ‏ (ADC) או מפתח API. מידע נוסף זמין במאמר תחילת העבודה עם Gemini Enterprise Agent Platform.

בבלוקי הקוד הבאים, מחליפים את PROJECT_ID במזהה הפרויקט.

התקנה

מוודאים שאתם משתמשים בגרסה העדכנית ביותר של google-genai SDK:

pip install --upgrade google-genai

בקשה בסיסית

from google import genai

client = genai.Client(enterprise=True, project="PROJECT_ID", location="global")

response = client.models.generate_content(
  model="gemini-3.8-flash",
  contents="How does AI work?",
)
print(response.text)

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/global/publishers/google/models/gemini-3.8-flash:generateContent \
-d '{
  "contents": {
    "role": "USER",
    "parts": { "text": "Why is the sky blue?" },
  },
}'

כללי API מחייבים ומוסכמות התנהגותיות

מודל Gemini 3.8 Flash אוכף באופן קפדני את המוסכמות הבאות של Gemini 3 API:

• פרמטרים של דגימה שהוצאו משימוש (temperature, ‏ top_k, ‏ top_p): המערכת מתעלמת מהפרמטרים האלה בקצה העורפי. במקום זאת, אפשר לשלוט בדטרמיניזם באמצעות thinking_level (LOW, ‏MEDIUM, ‏HIGH) ו-response_schema או json_schema.
• פרמטרים לא נתמכים (frequency_penalty, ‏ presence_penalty,‏ candidate_count): העברה של frequency_penalty, ‏ presence_penalty או candidate_count תגרום לשגיאה פעילה ב-API. הסירו אותם מקוד הלקוח הקודם.

• כללים מחמירים לקריאה להפעלת פונקציות: תור של FunctionResponse חייב להתאים באופן מדויק ל-id, ל-name ולמספר ההרצות של ה-FunctionCall הקודם.

  • נכסים מולטי-מודאליים: תמיד צריך למקם נכסים מולטי-מודאליים בתוך מטען הייעודי (payload) של התגובה.
  • עיצוב טקסט והוספת טקסט לפני הכלי: כדי לעצב הוראות מוטבעות, משתמשים בתגית \n\n. אם נתקלתם בשגיאות Malformed_Function_Call שקשורות לטקסט שלפני הקריאה לכלי, נקו את ההערות שלפני הקריאות לכלים.

  • כדי להעביר הערות עבודה או עדכוני סטטוס לפני הפעלת כלי, צריך להוסיף אותם בתוך קריאה ייעודית לפונקציה update() במקום להוציא XML או טקסט גולמיים:

    {
      "name": "update",
      "description": "Update working notes before tool execution",
      "parameters": {
        "type": "OBJECT",
        "properties": {
          "previous_step": {"type": "STRING"},
          "plan": {"type": "STRING"},
          "next_step": {"type": "STRING"}
        },
        "required": ["previous_step", "plan", "next_step"]
      }
    }
    

• אימות רצף הצ'אט:

  • מטעני ההיסטוריה לא יכולים להסתיים בתור של התפקיד "model".
  • תשובות מודל מאוכלסות מראש לא נתמכות וצריך להסיר אותן כשמשדרגים.
  • תורות ריקות בהיסטוריית השיחות נמחקות אוטומטית או יוצרות שגיאות אימות.

‫‎3.8 Flash מ-‎3.7 Flash או מ-‎3.6 Flash

כדי לעבור לגרסה ‎3.8 Flash מגרסה ‎3.7 Flash או ‎3.6 Flash, מבצעים את השלבים הבאים:

1. עדכון מזהה המודל: משנים את מחרוזת המודל בקריאות ל-API ל-gemini-3.8-flash.
2. החלפת הפרמטר של תקציב החשיבה: מחליפים את ההגדרות של המספר השלם thinking_budget ב-enum של המחרוזת thinking_level, שמוגדר לאחד מהערכים הבאים:
   • ‫HIGH: מומלץ לבדיקת איכות חזותית צפופה, לזיהוי תנועה של חלקיקי שנייה (ספורט, עריכה) או לחשיבה רציונלית מרובת שלבים בסרטונים באורך של יותר מ-60 דקות.
   • ‫MEDIUM: רמת ההעמקה שמוגדרת כברירת מחדל. הרמה הזו מספקת איזון אופטימלי לשאלות ותשובות כלליות לגבי סרטונים, סיכום הרצאות ואחזור קליפים.
   • ‫LOW: מומלץ למשימות כמו חיפושים מהירים שמתמקדים בתמליל או חילוץ בסיסי של מטא-נתונים.
3. הסרת פרמטרים שהוצאו משימוש ופרמטרים שלא נתמכים:
   • הסרה של temperature,‏ top_p ו-top_k.
   • הסרה של candidate_count,‏ frequency_penalty ו-presence_penalty.
   • להסיר מהיסטוריית השיחות את כל תשובות המודל המאכלסות מראש.

רשימת משימות מסכמת למפתחים

מקורות מידע נוספים

• דף המודל של Gemini 3.8 Flash
• מחברת מבוא