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. Consente di orientare 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 (o "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 pensiero, consulta la guida generale Pensiero.

Anziché livello di pensiero, Apple utilizza livello di ragionamento. Hai impostato il 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 all'importo configurato.

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.

Configura l'output dell'immagine

Configurazione generale

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