Opzioni di configurazione quando si accede all'API Gemini tramite il framework Foundation Models di Apple

In ogni richiesta a un modello, puoi inviare alcune impostazioni di configurazione per controllare il modo in cui il modello genera una risposta. Ogni modello Gemini offre diverse opzioni di configurazione.

A seconda dell'impostazione, la configurazione viene mantenuta per la durata di geminiLanguageModel o LanguageModelSession. Se vuoi utilizzare una configurazione diversa, crea un nuovo modello o una nuova sessione con quella configurazione.

La pagina descrive le seguenti opzioni di configurazione:

• Istruzioni di sistema
• Pensiero (o "ragionamento")
• Output delle immagini generate
• Configurazione generale

Specificare le istruzioni di sistema

Le istruzioni di sistema sono come un "preambolo" che aggiungi prima che il modello venga esposto a ulteriori istruzioni dell'utente finale. Ti consente di controllare il comportamento del modello in base alle tue esigenze e ai tuoi casi d'uso specifici.

Specifica le istruzioni di sistema su 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."
)

// ...

Configurare il pensiero (ovvero il "ragionamento")

Puoi configurare la quantità di ragionamento che un modello Gemini può fare per generare la sua risposta. Per dettagli, best practice e casi d'uso per il ragionamento, consulta la guida generale Ragionamento.

Anziché livello di ragionamento, Apple utilizza livello di ragionamento. Hai impostato reasoningLevel in ContextOptions su ogni richiesta tramite un 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)
)

// ...

Valori supportati per il livello di ragionamento

Tieni presente quanto segue:

• I modelli Gemini 3.x utilizzano sempre il pensiero; non puoi disattivare o disabilitare il pensiero per questi modelli.
• I modelli Gemini 3.x utilizzano sempre il pensiero dinamico: il modello decide quando e quanto pensare fino alla quantità configurata.

La tabella seguente elenca i livelli di pensiero (reasoningLevel) che puoi impostare per ogni modello Gemini. Tieni presente che se utilizzi un valore Gemini (MINIMAL, LOW, MEDIUM, HIGH), questo verrà mappato automaticamente alla versione Apple di quel valore.

^{1 gemini-3.8-flash e gemini-3.7-flash non supportano il livello di ragionamento MINIMAL. Se imposti il livello di pensiero su MINIMAL, la richiesta non andrà a buon fine e verrà visualizzato un errore 400.}

Configura l'output dell'immagine

Configurazione generale

Fornisci feedback sull'accesso a Gemini API tramite il framework Foundation Models di Apple