Apple'ın Foundation Models çerçevesi aracılığıyla Gemini API'ye erişirken yapılandırma seçenekleri

Bir modele gönderdiğiniz her istekle birlikte, modelin nasıl yanıt üreteceğini kontrol etmek için bazı yapılandırma ayarları gönderebilirsiniz. Her Gemini modeli farklı yapılandırma seçenekleri sunar.

Ayara bağlı olarak yapılandırma, geminiLanguageModel veya LanguageModelSession'nin kullanım ömrü boyunca korunur. Farklı bir yapılandırma kullanmak istiyorsanız bu yapılandırmayla yeni bir model veya oturum oluşturun.

Sayfada aşağıdaki yapılandırma seçenekleri açıklanmaktadır:

• Sistem talimatları
• Düşünme (diğer adıyla "akıl yürütme")
• Üretilen görüntü çıktısı
• Genel yapılandırma

Sistem talimatlarını belirtme

Sistem talimatları, modelin son kullanıcıdan başka talimatlar almadan önce eklediğiniz bir "giriş" gibidir. Bu sayede, modelin davranışını özel ihtiyaçlarınıza ve kullanım alanlarınıza göre yönlendirebilirsiniz.

LanguageModelSession üzerinde sistem talimatlarını belirtin:

// ...

// 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."
)

// ...

Düşünme (diğer adıyla "akıl yürütme") yapılandırması

Gemini modelinin yanıtını oluşturmak için yapabileceği düşünme (akıl yürütme olarak da bilinir) miktarını yapılandırabilirsiniz. Düşünmeyle ilgili ayrıntılar, en iyi uygulamalar ve kullanım alanları için genel Düşünme kılavuzuna bakın.

Apple, düşünme düzeyi yerine akıl yürütme düzeyi kullanır. Her istekte reasoningLevel değerini ContextOptions içinde bir LanguageModelSession aracılığıyla ayarlarsınız:

// ...

// 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)
)

// ...

Desteklenen düşünme düzeyi değerleri

Aşağıdakileri göz önünde bulundurun:

• Gemini 3.x modelleri her zaman düşünme özelliğini kullanır. Bu modellerde düşünme özelliğini devre dışı bırakamazsınız.
• Gemini 3.x modelleri her zaman dinamik düşünme özelliğini kullanır. Model, yapılandırılan miktara kadar ne zaman ve ne kadar düşüneceğine karar verir.

Aşağıdaki tabloda, her Gemini modeli için ayarlayabileceğiniz düşünme seviyeleri (reasoningLevel) listelenmiştir. Gemini değeri (MINIMAL, LOW, MEDIUM, HIGH) kullanırsanız bu değerin Apple sürümüyle otomatik olarak eşleneceğini unutmayın.

Görüntü çıkışını yapılandırma

Genel yapılandırma

Apple'ın Foundation Models çerçevesi aracılığıyla Gemini API'a erişim hakkında geri bildirimde bulunma