אפשרויות ההגדרה כשניגשים אל Gemini API דרך מסגרת Foundation Models של אפל


בדוגמאות שבדף הזה מניחים שסיימתם את השלב תחילת העבודה: גישה אל Gemini API באמצעות מסגרת Foundation Models של Apple.


בכל בקשה למודל, אפשר לשלוח הגדרות מסוימות כדי לשלוט באופן שבו המודל יוצר תשובה. כל מודל Gemini מציע אפשרויות הגדרה שונות.

בהתאם להגדרה, התצורה נשמרת למשך מחזור החיים של geminiLanguageModel או של LanguageModelSession. אם רוצים להשתמש בהגדרה אחרת, צריך ליצור מודל או סשן חדשים עם ההגדרה הזו.

בדף הזה מתוארות אפשרויות ההגדרה הבאות:

ציון הנחיות מערכת

‫System instructions הן כמו 'מבוא' שמוסיפים לפני שהמודל נחשף להוראות נוספות ממשתמש הקצה. הוא מאפשר לכם לשלוט בהתנהגות של המודל בהתאם לצרכים הספציפיים ולתרחישי השימוש שלכם.

מציינים הוראות למערכת בדף LanguageModelSession:

// ...

// Make sure you initialize your chosen Gemini API backend service
let model = FirebaseAI.firebaseAI().geminiLanguageModel(name: "GEMINI_MODEL_NAME")

// Specify the system instructions as part of creating the session
let session = LanguageModelSession(
    model: model,
    instructions: "You are a cat. Your name is Neko."
)

// ...


הגדרת חשיבה (או "הנמקה")

אתם יכולים להגדיר את כמות החשיבה (נקראת גם הסקה) שמודל Gemini יכול לבצע כדי ליצור את התשובה שלו. פרטים, שיטות מומלצות ותרחישי שימוש בנושא חשיבה מופיעים במדריך הכללי בנושא חשיבה.

במקום רמת ההעמקה, אפל משתמשת ברמת החשיבה הרציונלית. מגדירים את reasoningLevel ב-ContextOptions בכל בקשה באמצעות LanguageModelSession:

// ...

// Make sure you initialize your chosen Gemini API backend service
let model = FirebaseAI.firebaseAI().geminiLanguageModel(name: "GEMINI_MODEL_NAME")

let session = LanguageModelSession(model: model)

// Specify the reasoning level when generating a response
// Possible reasoningLevels: .light, .moderate, .deep, .custom("minimal")
let response = try await session.respond(
  to: "Write a story about a magic backpack.",
  contextOptions: ContextOptions(reasoningLevel: .REASONING_LEVEL)
)

// ...

ערכים נתמכים של רמת ההעמקה

שימו לב לנקודות הבאות:

  • Gemini 3.x המודלים תמיד משתמשים בחשיבה, ואי אפשר להשבית או לבטל את החשיבה במודלים האלה.
  • מודלים של Gemini 3.x תמיד משתמשים בחשיבה דינמית – המודל מחליט מתי וכמה לחשוב, עד לסכום שהוגדר.

בטבלה הבאה מפורטות רמות החשיבה (reasoningLevel) שאפשר להגדיר לכל מודל Gemini. שימו לב: אם משתמשים בערך Gemini (MINIMAL, ‏ LOW, ‏ MEDIUM, ‏ HIGH), הוא ימופה אוטומטית לגרסת Apple של אותו ערך.

‫Apple: .custom("minimal")
Gemini: MINIMAL 		‫Apple: .light
Gemini: LOW 		‫Apple: .moderate
Gemini: MEDIUM 		‫Apple: .deep
Gemini: HIGH

המודל משתמש בכמה שפחות טוקנים; כמעט ללא חשיבה

משימות עם מורכבות נמוכה

המודל משתמש בפחות טוקנים, ומצמצם את זמן האחזור והעלות

משימות פשוטות ומשימות עם נפח נתונים גבוה

המודל משתמש בגישה מאוזנת

משימות ברמת מורכבות בינונית

המודל משתמש בטוקנים עד לרמה המקסימלית שלו

הנחיות מורכבות שדורשות חשיבה מעמיקה

Gemini 3.x Pro
gemini-3.1-pro-preview 		‫ (ברירת מחדל)
Gemini 3.x Flash
gemini-3.5-flash 		‫ (ברירת מחדל)
Gemini 3.x Flash‑Lite
gemini-3.1-flash-lite 		‫ (ברירת מחדל)
Gemini 3.x Pro Image
gemini-3-pro-image
("Nano Banana Pro") 		‫ (ברירת מחדל)
Gemini 3.x Flash Image
gemini-3.1-flash-image
("Nano Banana 2") 		‫ (ברירת מחדל)
Gemini 3.x Flash‑Lite Image
gemini-3.1-flash-lite-image
("Nano Banana 2 Lite") 		‫ (ברירת מחדל)


הגדרת פלט של תמונה


הגדרות כלליות


שליחת משוב על הגישה אל Gemini API דרך מסגרת Foundation Models של Apple