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

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

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

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

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

Укажите системные инструкции

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

Укажите системные инструкции в объекте 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 ), которые можно установить для каждой модели Близнецов . Обратите внимание, что если вы используете значение для Близнецов ( MINIMAL , LOW , MEDIUM , HIGH ), оно будет автоматически сопоставлено с версией этого значения от Apple.

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

Общая конфигурация

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