איך מתחילים להשתמש ב-Gemini 4

מודל Gemini 4 הראשון הוא Gemini 4 Argon (gemini-4-argon), מודל פורץ דרך של Google שמצטיין בעבודה מעמיקה במשימות מורכבות בעולם האמיתי בתחומים שונים, כולל תכנות, פיננסים, משפטים, אבטחת סייבר ומדע.

במדריך הזה מוסבר איך לשלוח את הבקשה הראשונה ל-Gemini 4, מה חדש ב-Gemini 4 ומה משתנה כשעוברים מ-Gemini 3.1 Pro. פרטים ספציפיים לדגם מופיעים במדריך למפתחים בנושא Gemini 4 Argon.

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

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

התקנה של Google Gen AI SDK

משדרגים לגרסה העדכנית של google-genai SDK (>= 2.30.0 ל-Python):

pip install --upgrade "google-genai>=2.30.0"

הגדרה של משתני סביבה

מחליפים את GOOGLE_CLOUD_PROJECT במזהה הפרויקט ב- Google Cloud . ‫Gemini 4 Argon זמין בנקודת הקצה global ובאזורים המרובים us ו-eu:

export GOOGLE_CLOUD_PROJECT=GOOGLE_CLOUD_PROJECT
export GOOGLE_CLOUD_LOCATION=global
export GOOGLE_GENAI_USE_ENTERPRISE=True

שליחת הבקשה הראשונה

Python

from google import genai

client = genai.Client()

response = client.models.generate_content(
    model="gemini-4-argon",
    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-4-argon:generateContent \
-d '{
  "contents": {
    "role": "USER",
    "parts": { "text": "How does AI work?" }
  }
}'

מה חדש ב-Gemini 4

מגבלות על חלון ההקשר ועל הפלט

חלון ההקשר של 1,048,576 טוקנים משותף בין טוקנים של קלט, חשיבה ופלט. כברירת מחדל, בקשה סנכרונית אחת יוצרת עד 65,536 טוקנים של חשיבה ופלט (או 32,768 טוקנים לבקשות HTTP ישירות ללא סטרימינג).

פענוח ארוך

אם תור אחד דורש יותר מ-65,536 (או 32,768 עבור קריאות HTTP ישירות שאינן סטרימינג) של טוקנים של פלט וטוקנים של חשיבה – כמו הוכחות פורמליות, בעיות מורכבות במתמטיקה או במדעים, או יצירת קוד של כמה קבצים – Gemini 4 Argon תומך בפענוחים ארוכים של עד 1,048,576 טוקנים ב-GenerateContent (generateContent ו-streamGenerateContent). באמצעות ה-Google Gen AI SDK העדכני (google-genai >= 2.30.1 ל-Python), הגדרה של max_output_tokens כערך שגדול מ-65,536 תגרום אוטומטית לשימוש ב-continuation_token בכל הבקשות כדי להחזיר תגובה אחת או סטרימינג. עבור קריאות REST ישירות, צריך להעביר את continuation_token מכל תגובת CONTINUATION בבקשה הבאה עם אותה הנחיה.

דוגמאות קוד, דרישות לגבי גרסת ה-SDK וכללי הטמעה מפורטים בקטע פענוחים ארוכים במדריך למפתחים של Gemini 4 Argon.

רמות ההעמקה

אפשר להשתמש ב-thinking_level כדי לקבוע כמה המודל ינתח את ההנחיה לפני שהוא ישיב. ‫Gemini 4 Argon תומך ב-LOW, ב-MEDIUM (ברירת מחדל ב-gemini-4-argon) וב-HIGH (ברירת מחדל ב-gemini-4-argon-cyber-permissive):

from google import genai
from google.genai import types

client = genai.Client()

response = client.models.generate_content(
    model="gemini-4-argon",
    contents="Design a lock-free ring buffer in Rust for multi-producer, single-consumer telemetry ingestion.",
    config=types.GenerateContentConfig(
        thinking_config=types.ThinkingConfig(
            thinking_level=types.ThinkingLevel.HIGH,
        ),
    ),
)
print(response.text)

שמירת הקשר במטמון באופן מרומז

