Варианты конфигурации при доступе к Gemini API через фреймворк Foundation Models от Apple

В каждом запросе к модели можно указать настройки, которые будут определять, как модель генерирует ответ. Каждая модель Gemini предлагает разные варианты конфигурации.

В зависимости от настройки конфигурация сохраняется на протяжении всего срока действия geminiLanguageModel или LanguageModelSession. Если вы хотите использовать другую конфигурацию, создайте новую модель или сеанс с этой конфигурацией.

На странице описаны следующие варианты конфигурации:

• Системные инструкции
• Размышление (aka "рассуждение")
• Сгенерированные изображения
• Общие настройки

Как задать системные инструкции

Системные инструкции – это своего рода "преамбула", которую вы добавляете до того, как модель получит дальнейшие инструкции от конечного пользователя. Он позволяет управлять поведением модели в соответствии с вашими потребностями и сценариями использования.

Укажите системные инструкции на странице 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."
)

// ...

Настройка мышления (рассуждений)

Вы можете настроить объем размышлений (также называемых рассуждениями), которые модель Gemini может выполнять для создания ответа. Подробную информацию, рекомендации и примеры использования вы найдете в общем руководстве Размышления.

Вместо уровня мышления Apple использует уровень рассуждения. Вы задаете параметр "reasoningLevel" в ContextOptions для каждого запроса с помощью 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)
)

// ...

Допустимые значения уровня рассуждений

Обратите внимание:

• Модели Gemini 3.x всегда используют режим размышления. Вы не можете отключить его для этих моделей.
• Модели Gemini 3.x всегда используют динамическое мышление – модель решает, когда и сколько думать, в пределах заданного значения.

В таблице ниже перечислены уровни мышления (reasoningLevel), которые можно задать для каждой модели Gemini. Обратите внимание, что если вы используете значение Gemini (MINIMAL, LOW, MEDIUM, HIGH), оно будет автоматически сопоставлено с версией Apple.

^{1 gemini-3.8-flash и gemini-3.7-flashне поддерживают уровень мышления MINIMAL. Если вы зададите уровень мышления MINIMAL, запрос не будет выполнен и вернет ошибку 400.}

Как настроить вывод изображений

Основная конфигурация

Оставить отзыв о доступе к Gemini API через фреймворк Foundation Models от Apple