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

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

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

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