Starting November 2, 2026, Firebase App Check enforcement will be required to use Firebase AI Logic. Learn more.

Model updates:

Gemini 4 Argon is now available to use with Firebase AI Logic! Learn more.
Gemini 2.5 models are deprecated or shut down. For the Agent Platform Gemini API, all general-use Gemini 2.5 models have shut down. For the Gemini Developer API, starting December 1, 2026, requests to the general-use Gemini 2.5 Flash and Pro models will be automatically routed to newer models (which may cause breaking changes; learn more). To avoid service disruptions, update to a newer model (like gemini-4-argon, gemini-3.8-flash, gemini-3.5-flash-lite, or gemini-nano-banana-2.1). Learn more.

Чтобы переводить контент на ваш предпочитаемый язык, Google использует технологии на основе искусственного интеллекта. Переводы от ИИ могут содержать ошибки.

Думающая

Все модели Gemini используют внутренний "процесс мышления", который значительно улучшает их способность рассуждать и планировать многоэтапные действия. Это делает их очень эффективными для сложных задач, таких как программирование, высшая математика и анализ данных.

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

Управление объемом рассуждений
Вы можете настроить уровни рассуждений, чтобы контролировать, сколько "рассуждений" может выполнять модель. Эта настройка особенно важна, если приоритетом является снижение задержки или стоимости. Также ознакомьтесь со сравнением сложности задач, чтобы решить, насколько модели может понадобиться способность рассуждать.
Получение сводок мыслей
Вы можете включить сводки мыслей, чтобы они добавлялись в сгенерированный ответ. Эти сводки представляют собой синтезированные версии необработанных мыслей модели и дают представление о ее внутреннем процессе рассуждения.
Обработка подписей мыслей
SDK Firebase AI Logic автоматически обрабатывают подписи мыслей, чтобы у модели был доступ к контексту мыслей из предыдущих шагов, особенно при вызове функций.

Обязательно ознакомьтесь с рекомендациями по использованию моделей рассуждения и составлению запросов к ним.

Обратите внимание на следующее:

В моделях Gemini 2.5 вместо уровня мышления используется лимит на рассуждения. Модели Gemini 3.x общего назначения и последние модели Gemini Nano Banana поддерживают лимит на рассуждения для обратной совместимости. Однако модели Gemini 4.x не поддерживают лимит на рассуждения (если он задан, возвращается ошибка 400).
Модели TTS Gemini не поддерживают функцию рассуждения.
Модели Gemini Live API поддерживают функцию рассуждения. Однако Firebase AI Logic пока не поддерживает добавление конфигурации рассуждения для моделей Live API. Эта функция скоро появится.

Управляйте глубиной рассуждений

Вы можете настроить уровни рассуждения, чтобы контролировать, сколько времени модель тратит на рассуждения, прежде чем дать ответ. Это особенно важно, если для вас приоритетно сокращение задержки или расходов.

Обязательно ознакомьтесь со сравнением сложности задач, чтобы решить, насколько модели может понадобиться способность рассуждать. Вот несколько общих рекомендаций:

Установите более низкое значение для менее сложных задач или если для вас приоритетно сокращение задержки или стоимости.
Для более сложных задач задайте более высокое значение.

Уровни мышления

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

Обратите внимание на следующее:

Модели общего назначения Gemini 3.x и более поздние, а также последние модели Gemini Nano Banana всегда используют мышление. Вы не можете отключить рассуждения для этих моделей.
Модели общего назначения Gemini 3.x и более поздние, а также последние модели Gemini Nano Banana всегда используют динамическое мышление. Это означает, что модель сама решает, когда и сколько она будет думать, в пределах заданного количества токенов.
В моделях Gemini 2.5 вместо уровня мышления используется лимит на рассуждения. Модели Gemini 3.x общего назначения и последние модели Gemini Nano Banana поддерживают лимит на рассуждения для обратной совместимости. Однако модели Gemini 4.x не поддерживают лимит на рассуждения (если он задан, возвращается ошибка 400).

Как настроить уровень рассуждений

Нажмите на название своего поставщика Gemini API, чтобы посмотреть контент и код, относящиеся к нему.

Задайте уровень мышления в GenerationConfig при создании экземпляра GenerativeModel. Конфигурация сохраняется в течение всего времени существования экземпляра. Если вы хотите использовать разные уровни рассуждения для разных запросов, создайте экземпляры GenerativeModel, настроенные для каждого уровня.

Подробнее о поддерживаемых значениях для уровня мышления…

Swift

Задайте уровень рассуждений в GenerationConfig при создании экземпляра GenerativeModel.


// ...

// Set the thinking configuration.
// Use a thinking level value appropriate for your model (example value shown here).
let generationConfig = GenerationConfig(
  thinkingConfig: ThinkingConfig(thinkingLevel: .low)
)

