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

‫Gemini 3.7 Flash הוא המודל החכם שלנו למפתחים לשימוש יומיומי. הוא מציע שיפור משמעותי בהנדסת תוכנה, ומספק חוויית פיתוח טובה בהרבה. המודל הזה משפר את היכולות שלכם בתהליכי העבודה היומיומיים, כמו ביצוע משימות מורכבות, מילוי הוראות וקריאות API לכלים.

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

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

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

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

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

Gemini 3.7 Flash ‫Gemini 3.6 Flash Gemini 3.1 Pro
מזהה המודל gemini-3.7-flash gemini-3.6-flash gemini-3.1-pro-preview
שלב ההשקה GA GA תצוגה מקדימה
סוגי קלט טקסט, תמונה, אודיו, וידאו טקסט, תמונה, אודיו, וידאו טקסט, תמונה, אודיו, וידאו
סוגי הפלט טקסט טקסט טקסט
חלון ההקשר 1,048,576 1,048,576 1,048,576
אורך מקסימלי של טוקנים בפלט 65,536 65,536 65,536
אזורים נתמכים גלובלי, במספר אזורים גלובלי, במספר אזורים עולמי
רמות ההעמקה הנתמכות LOW, MEDIUM, HIGH
(ברירת המחדל: MEDIUM) 		‫MINIMAL, LOW, MEDIUM, HIGH
(ברירת המחדל: MEDIUM) 		LOW, MEDIUM, HIGH
(ברירת המחדל: HIGH)
המיקוד העיקרי Agentic workflows, תכנות, הבנת סרטונים אינטראקטיביים Agentic Workflows כלליים, תזמור של כמה שלבים חשיבה מעמיקה, משימות מורכבות מאוד

בדף של מודל ‎3.7 Flash מפורטת הרשימה המלאה של היכולות, הכלים ואפשרויות השימוש הנתמכים.

מה חדש ב-Gemini 3.7 Flash?

בטבלה הבאה מוצגת השוואה בין Gemini 3.7 Flash לבין Gemini 3.6 Flash לפי נקודות השוואה סטנדרטיות להערכת מפתחים:

בנצ'מרק להערכה ‎3.7 Flash ‎3.6 Flash
Terminal-bench 2.1 85.1% 73.0%
DeepSWE 63.7% 49.0%
Humanity's Last Exam (HLE) 45.7% 37.4%
LMArena WebDev 1592 1532

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

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

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

התקנה

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

pip install --upgrade google-genai

בקשה בסיסית

Python

from google import genai

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

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

REST

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.7-flash:generateContent \
-d '{
  "contents": {
    "role": "USER",
    "parts": { "text": "Why is the sky blue?" },
  },
}'

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

‫Gemini 3.7 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 שקשורות לטקסט שלפני הכלי, נקו את ההערות שמופיעות לפני קריאות API לכלי.

    • כדי להעביר הערות עבודה או עדכוני סטטוס לפני קריאת API לכלי, צריך להוסיף אותם לקריאה ייעודית לפונקציה 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.7 Flash מ-‎3.5 Flash או מ-‎3.6 Flash

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

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

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

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