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 el parámetro de configuración, este se mantiene durante la vida útil del geminiLanguageModel o del 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")
• Resultados de imágenes generadas
• Configuración general

Especifica 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 razonamiento (también llamado pensamiento) que un modelo Gemini puede realizar para generar su respuesta. Para obtener detalles, prácticas recomendadas y casos de uso del 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 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)
)

// ...

Valores admitidos para el nivel de razonamiento

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, es decir, el modelo decide cuándo y cuánto pensar hasta la cantidad configurada.

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

^{1 gemini-3.8-flash y gemini-3.7-flash no admiten el nivel de razonamiento MINIMAL. Si estableces el nivel de pensamiento en MINIMAL, la solicitud fallará con un error 400.}

Configura la salida de la imagen

Configuración general

Envía comentarios sobre el acceso a Gemini API a través del framework de modelos de base de Apple