// Specify the config as part of creating the `GenerativeModel` instance.
let model = FirebaseAI.firebaseAI(backend: .googleAI()).generativeModel(
  modelName: "GEMINI_3.x_MODEL_NAME",
  generationConfig: generationConfig
)

// ...

Kotlin

Задайте значения параметров в GenerationConfig при создании экземпляра GenerativeModel.


// ...

// Set the thinking configuration.
// Use a thinking level value appropriate for your model (example value shown here).
val generationConfig = generationConfig {
  thinkingConfig = thinkingConfig {
      thinkingLevel = ThinkingLevel.LOW
  }
}

// Specify the config as part of creating the `GenerativeModel` instance.
val model = Firebase.ai(backend = GenerativeBackend.googleAI()).generativeModel(
  modelName = "GEMINI_3.x_MODEL_NAME",
  generationConfig,
)

// ...

Java

Задайте значения параметров в GenerationConfig при создании экземпляра GenerativeModel.


// ...

// Set the thinking configuration.
// Use a thinking level value appropriate for your model (example value shown here).
ThinkingConfig thinkingConfig = new ThinkingConfig.Builder()
    .setThinkingLevel(ThinkingLevel.LOW)
    .build();

GenerationConfig generationConfig = GenerationConfig.builder()
    .setThinkingConfig(thinkingConfig)
    .build();

// Specify the config as part of creating the `GenerativeModel` instance.
GenerativeModelFutures model = GenerativeModelFutures.from(
        FirebaseAI.getInstance(GenerativeBackend.googleAI())
                .generativeModel(
                  /* modelName */ "GEMINI_3.x_MODEL_NAME",
                  /* generationConfig */ generationConfig
                );
);

// ...

Web

Задайте значения параметров в GenerationConfig при создании экземпляра GenerativeModel.


// ...

const ai = getAI(firebaseApp, { backend: new GoogleAIBackend() });

// Set the thinking configuration.
// Use a thinking level value appropriate for your model (example value shown here).
const generationConfig = {
  thinkingConfig: {
    thinkingLevel: ThinkingLevel.LOW
  }
};

// Specify the config as part of creating the `GenerativeModel` instance.
const model = getGenerativeModel(ai, { model: "GEMINI_3.x_MODEL_NAME", generationConfig });

// ...

Dart

Задайте значения параметров в GenerationConfig при создании экземпляра GenerativeModel.


// ...

// Set the thinking configuration.
// Use a thinking level value appropriate for your model (example value shown here).
final thinkingConfig = ThinkingConfig.withThinkingLevel(ThinkingLevel.low);

final generationConfig = GenerationConfig(
  thinkingConfig: thinkingConfig
);

// Specify the config as part of creating the `GenerativeModel` instance.
final model = FirebaseAI.googleAI().generativeModel(
  model: 'GEMINI_3.x_MODEL_NAME',
  generationConfig: generationConfig,
);

// ...

Unity

Задайте значения параметров в GenerationConfig при создании экземпляра GenerativeModel.


// ...

// Set the thinking configuration.
// Use a thinking level value appropriate for your model (example value shown here).
var thinkingConfig = new ThinkingConfig(thinkingLevel: ThinkingLevel.Low);

var generationConfig = new GenerationConfig(
  thinkingConfig: thinkingConfig
);

// Specify the config as part of creating the `GenerativeModel` instance.
var model = FirebaseAI.GetInstance(FirebaseAI.Backend.GoogleAI()).GetGenerativeModel(
  modelName: "GEMINI_3.x_MODEL_NAME",
  generationConfig: generationConfig
);

// ...

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

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

	`MINIMAL`	`LOW`	`MEDIUM`	`HIGH`
	Модель использует как можно меньше токенов; почти не думает Простые задачи	Модель использует меньше токенов, что снижает задержку и стоимость. Простые задачи и задачи с высокой пропускной способностью	Модель использует сбалансированный подход Задачи средней сложности	Модель использует токены до максимального уровня Сложные запросы, требующие глубоких рассуждений.
Gemini 4 Argon `gemini-4-argon`	¹		(по умолчанию)
Gemini 3.x Flash `gemini-3.8-flash` `gemini-3.7-flash` `gemini-3.6-flash` `gemini-3.5-flash`	не поддерживается в `gemini-3.8-flash` или `gemini-3.7-flash` ¹		(по умолчанию)
Gemini 3.x Flash‑Lite `gemini-3.5-flash-lite` `gemini-3.1-flash-lite`	(по умолчанию)
Gemini Nano Banana 2.1 `gemini-nano-banana-2.1`			(по умолчанию)
Gemini Nano Banana 2 `gemini-3.1-flash-image`				(по умолчанию)
Gemini Nano Banana 2 Lite `gemini-3.1-flash-lite-image`	(по умолчанию)
Gemini Nano Banana Pro `gemini-3-pro-image`				(по умолчанию)

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

Модели мышления Gemini 2.5

Чтобы контролировать, сколько времени модель Gemini 2.5 может потратить на генерацию ответа, вы можете указать бюджет мышления – количество токенов мышления, которые ей разрешено использовать.

