خيارات الإعداد عند الوصول إلى واجهة برمجة التطبيقات Gemini من خلال إطار عمل Foundation Models من Apple


تفترض الأمثلة الواردة في هذه الصفحة أنّك أكملت مقالة البدء: الوصول إلى Gemini API من خلال إطار عمل Apple's Foundation Models.


في كل طلب يتم إرساله إلى نموذج، يمكنك إرسال بعض إعدادات الضبط للتحكّم في طريقة إنشاء النموذج للرد. يقدّم كل نموذج 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 استخدامه لإنشاء ردّه. لمعرفة التفاصيل وأفضل الممارسات وحالات استخدام التفكير، يمكنك الاطّلاع على دليل التفكير العام Thinking.

بدلاً من مستوى التفكير، تستخدم 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 من هذه القيمة.

‫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 من خلال إطار عمل Apple's Foundation Models