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

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

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

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

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

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

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

מציינים הוראות למערכת בדף 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 של אותו ערך.

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

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

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