Как задать лимит на размышления (модели Gemini 2.5)

Нажмите на название своего поставщика Gemini API, чтобы посмотреть контент и код, относящиеся к нему.

Задайте лимит на рассуждения в GenerationConfig при создании экземпляра GenerativeModel для модели Gemini 2.5. Конфигурация сохраняется в течение всего времени существования экземпляра. Если вы хотите использовать разные лимиты на рассуждения для разных запросов, создайте экземпляры GenerativeModel с разными настройками.

Подробнее о поддерживаемых значениях для лимита на рассуждения…

Swift

Задайте лимит на размышление в объекте GenerationConfig при создании экземпляра GenerativeModel.


// ...

// Set the thinking configuration.
// Use a thinking budget value appropriate for your model (example value shown here).
let generationConfig = GenerationConfig(
  thinkingConfig: ThinkingConfig(thinkingBudget: 1024)
)

// Specify the config as part of creating the `GenerativeModel` instance.
let model = FirebaseAI.firebaseAI(backend: .googleAI()).generativeModel(
  modelName: "GEMINI_2.5_MODEL_NAME",
  generationConfig: generationConfig
)

// ...

Kotlin

Задайте значения параметров в GenerationConfig при создании экземпляра GenerativeModel.


// ...

// Set the thinking configuration.
// Use a thinking budget value appropriate for your model (example value shown here).
val generationConfig = generationConfig {
  thinkingConfig = thinkingConfig {
      thinkingBudget = 1024
  }
}

// Specify the config as part of creating the `GenerativeModel` instance.
val model = Firebase.ai(backend = GenerativeBackend.googleAI()).generativeModel(
  modelName = "GEMINI_2.5_MODEL_NAME",
  generationConfig,
)

// ...

Java

Задайте значения параметров в GenerationConfig при создании экземпляра GenerativeModel.


// ...

// Set the thinking configuration.
// Use a thinking budget value appropriate for your model (example value shown here).
ThinkingConfig thinkingConfig = new ThinkingConfig.Builder()
    .setThinkingBudget(1024)
    .build();

GenerationConfig generationConfig = GenerationConfig.builder()
    .setThinkingConfig(thinkingConfig)
    .build();

// Specify the config as part of creating the `GenerativeModel` instance.
GenerativeModelFutures model = GenerativeModelFutures.from(
        FirebaseAI.getInstance(GenerativeBackend.googleAI())
                .generativeModel(
                  /* modelName */ "GEMINI_2.5_MODEL_NAME",
                  /* generationConfig */ generationConfig
                );
);

// ...

Web

Задайте значения параметров в GenerationConfig при создании экземпляра GenerativeModel.


// ...

const ai = getAI(firebaseApp, { backend: new GoogleAIBackend() });

// Set the thinking configuration.
// Use a thinking budget value appropriate for your model (example value shown here).
const generationConfig = {
  thinkingConfig: {
    thinkingBudget: 1024
  }
};

// Specify the config as part of creating the `GenerativeModel` instance.
const model = getGenerativeModel(ai, { model: "GEMINI_2.5_MODEL_NAME", generationConfig });

// ...

Dart

Задайте значения параметров в GenerationConfig при создании экземпляра GenerativeModel.


// ...

// Set the thinking configuration.
// Use a thinking budget value appropriate for your model (example value shown here).
final thinkingConfig = ThinkingConfig.withThinkingBudget(1024);

final generationConfig = GenerationConfig(
  thinkingConfig: thinkingConfig
);

// Specify the config as part of creating the `GenerativeModel` instance.
final model = FirebaseAI.googleAI().generativeModel(
  model: 'GEMINI_2.5_MODEL_NAME',
  generationConfig: generationConfig,
);

// ...

Unity

Задайте значения параметров в GenerationConfig при создании экземпляра GenerativeModel.


// ...

// Set the thinking configuration.
// Use a thinking budget value appropriate for your model (example value shown here).
var thinkingConfig = new ThinkingConfig(thinkingBudget: 1024);

var generationConfig = new GenerationConfig(
  thinkingConfig: thinkingConfig
);

// Specify the config as part of creating the `GenerativeModel` instance.
var model = FirebaseAI.GetInstance(FirebaseAI.Backend.GoogleAI()).GetGenerativeModel(
  modelName: "GEMINI_2.5_MODEL_NAME",
  generationConfig: generationConfig
);

// ...

Поддерживаемые значения лимита на рассуждения (модели Gemini 2.5)

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

Модель	Значение по умолчанию	Доступный диапазон для лимита на рассуждения		Значение, чтобы отключить размышление	Значение, чтобы включить динамическое рассуждение
Модель	Значение по умолчанию			Значение, чтобы отключить размышление	Значение, чтобы включить динамическое рассуждение	Минимальное значение	Максимальное значение
Gemini 2.5 Pro	`8,192`	`128`	`32,768`	нельзя отключить	`-1`
Gemini 2.5 Flash	`8,192`	`1`	`24,576`	`0`	`-1`
Gemini 2.5 Flash‑Lite	`0` (по умолчанию рассуждения отключены)	`512`	`24,576`	`0` (или вообще не настраивать бюджет на размышление)	`-1`

