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

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

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

پیکربندی خروجی تصویر

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

در مورد دسترسی به API Gemini از طریق چارچوب مدل‌های بنیادی اپل، بازخورد خود را ارائه دهید.