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 menghasilkan respons. Setiap model Gemini menawarkan opsi konfigurasi yang berbeda.

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

Halaman ini menjelaskan opsi konfigurasi berikut:

• Petunjuk sistem
• Penalaran (alias "reasoning")
• Output gambar generatif
• Konfigurasi umum

Menentukan petunjuk sistem

Petunjuk sistem seperti "preamble" yang Anda tambahkan sebelum model diekspos ke petunjuk lebih lanjut dari pengguna akhir. Dengan begitu, Anda dapat mengarahkan perilaku model berdasarkan kebutuhan dan kasus penggunaan spesifik Anda.

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 menghasilkan responsnya. Untuk mengetahui detail, praktik terbaik, dan kasus penggunaan untuk penalaran, lihat panduan Penalaran umum.

Apple menggunakan tingkat penalaran, bukan tingkat pemikiran. 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 penalaran 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 memutuskan kapan dan berapa banyak ia berpikir hingga jumlah yang dikonfigurasi.

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

^{1 gemini-3.8-flash dan gemini-3.7-flash tidak mendukung tingkat pemikiran MINIMAL. Jika Anda menetapkan tingkat pemikiran ke MINIMAL, permintaan akan gagal dengan error 400.}

Mengonfigurasi output gambar

Konfigurasi umum

Memberikan masukan tentang cara mengakses Gemini API melalui framework Model Dasar Apple