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

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

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

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

• הוראות מערכת
• חשיבה (נקראת גם 'הנמקה')
• פלט של תמונות שנוצרו על ידי AI
• הגדרה כללית

ציון הוראות למערכת

‫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 של אותו ערך.

‫^{1 gemini-3.8-flash ו-gemini-3.7-flash לא תומכים ברמת החשיבה MINIMAL. אם תגדירו את רמת החשיבה ל-MINIMAL, הבקשה תיכשל ותוצג שגיאה 400.}

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

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

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