Opciones de configuración cuando se accede a la API de Gemini a través del framework de modelos de base de Apple

En cada solicitud a un modelo, puedes enviar algunos parámetros de configuración para controlar cómo el modelo genera una respuesta. Cada modelo de Gemini ofrece diferentes opciones de configuración.

Según la configuración, esta se mantiene durante la vida útil de geminiLanguageModel o LanguageModelSession. Si quieres usar una configuración diferente, crea un modelo o una sesión nuevos con esa configuración.

En la página, se describen las siguientes opciones de configuración:

• Instrucciones del sistema
• Pensamiento (también conocido como "razonamiento")
• Salida de imagen generada
• Configuración general

Especifica las instrucciones del sistema

Las instrucciones del sistema son como un "preámbulo" que agregas antes de que el modelo se exponga a otras instrucciones del usuario final. Te permite dirigir el comportamiento del modelo según tus necesidades y casos de uso específicos.

Especifica las instrucciones del sistema en 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."
)

// ...

Configura el pensamiento (también conocido como "razonamiento")

Puedes configurar la cantidad de pensamiento (también llamado razonamiento) que puede realizar un Gemini modelo para generar su respuesta. Para obtener detalles, prácticas recomendadas y casos de uso para el pensamiento, consulta la guía general de pensamiento.

En lugar de nivel de pensamiento, Apple usa nivel de razonamiento. Establece reasoningLevel en ContextOptions en cada solicitud a través de 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)
)

// ...

Valores admitidos del nivel de pensamiento

Ten en cuenta lo siguiente:

• Los modelos Gemini 3.x siempre usan el pensamiento; no puedes inhabilitar ni desactivar el pensamiento para estos modelos.
• Los modelos Gemini 3.x siempre usan el pensamiento dinámico : el modelo decide cuándo y cuánto piensa hasta la cantidad configurada.

En la siguiente tabla, se enumeran los niveles de pensamiento (reasoningLevel) que puedes establecer para cada modelo Gemini. Ten en cuenta que, si usas un valor Gemini (MINIMAL, LOW, MEDIUM, HIGH), se asignará automáticamente a la versión de Apple de ese valor.

Configura la salida de la imagen

Configuración general

Envía comentarios sobre el acceso a la Gemini API a través del framework Foundation Models de Apple.