گزینه‌های پیکربندی هنگام دسترسی به Gemini API ازطریق چارچوب «مدل‌های پایه» Apple

در هر درخواست به مدل، می‌توانید برخی‌از تنظیمات پیکربندی را برای کنترل نحوه تولید پاسخ توسط مدل ارسال کنید. هر مدل Gemini گزینه‌های پیکربندی متفاوتی ارائه می‌دهد.

بسته به تنظیم، پیکربندی برای طول عمر geminiLanguageModel یا LanguageModelSession حفظ می‌شود. اگر می‌خواهید از پیکربندی دیگری استفاده کنید، مدل یا جلسه جدیدی با آن پیکربندی ایجاد کنید.

این صفحه گزینه‌های پیکربندی زیر را شرح می‌دهد:

• دستورالعمل‌های سیستم
• تفکر (یا «استدلال»)
• برونداد تصویر تولیدشده
• پیکربندی عمومی

دستورالعمل‌های سیستم را مشخص کنید

دستورالعمل‌های سیستم مانند «مقدمه‌ای» است که قبل‌از اینکه مدل درمعرض دستورالعمل‌های بیشتر از کاربر نهایی قرار بگیرد، اضافه می‌کنید. این ویژگی به شما امکان می‌دهد رفتار مدل را براساس نیازها و موارد استفاده خاص خودتان هدایت کنید.

دستورالعمل‌های سیستم را در 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 می‌تواند برای تولید پاسخ خود انجام دهد پیکربندی کنید. برای جزئیات، روال‌های مطلوب، و موارد استفاده از «اندیشگر»، به راهنمای عمومی اندیشگر مراجعه کنید.

به‌جای سطح اندیشیدن، Apple از سطح استدلال استفاده می‌کند. 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-3.8-flash و gemini-3.7-flash از سطح تفکر MINIMAL پشتیبانی نمی‌کنند. اگر سطح تفکر را روی MINIMAL تنظیم کنید، درخواست با خطای ۴۰۰ ناموفق خواهد بود.}

پیکربندی برونداد تصویر

پیکربندی عمومی

ارائه بازخورد درباره دسترسی به Gemini API ازطریق چارچوب «مدل‌های پایه» Apple