Отключить рассуждения (Gemini 2.5 моделей)

Для некоторых более простых задач способность к мышлению не так важна, и традиционного инференса достаточно. Кроме того, если приоритетом является сокращение задержки или стоимости, вы можете не захотеть, чтобы модель тратила больше времени или средств, чем необходимо для генерации ответа.

В таких ситуациях вы можете отключить рассуждения для некоторых моделей:

Gemini 2.5 Pro: показ рассуждений нельзя отключить.
Gemini 2.5 Flash: отключить рассуждения, установив для параметра thinkingBudget значение 0 токенов.
Gemini 2.5 Flash‑Lite – рассуждения по умолчанию отключены (не задавайте параметр thinkingBudget или задайте для него значение 0).

Обратите внимание, что для всех моделей Gemini 3.x и более поздних версий рассуждения нельзя отключить.

Включить динамическое мышление (модели Gemini 2.5)

При динамическом рассуждении модель сама решает, когда и сколько ей нужно рассуждать (в пределах максимального лимита, описанного ниже).

Чтобы включить динамическое рассуждение, задайте для параметра thinkingBudget значение -1.
Если динамическое мышление включено, максимальное количество токенов мышления всегда будет равно 8192.

Обратите внимание, что все модели Gemini 3.x и более поздние всегда используют динамическое рассуждение.

Сложность задач для всех думающих моделей

Простые задачи, не требующие глубокого анализа
Простые запросы, не требующие сложных рассуждений, например поиск фактов или классификация. Примеры:
- "Где была основана компания DeepMind?"
- "В этом письме предлагается встреча или просто предоставляется информация?"
Задачи средней сложности, для которых может потребоваться рассуждение
Распространенные запросы, для которых полезно пошаговое выполнение или более глубокое понимание. Примеры:
- "Проведи аналогию между фотосинтезом и взрослением".
- Сравни электромобили и гибридные автомобили.
Сложные задачи – может потребоваться максимальное время на размышление
По-настоящему сложные задачи, например решение сложных математических задач или написание кода. Для выполнения таких задач модели необходимо задействовать все свои возможности рассуждения и планирования, что часто включает множество внутренних шагов перед предоставлением ответа. Примеры:
- "Реши задачу 1 из AIME 2025: найди сумму всех целых оснований b > 9, для которых 17b является делителем 97b".
- "Напиши код на Python для веб-приложения, которое визуализирует данные фондового рынка в реальном времени, включая аутентификацию пользователей. Сделайте его максимально эффективным".

Краткие пересказы мыслей

Краткие пересказы рассуждений – это обобщенные версии необработанных рассуждений модели, которые дают представление о ее внутреннем процессе рассуждения.

Вот несколько причин, по которым в ответы включаются краткие пересказы рассуждений:

Вы можете показывать краткое описание рассуждений в интерфейсе приложения или сделать его доступным для пользователей. Краткое изложение мыслей возвращается в ответе отдельно, чтобы вы могли лучше контролировать, как оно используется в вашем приложении.
Если вы также включите ИИ-мониторинг в консоли Firebase, то в ней будут показываться краткие пересказы рассуждений. Вы сможете изучать подробные рассуждения модели, чтобы отлаживать и улучшать свои запросы.

Вот несколько важных примечаний о кратких пересказах:

Бюджеты на рассуждения не влияют на краткие пересказы рассуждений, а применяются только к необработанным рассуждениям модели. Однако если рассуждения отключены, модель не будет возвращать сводку рассуждений.
Краткие пересказы рассуждений считаются частью обычного ответа модели в виде сгенерированного текста и учитываются как токены вывода.

Включить сводки рассуждений

Нажмите на название своего поставщика Gemini API, чтобы посмотреть контент и код, относящиеся к нему.

Чтобы включить краткий пересказ мыслей, задайте для параметра includeThoughts значение true в конфигурации модели. После этого вы сможете получить доступ к сводке, проверив поле thoughtSummary в ответе.

Вот пример, демонстрирующий, как включить и получить сводки мыслей с ответом:

Swift

Включите краткие пересказы мыслей в GenerationConfig при создании экземпляра GenerativeModel.


// ...

// Set the thinking configuration.
// Optionally enable thought summaries in the generated response (default is false).
let generationConfig = GenerationConfig(
  thinkingConfig: ThinkingConfig(includeThoughts: true)
)

// Specify the config as part of creating the `GenerativeModel` instance.
let model = FirebaseAI.firebaseAI(backend: .googleAI()).generativeModel(
  modelName: "GEMINI_MODEL_NAME",
  generationConfig: generationConfig
)

let response = try await model.generateContent("solve x^2 + 4x + 4 = 0")

