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

Anteprima: l'utilizzo di Firebase AI Logic per accedere all' Gemini API tramite il framework Foundation Models di Apple è attualmente in anteprima pubblica, il che significa che non è soggetto a SLA o norme sul ritiro e potrebbe cambiare in modi incompatibili con le versioni precedenti.
Inoltre, questa integrazione si basa su API beta, pertanto le app che la utilizzano non possono essere inviate all'App Store finché la prossima versione di Xcode non raggiunge la disponibilità generale (GA) e supporta gli invii di produzione.

Gli esempi riportati in questa pagina presuppongono che tu abbia completato la sezione Inizia: accedi all'Gemini API 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 opzioni di configurazione diverse.

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 (detto anche "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 consentono di orientare il comportamento del modello in base alle tue esigenze e ai tuoi casi d'uso specifici.

Specifica le istruzioni di sistema in 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 (detto anche "ragionamento")

Puoi configurare la quantità di pensiero (detto anche ragionamento) che un Gemini modello può eseguire per generare la risposta. Per dettagli, best practice e casi d'uso del pensiero, consulta la guida generale Pensiero.

Anziché livello di pensiero, Apple utilizza livello di ragionamento. Imposta reasoningLevel in ContextOptions su ogni richiesta tramite 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 del livello di pensiero supportati

Tieni presente quanto segue:

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

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

	Apple: .custom("minimal") Gemini: MINIMAL	Apple: .light Gemini: LOW	Apple: .moderate Gemini: MEDIUM	Apple: .deep Gemini: HIGH
	Il modello utilizza il minor numero possibile di token; quasi nessun pensiero Attività a bassa complessità	Il modello utilizza meno token; riduce al minimo la latenza e i costi Attività semplici e attività a elevata velocità effettiva	Il modello utilizza un approccio bilanciato Attività di complessità moderata	Il modello utilizza i token fino al livello massimo Prompt complessi che richiedono un ragionamento approfondito
Gemini 3.x Pro gemini-3.1-pro-preview				(valore predefinito)
Gemini 3.x Flash gemini-3.5-flash			(valore predefinito)
Gemini 3.x Flash‑Lite gemini-3.1-flash-lite	(valore predefinito)
Gemini 3.x Pro Image gemini-3-pro-image ("Nano Banana Pro")				(valore predefinito)
Gemini 3.x Flash Image gemini-3.1-flash-image ("Nano Banana 2")				(valore predefinito)
Gemini 3.x Flash‑Lite Image gemini-3.1-flash-lite-image ("Nano Banana 2 Lite")	(valore predefinito)

Nota: i modelli Gemini supportano anche i riepiloghi dei pensieri. A breve saranno disponibili esempi di questa funzionalità utilizzando il framework Foundation Models di Apple.

---

Configurare l'output delle immagini

Nota: Gemini i modelli di generazione di immagini (come i modelli "Nano Banana") supportano la configurazione dell'output delle immagini per le proporzioni e le dimensioni delle immagini. A breve saranno disponibili esempi di questa funzionalità utilizzando il framework Foundation Models di Apple.

---

Configurazione generale

Nota: i modelli Gemini supportano la configurazione generale, ad esempio l'impostazione del numero massimo di token di output e del numero di varianti di risposta generate. A breve saranno disponibili esempi di questa funzionalità utilizzando il framework Foundation Models di Apple.

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