خيارات الإعداد عند الوصول إلى واجهة برمجة التطبيقات Gemini من خلال إطار عمل Foundation Models من 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 من تلك القيمة.

^{1 لا تتوافق gemini-3.8-flash وgemini-3.7-flash مع مستوى التفكير MINIMAL. إذا ضبطت مستوى التفكير على MINIMAL، سيتعذّر تنفيذ الطلب وسيظهر الخطأ 400.}

ضبط إعدادات إخراج الصور

الإعدادات العامة

تقديم ملاحظات حول الوصول إلى Gemini API من خلال إطار عمل "النماذج الأساسية" من Apple