Options de configuration lorsque vous accédez à l'API Gemini via le framework Foundation Models d'Apple

Dans chaque requête adressée à un modèle, vous pouvez envoyer des paramètres de configuration pour contrôler la manière dont le modèle génère une réponse. Chaque Gemini modèle propose différentes options de configuration.

Selon le paramètre, la configuration est conservée pendant la durée de vie de geminiLanguageModel ou de LanguageModelSession. Si vous souhaitez utiliser une configuration différente, créez un modèle ou une session avec cette configuration.

Cette page décrit les options de configuration suivantes :

• Instructions système
• Réflexion (ou "raisonnement")
• Sortie d'image générée
• Configuration générale

Spécifier des instructions système

Les instructions système sont comme un "préambule" que vous ajoutez avant que le modèle ne soit exposé à d'autres instructions de l'utilisateur final. Elles vous permettent d'orienter le comportement du modèle en fonction de vos besoins et cas d'utilisation spécifiques.

Spécifiez des instructions système sur 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."
)

// ...

Configurer la réflexion (ou "raisonnement")

Vous pouvez configurer le niveau de réflexion (également appelé raisonnement) qu'un Gemini modèle peut effectuer pour générer sa réponse. Pour en savoir plus, découvrir les bonnes pratiques et consulter des cas d'utilisation concernant la réflexion, consultez le guide général sur la réflexion.

Au lieu de niveau de réflexion, Apple utilise niveau de raisonnement. Vous définissez reasoningLevel dans ContextOptions pour chaque requête via une 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)
)

// ...

Valeurs de niveau de réflexion acceptées

Veuillez noter les points suivants :

• Les modèles Gemini 3.x utilisent toujours la réflexion. Vous ne pouvez pas la désactiver ou l' arrêter pour ces modèles.
• Les modèles Gemini 3.x utilisent toujours la réflexion dynamique : le modèle décide quand et dans quelle mesure il réfléchit, jusqu'à la quantité configurée.

Le tableau suivant répertorie les niveaux de réflexion (reasoningLevel) que vous pouvez définir pour chaque Gemini modèle. Notez que si vous utilisez une Gemini valeur (MINIMAL, LOW, MEDIUM, HIGH), elle sera automatiquement mappée à la version Apple de cette valeur.

^{1 gemini-3.7-flash n'est pas compatible avec le niveau de réflexion MINIMAL. Si vous définissez le niveau de réflexion sur MINIMAL, la requête échouera avec une erreur 400.}

Configurer la sortie d'image

Configuration générale

Envoyer des commentaires sur l'accès à l'Gemini API via le framework Foundation Models d'Apple