// Handle the response that includes thought summaries.
if let thoughtSummary = response.thoughtSummary {
  print("Thought Summary: \(thoughtSummary)")
}
guard let text = response.text else {
  fatalError("No text in response.")
}
print("Answer: \(text)")

Kotlin

Включите краткие пересказы мыслей в GenerationConfig при создании экземпляра GenerativeModel.


// ...

// Set the thinking configuration.
// Optionally enable thought summaries in the generated response (default is false).
val generationConfig = generationConfig {
  thinkingConfig = thinkingConfig {
      includeThoughts = true
  }
}

// Specify the config as part of creating the `GenerativeModel` instance.
val model = Firebase.ai(backend = GenerativeBackend.googleAI()).generativeModel(
  modelName = "GEMINI_MODEL_NAME",
  generationConfig,
)

val response = model.generateContent("solve x^2 + 4x + 4 = 0")

// Handle the response that includes thought summaries.
response.thoughtSummary?.let {
    println("Thought Summary: $it")
}
response.text?.let {
    println("Answer: $it")
}

Java

Включите краткие пересказы мыслей в GenerationConfig при создании экземпляра GenerativeModel.


// ...

// Set the thinking configuration.
// Optionally enable thought summaries in the generated response (default is false).
ThinkingConfig thinkingConfig = new ThinkingConfig.Builder()
    .setIncludeThoughts(true)
    .build();

GenerationConfig generationConfig = GenerationConfig.builder()
    .setThinkingConfig(thinkingConfig)
    .build();

// Specify the config as part of creating the `GenerativeModel` instance.
GenerativeModelFutures model = GenerativeModelFutures.from(
        FirebaseAI.getInstance(GenerativeBackend.googleAI())
                .generativeModel(
                  /* modelName */ "GEMINI_MODEL_NAME",
                  /* generationConfig */ generationConfig
                );
);

// Handle the response that includes thought summaries.
ListenableFuture responseFuture = model.generateContent("solve x^2 + 4x + 4 = 0");
Futures.addCallback(responseFuture, new FutureCallback() {
    @Override
    public void onSuccess(GenerateContentResponse response) {
        if (response.getThoughtSummary() != null) {
            System.out.println("Thought Summary: " + response.getThoughtSummary());
        }
        if (response.getText() != null) {
            System.out.println("Answer: " + response.getText());
        }
    }

    @Override
    public void onFailure(Throwable t) {
        // Handle error
    }
}, MoreExecutors.directExecutor());

Web

Включите краткие пересказы мыслей в GenerationConfig при создании экземпляра GenerativeModel.


// ...

const ai = getAI(firebaseApp, { backend: new GoogleAIBackend() });

// Set the thinking configuration.
// Optionally enable thought summaries in the generated response (default is false).
const generationConfig = {
  thinkingConfig: {
    includeThoughts: true
  }
};

// Specify the config as part of creating the `GenerativeModel` instance.
const model = getGenerativeModel(ai, { model: "GEMINI_MODEL_NAME", generationConfig });

const result = await model.generateContent("solve x^2 + 4x + 4 = 0");
const response = result.response;

// Handle the response that includes thought summaries.
if (response.thoughtSummary()) {
    console.log(`Thought Summary: ${response.thoughtSummary()}`);
}
const text = response.text();
console.log(`Answer: ${text}`);

Dart

Включите краткий пересказ мыслей в GenerationConfig при создании экземпляра GenerativeModel.


// ...

// Set the thinking configuration.
// Optionally enable thought summaries in the generated response (default is false).
final thinkingConfig = ThinkingConfig(includeThoughts: true);

final generationConfig = GenerationConfig(
  thinkingConfig: thinkingConfig
);

// Specify the config as part of creating the `GenerativeModel` instance.
final model = FirebaseAI.googleAI().generativeModel(
  model: 'GEMINI_MODEL_NAME',
  generationConfig: generationConfig,
);

final response = await model.generateContent([Content.text('solve x^2 + 4x + 4 = 0')]);

// Handle the response that includes thought summaries.
if (response.thoughtSummary != null) {
  print('Thought Summary: ${response.thoughtSummary}');
}
if (response.text != null) {
  print('Answer: ${response.text}');
}

Unity

Включите краткие пересказы мыслей в GenerationConfig при создании экземпляра GenerativeModel.


// ...

// Set the thinking configuration.
// Optionally enable thought summaries in the generated response (default is false).
var thinkingConfig = new ThinkingConfig(includeThoughts: true);

var generationConfig = new GenerationConfig(
  thinkingConfig: thinkingConfig
);

// Specify the config as part of creating the `GenerativeModel` instance.
var model = FirebaseAI.GetInstance(FirebaseAI.Backend.GoogleAI()).GetGenerativeModel(
  modelName: "GEMINI_MODEL_NAME",
  generationConfig: generationConfig
);

var response = await model.GenerateContentAsync("solve x^2 + 4x + 4 = 0");