‫Gemini 4 Argon תומך בשמירה מרומזת במטמון של קידומות משותפות להנחיות של 6,144 טוקנים ומעלה, עם שמירה במטמון לטווח ארוך שמופעלת כברירת מחדל. כדי להפיק ממנו תועלת, כדאי להוסיף תוכן סטטי, כמו מאגר המקורות של הקוד או מסמכים ארוכים, בתחילת ההנחיה.

הבנת סרטונים באמצעות סוכנים

התכונה הבנת סרטונים באמצעות סוכנים זמינה לכלל המשתמשים. האפשרות הזו מושבתת כברירת מחדל: סרטונים שהועלו משתמשים ב-media_processing="static". כדי להפעיל אותה, מגדירים את media_processing לערך "agentic".

פרמטרים של דגימה

‫Gemini 4 Argon מתעלם מערכים מותאמים אישית של temperature, top_p ו-top_k, כמו במודלים האחרונים של Gemini 3. כדי לשלוט בפלט, צריך להשתמש ב-thinking_level ובפלט מובנה (response_schema).

מעבר מ-Gemini 3.1 Pro

מומלץ לעבור מ-gemini-3.1-pro-preview אל gemini-4-argon. ההתנהגות הבאה שונה ב-Gemini 4 Argon:

אזור ‫Gemini 3.1 Pro ‫Gemini 4 Argon מה לעשות?
מגבלות על חלון ההקשר ועל הפלט מגבלות נפרדות לקלט (מיליון) ולפלט (65,535) חלון אחד של 1,048,576 טוקנים שמשותף לקלט, לחשיבה ולפלט. מגבלת ברירת המחדל לפלט של בקשה אחת היא 65,536 טוקנים (32,768 טוקנים לבקשות HTTP ישירות ללא סטרימינג), ואפשר להרחיב אותה עד ל-1,048,576 טוקנים באמצעות פענוחים ארוכים. הקלט והפלט של התקציב ביחד. משדרגים לגרסה העדכנית של Google Gen AI SDK ומגדירים את max_output_tokens לערך שגדול מ-65,536 (או משתמשים ב-continuation_token בלולאות GenerateContent בהתאמה אישית) כדי לקבל פלט שחורג מהמגבלה לבקשה אחת.
thinking_budget מיפוי לרמת חשיבה מחזירה שגיאת HTTP 400 שימוש ב-thinking_level.
thinking_level="MINIMAL" נתמך הפונקציה מחזירה שגיאת HTTP 400 שימוש ב-LOW.
שמירת הקשר במטמון באופן מפורש נתמך לא נתמך מסירים הפניות ל-cached_content ומציבים תוכן סטטי (6,144 טוקנים או יותר) בתחילת ההנחיות.
חיוב על טוקנים חיוב על קבוצת משנה של טוקנים כל אסימון שהמודל מעבד מחויב, כולל טוקנים של חשיבה והוראות מערכת פנימיות של כלי והצהרות פונקציות כשמשתמשים בעיגון. החיוב על עיגון באמצעות חיפוש Google עדיין מתבצע לפי שאילתה. בודקים את העלויות המשוערות.

כדי להעביר את הנתונים:

  1. צריך לשנות את מזהה המודל ל-gemini-4-argon ולשדרג לגרסה העדכנית של Google Gen AI SDK (google-genai >= 2.30.1 ל-Python).
  2. צריך לקחת בחשבון את חלון ההקשר המשותף של 1,048,576 טוקנים ואת המגבלה על הפלט של בקשה יחידה של 65,536 טוקנים (או 32,768 טוקנים ב-HTTP ישיר ללא סטרימינג) (או להגדיר פענוח ארוך לפלט גדול יותר ב-GenerateContent).
  3. מחליפים את thinking_budget ואת thinking_level="MINIMAL" ב-thinking_level שמוגדר ל-LOW, ל-MEDIUM או ל-HIGH.
  4. הסרה של הפניות מפורשות ל-cached_content.
  5. מסירים את temperature,‏ top_p ו-top_k, כי הם לא משפיעים.

‫Gemini 4 Argon Cyber Permissive

‫Gemini 4 Argon Cyber Permissive הוא גרסה של Gemini 4 Argon לתרחישי שימוש הגנתיים בתחום אבטחת הסייבר, והוא זמין מאחורי רשימת היתרים. למידע על ההבדלים ועל הגישה, אפשר לעיין במאמר בנושא Gemini 4 Argon Cyber Permissive.

המאמרים הבאים