Opsi konfigurasi saat mengakses Gemini API melalui framework Model Dasar Apple

Dalam setiap permintaan ke model, Anda dapat mengirimkan beberapa setelan konfigurasi untuk mengontrol cara model membuat respons. Setiap Gemini model menawarkan opsi konfigurasi yang berbeda.

Bergantung pada setelannya, konfigurasi dipertahankan selama masa aktif geminiLanguageModel atau LanguageModelSession. Jika ingin menggunakan konfigurasi yang berbeda, buat model atau sesi baru dengan konfigurasi tersebut.

Halaman ini menjelaskan opsi konfigurasi berikut:

• Petunjuk sistem
• Pemikiran (alias "penalaran")
• Output gambar yang dihasilkan
• Konfigurasi umum

Menentukan petunjuk sistem

Petunjuk sistem ini seperti "preamble" yang Anda tambahkan sebelum model diekspos ke petunjuk lebih lanjut dari pengguna akhir. Petunjuk ini memungkinkan Anda mengarahkan perilaku model berdasarkan kebutuhan dan kasus penggunaan tertentu.

Tentukan petunjuk sistem di 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."
)

// ...

Mengonfigurasi pemikiran (alias "penalaran")

Anda dapat mengonfigurasi jumlah pemikiran (juga disebut penalaran) yang dapat dilakukan model Gemini untuk membuat responsnya. Untuk mengetahui detail, praktik terbaik, dan kasus penggunaan pemikiran, lihat panduan umum Pemikiran.

Daripada tingkat pemikiran, Apple menggunakan tingkat penalaran. Anda menetapkan reasoningLevel di ContextOptions pada setiap permintaan melalui 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)
)

// ...

Nilai tingkat pemikiran yang didukung

Perhatikan hal berikut:

• Model Gemini 3.x selalu menggunakan pemikiran; Anda tidak dapat menonaktifkan atau mematikan pemikiran untuk model ini.
• Model Gemini 3.x selalu menggunakan pemikiran dinamis – model akan memutuskan kapan dan berapa banyak pemikiran yang akan dilakukan hingga jumlah yang dikonfigurasi.

Tabel berikut mencantumkan tingkat pemikiran (reasoningLevel) yang dapat Anda tetapkan untuk setiap Gemini model. Perhatikan bahwa jika Anda menggunakan nilai Gemini(MINIMAL, LOW, MEDIUM, HIGH), nilai tersebut akan otomatis dipetakan ke versi Apple dari nilai tersebut.

Mengonfigurasi output gambar

Konfigurasi umum

Berikan masukan tentang cara mengakses Gemini API melalui framework Foundation Models Apple