// Handle the response that includes thought summaries.
if (response.ThoughtSummary != null) {
    Debug.Log($"Thought Summary: {response.ThoughtSummary}");
}
if (response.Text != null) {
    Debug.Log($"Answer: {response.Text}");
}

Как посмотреть ответ и краткое описание рассуждений

# Example Response:
#     Okay, let's solve the quadratic equation x² + 4x + 4 = 0.
#     ...
#     **Answer:**
#     The solution to the equation x² + 4x + 4 = 0 is x = -2. This is a repeated root (or a root with multiplicity 2).

# Example Thought Summary:
#     **My Thought Process for Solving the Quadratic Equation**
#
#     Alright, let's break down this quadratic, x² + 4x + 4 = 0. First things first:
#     it's a quadratic; the x² term gives it away, and we know the general form is
#     ax² + bx + c = 0.
#
#     So, let's identify the coefficients: a = 1, b = 4, and c = 4. Now, what's the
#     most efficient path to the solution? My gut tells me to try factoring; it's
#     often the fastest route if it works. If that fails, I'll default to the quadratic
#     formula, which is foolproof. Completing the square? It's good for deriving the
#     formula or when factoring is difficult, but not usually my first choice for
#     direct solving, but it can't hurt to keep it as an option.
#
#     Factoring, then. I need to find two numbers that multiply to 'c' (4) and add
#     up to 'b' (4). Let's see... 1 and 4 don't work (add up to 5). 2 and 2? Bingo!
#     They multiply to 4 and add up to 4. This means I can rewrite the equation as
#     (x + 2)(x + 2) = 0, or more concisely, (x + 2)² = 0. Solving for x is now
#     trivial: x + 2 = 0, thus x = -2.
#
#     Okay, just to be absolutely certain, I'll run the quadratic formula just to
#     double-check. x = [-b ± √(b² - 4ac)] / 2a. Plugging in the values, x = [-4 ±
#     √(4² - 4 * 1 * 4)] / (2 * 1). That simplifies to x = [-4 ± √0] / 2. So, x =
#     -2 again - a repeated root. Nice.
#
#     Now, let's check via completing the square. Starting from the same equation,
#     (x² + 4x) = -4. Take half of the b-value (4/2 = 2), square it (2² = 4), and
#     add it to both sides, so x² + 4x + 4 = -4 + 4. Which simplifies into (x + 2)²
#     = 0. The square root on both sides gives us x + 2 = 0, therefore x = -2, as
#      expected.
#
#     Always, *always* confirm! Let's substitute x = -2 back into the original
#     equation: (-2)² + 4(-2) + 4 = 0. That's 4 - 8 + 4 = 0. It checks out.
#
#     Conclusion: the solution is x = -2. Confirmed.

Сводки рассуждений в реальном времени

Вы также можете посмотреть краткий пересказ рассуждений, если решите транслировать ответ с помощью generateContentStream. В этом случае во время генерации ответа будут возвращаться скользящие дополнительные сводки.

Swift

Включите краткие пересказы мыслей в GenerationConfig при создании экземпляра GenerativeModel.


// ...

// Set the thinking configuration.
// Optionally enable thought summaries in the generated response (default is false).
let generationConfig = GenerationConfig(
  thinkingConfig: ThinkingConfig(includeThoughts: true)
)

// Specify the config as part of creating the `GenerativeModel` instance.
let model = FirebaseAI.firebaseAI(backend: .googleAI()).generativeModel(
  modelName: "GEMINI_MODEL_NAME",
  generationConfig: generationConfig
)

let stream = try model.generateContentStream("solve x^2 + 4x + 4 = 0")

// Handle the streamed response that includes thought summaries.
var thoughts = ""
var answer = ""
for try await response in stream {
  if let thought = response.thoughtSummary {
    if thoughts.isEmpty {
      print("--- Thoughts Summary ---")
    }
    print(thought)
    thoughts += thought
  }

  if let text = response.text {
    if answer.isEmpty {
      print("--- Answer ---")
    }
    print(text)
    answer += text
  }
}

Kotlin

Включите краткий пересказ мыслей в GenerationConfig при создании экземпляра GenerativeModel.


// ...

// Set the thinking configuration.
// Optionally enable thought summaries in the generated response (default is false).
val generationConfig = generationConfig {
  thinkingConfig = thinkingConfig {
      includeThoughts = true
  }
}

// Specify the config as part of creating the `GenerativeModel` instance.
val model = Firebase.ai(backend = GenerativeBackend.googleAI()).generativeModel(
  modelName = "GEMINI_MODEL_NAME",
  generationConfig,
)

// Handle the streamed response that includes thought summaries.
var thoughts = ""
var answer = ""
model.generateContentStream("solve x^2 + 4x + 4 = 0").collect { response ->
    response.thoughtSummary?.let {
        if (thoughts.isEmpty()) {
            println("--- Thoughts Summary ---")
        }
        print(it)
        thoughts += it
    }
    response.text?.let {
        if (answer.isEmpty()) {
            println("--- Answer ---")
        }
        print(it)
        answer += it
    }
}

