Opções de configuração ao acessar a API Gemini pelo framework Foundation Models da Apple

Em cada solicitação a um modelo, é possível enviar algumas configurações para controlar como o modelo gera uma resposta. Cada modelo Gemini oferece opções de configuração diferentes.

Dependendo da configuração, ela é mantida durante a vida útil do geminiLanguageModel ou da LanguageModelSession. Se você quiser usar uma configuração diferente, crie um novo modelo ou sessão com essa configuração.

A página descreve as seguintes opções de configuração:

• Instruções do sistema
• Raciocínio
• Saída de imagem gerada
• Configuração geral

Especificar instruções do sistema

As instruções do sistema são como um "preâmbulo" que você adiciona antes que o modelo seja exposto a outras instruções do usuário final. Elas permitem direcionar o comportamento do modelo com base nas suas necessidades e casos de uso específicos.

Especifique as instruções do sistema na 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."
)

// ...

Configurar o raciocínio

É possível configurar a quantidade de raciocínio que um Gemini modelo pode fazer para gerar a resposta. Para mais detalhes, melhores práticas e casos de uso para o raciocínio, consulte o guia geral sobre raciocínio.

Em vez de nível de raciocínio, a Apple usa nível de raciocínio. Você define o reasoningLevel em ContextOptions em cada solicitação por uma 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 de nível de raciocínio com suporte

Observações:

• Os modelos Gemini 3.x sempre usam o raciocínio. Não é possível desativar ou desativar o raciocínio para esses modelos.
• Gemini 3.x modelos sempre usam raciocínio dinâmico : o modelo decide quando e quanto ele pensa até a quantidade configurada.

A tabela a seguir lista os níveis de raciocínio (reasoningLevel) que podem ser definidos para cada Gemini modelo. Se você usar um valor Gemini (MINIMAL, LOW, MEDIUM, HIGH), ele será mapeado automaticamente para a versão da Apple desse valor.

^{1 gemini-3.7-flash não oferece suporte ao nível de raciocínio MINIMAL. Se você definir o nível de raciocínio como MINIMAL, a solicitação falhará com um erro 400.}

Configurar a saída de imagem

Configuração geral

Enviar feedback sobre o acesso à Gemini API pelo framework Foundation Models da Apple