Java

Включите краткие пересказы мыслей в GenerationConfig при создании экземпляра GenerativeModel.


// ...

// Set the thinking configuration.
// Optionally enable thought summaries in the generated response (default is false).
ThinkingConfig thinkingConfig = new ThinkingConfig.Builder()
    .setIncludeThoughts(true)
    .build();

GenerationConfig generationConfig = GenerationConfig.builder()
    .setThinkingConfig(thinkingConfig)
    .build();

// Specify the config as part of creating the `GenerativeModel` instance.
GenerativeModelFutures model = GenerativeModelFutures.from(
        FirebaseAI.getInstance(GenerativeBackend.googleAI())
                .generativeModel(
                  /* modelName */ "GEMINI_MODEL_NAME",
                  /* generationConfig */ generationConfig
                );
);

// Streaming with Java is complex and depends on the async library used.
// This is a conceptual example using a reactive stream.
Flowable responseStream = model.generateContentStream("solve x^2 + 4x + 4 = 0");

// Handle the streamed response that includes thought summaries
StringBuilder thoughts = new StringBuilder();
StringBuilder answer = new StringBuilder();

responseStream.subscribe(response -> {
    if (response.getThoughtSummary() != null) {
        if (thoughts.length() == 0) {
            System.out.println("--- Thoughts Summary ---");
        }
        System.out.print(response.getThoughtSummary());
        thoughts.append(response.getThoughtSummary());
    }
    if (response.getText() != null) {
        if (answer.length() == 0) {
            System.out.println("--- Answer ---");
        }
        System.out.print(response.getText());
        answer.append(response.getText());
    }
}, throwable -> {
    // Handle error
});

Web

Включите краткие пересказы мыслей в GenerationConfig при создании экземпляра GenerativeModel.


// ...

const ai = getAI(firebaseApp, { backend: new GoogleAIBackend() });

// Set the thinking configuration.
// Optionally enable thought summaries in the generated response (default is false).
const generationConfig = {
  thinkingConfig: {
    includeThoughts: true
  }
};

// Specify the config as part of creating the `GenerativeModel` instance.
const model = getGenerativeModel(ai, { model: "GEMINI_MODEL_NAME", generationConfig });

const result = await model.generateContentStream("solve x^2 + 4x + 4 = 0");

// Handle the streamed response that includes thought summaries.
let thoughts = "";
let answer = "";
for await (const chunk of result.stream) {
  if (chunk.thoughtSummary()) {
    if (thoughts === "") {
      console.log("--- Thoughts Summary ---");
    }
    // In Node.js, process.stdout.write(chunk.thoughtSummary()) could be used
    // to avoid extra newlines.
    console.log(chunk.thoughtSummary());
    thoughts += chunk.thoughtSummary();
  }

  const text = chunk.text();
  if (text) {
    if (answer === "") {
      console.log("--- Answer ---");
    }
    // In Node.js, process.stdout.write(text) could be used.
    console.log(text);
    answer += text;
  }
}

Dart

Включите краткий пересказ мыслей в GenerationConfig при создании экземпляра GenerativeModel.


// ...

// Set the thinking configuration.
// Optionally enable thought summaries in the generated response (default is false).
final thinkingConfig = ThinkingConfig(includeThoughts: true);

final generationConfig = GenerationConfig(
  thinkingConfig: thinkingConfig
);

// Specify the config as part of creating the `GenerativeModel` instance.
final model = FirebaseAI.googleAI().generativeModel(
  model: 'GEMINI_MODEL_NAME',
  generationConfig: generationConfig,
);

final responses = model.generateContentStream([Content.text('solve x^2 + 4x + 4 = 0')]);

// Handle the streamed response that includes thought summaries.
var thoughts = '';
var answer = '';
await for (final response in responses) {
  if (response.thoughtSummary != null) {
    if (thoughts.isEmpty) {
      print('--- Thoughts Summary ---');
    }
    thoughts += response.thoughtSummary!;
  }
  if (response.text != null) {
    if (answer.isEmpty) {
      print('--- Answer ---');
    }
    answer += response.text!;
  }
}

Unity

Включите краткий пересказ мыслей в GenerationConfig при создании экземпляра GenerativeModel.


// ...

// Set the thinking configuration.
// Optionally enable thought summaries in the generated response (default is false).
var thinkingConfig = new ThinkingConfig(includeThoughts: true);

var generationConfig = new GenerationConfig(
  thinkingConfig: thinkingConfig
);

// Specify the config as part of creating the `GenerativeModel` instance.
var model = FirebaseAI.GetInstance(FirebaseAI.Backend.GoogleAI()).GetGenerativeModel(
  modelName: "GEMINI_MODEL_NAME",
  generationConfig: generationConfig
);

var stream = model.GenerateContentStreamAsync("solve x^2 + 4x + 4 = 0");

// Handle the streamed response that includes thought summaries.
var thoughts = "";
var answer = "";
await foreach (var response in stream)
{
    if (response.ThoughtSummary != null)
    {
        if (string.IsNullOrEmpty(thoughts))
        {
            Debug.Log("--- Thoughts Summary ---");
        }
        Debug.Log(response.ThoughtSummary);
        thoughts += response.ThoughtSummary;
    }
    if (response.Text != null)
    {
        if (string.IsNullOrEmpty(answer))
        {
            Debug.Log("--- Answer ---");
        }
        Debug.Log(response.Text);
        answer += response.Text;
    }
}

Подписи мыслей

При использовании рассуждений в многоэтапных взаимодействиях у модели нет доступа к контексту рассуждений из предыдущих этапов. Однако если вы используете вызов функций, то можете воспользоваться сигнатурами рассуждений, чтобы сохранять контекст рассуждений между репликами. Подписи рассуждений – это зашифрованные представления внутренних процессов рассуждения модели. Они доступны при использовании рассуждений и вызова функций. В частности, подписи рассуждений генерируются, когда:

Режим размышления включен, и рассуждения сгенерированы.
Запрос содержит объявления функций.

Чтобы воспользоваться преимуществами цифровых подписей, используйте вызов функций как обычно. SDK Firebase AI Logic упрощают этот процесс, управляя состоянием и автоматически обрабатывая подписи мыслей. SDK автоматически передают все сгенерированные подписи мыслей между последующими вызовами sendMessage или sendMessageStream в сеансе Chat.

Цены и подсчет токенов мышления

Для токенов мышления действуют те же цены, что и для токенов текстовых ответов. Если вы включите краткие пересказы рассуждений, они будут считаться токенами мышления и оплачиваться соответствующим образом.

Вы можете включить ИИ-мониторинг в консоли Firebase, чтобы отслеживать количество токенов мышления для запросов, в которых включено мышление.

Общее количество токенов мышления можно получить из поля thoughtsTokenCount в атрибуте usageMetadata ответа:

Swift

// ...

let response = try await model.generateContent("Why is the sky blue?")

if let usageMetadata = response.usageMetadata {
  print("Thoughts Token Count: \(usageMetadata.thoughtsTokenCount)")
}

Kotlin

// ...

val response = model.generateContent("Why is the sky blue?")

response.usageMetadata?.let { usageMetadata ->
    println("Thoughts Token Count: ${usageMetadata.thoughtsTokenCount}")
}

Java

// ...

ListenableFuture<GenerateContentResponse> response =
    model.generateContent("Why is the sky blue?");

Futures.addCallback(response, new FutureCallback<GenerateContentResponse>() {
    @Override
    public void onSuccess(GenerateContentResponse result) {
        String usageMetadata = result.getUsageMetadata();
        if (usageMetadata != null) {
            System.out.println("Thoughts Token Count: " +
                usageMetadata.getThoughtsTokenCount());
        }
    }

    @Override
    public void onFailure(Throwable t) {
        t.printStackTrace();
    }
}, executor);

Web

// ...

const response = await model.generateContent("Why is the sky blue?");

if (response?.usageMetadata?.thoughtsTokenCount != null) {
    console.log(`Thoughts Token Count: ${response.usageMetadata.thoughtsTokenCount}`);
}

Dart

// ...

final response = await model.generateContent(
  Content.text("Why is the sky blue?"),
]);

if (response?.usageMetadata case final usageMetadata?) {
  print("Thoughts Token Count: ${usageMetadata.thoughtsTokenCount}");
}

Unity

// ...

var response = await model.GenerateContentAsync("Why is the sky blue?");

if (response.UsageMetadata != null)
{
    UnityEngine.Debug.Log($"Thoughts Token Count: {response.UsageMetadata?.ThoughtsTokenCount}");
}

Подробнее о токенах рассказывается в руководстве по подсчету токенов.

Думающая Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

Рекомендации и советы по созданию запросов для моделей рассуждения

Управляйте глубиной рассуждений

Уровни мышления

Как настроить уровень рассуждений

Swift

Kotlin

Java

Web

Dart

Unity

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

Модели мышления Gemini 2.5

Как задать лимит на размышления (модели Gemini 2.5)

Swift

Kotlin

Java

Web

Dart

Unity

Поддерживаемые значения лимита на рассуждения (модели Gemini 2.5)

Отключить рассуждения (Gemini 2.5 моделей)

Включить динамическое мышление (модели Gemini 2.5)

Сложность задач для всех думающих моделей

Краткие пересказы мыслей

Включить сводки рассуждений

Swift

Kotlin

Java

Web

Dart

Unity

Сводки рассуждений в реальном времени

Swift

Kotlin

Java

Web

Dart

Unity

Подписи мыслей

Цены и подсчет токенов мышления

Swift

Kotlin

Java

Web

Dart

Unity

Думающая