API для взаимодействия теперь общедоступн. Мы рекомендуем использовать этот API для доступа ко всем новейшим функциям и моделям.

Эта страница переведена с помощью Cloud Translation API.

Журналы и наборы данных

В этом руководстве вы узнаете, как просматривать журналы использования API Gemini на панели управления Google AI Studio, чтобы лучше понимать поведение модели и то, как пользователи могут взаимодействовать с вашими приложениями. Используйте ведение журналов для наблюдения, отладки и, при необходимости, для обмена отзывами об использовании с Google, чтобы помочь улучшить Gemini в различных сценариях применения для разработчиков . ^*

Поддерживаются все вызовы API GenerateContent , BatchGenerateContent , StreamGenerateContent и Interactions , за исключением управляемых агентов. Это включает в себя вызовы, выполняемые через совместимые с OpenAI конечные точки.

*Примечание: Хранилище для логов Gemini API доступно только для проектов, использующих платный тариф Gemini API.

Настройка ведения журнала проекта

По умолчанию API сохраняет все объекты взаимодействия ( store=true ), чтобы упростить использование функций управления состоянием на стороне сервера. В отличие от этого, API генерации контента по умолчанию не сохраняет запросы и требует включения хранения для каждого запроса или на уровне проекта в AI Studio.

В Google AI Studio вы можете включить или отключить ведение журналов для всех проектов или для отдельных проектов и изменить эти настройки в любое время через панель настроек на странице «Журналы и наборы данных» . Ведение журналов можно включать или выключать независимо для API generateContent и API Interactions , чтобы изменить поведение хранилища по умолчанию для проекта.

Журналирование на уровне запросов

Характеристики хранения и ведения журналов различаются в зависимости от API:

API для взаимодействия : по умолчанию сохраняет запросы ( store=true ) для упрощения управления состоянием на стороне сервера.
Generate Content API ( generateContent ): По умолчанию не сохраняет запросы ( store=false ).

Вот как можно установить свойство store :

generateContent API

Python

from google import genai

client = genai.Client()

response = client.models.generate_content(
    model='gemini-3.5-flash',
    contents='Explain quantum entanglement in simple terms.',
    config={'store': False} # Set to True to enable logging of this request
)

print(response.text)

JavaScript

import { GoogleGenAI } from '@google/genai';

const client = new GoogleGenAI({});

const response = await client.models.generateContent({
    model: 'gemini-3.5-flash',
    contents: 'Explain quantum entanglement in simple terms.',
    config: {
        store: false // Set to true to enable logging of this request
    }
});

console.log(response.text);

API взаимодействий

Python

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    model="gemini-3.5-flash",
    input="Explain quantum entanglement in simple terms.",
    store=True # Set to False to disable logging of this request
)

print(interaction.outputs[-1].text)

JavaScript

import { GoogleGenAI } from '@google/genai';

const client = new GoogleGenAI({});

const interaction = await client.interactions.create({
    model: 'gemini-3.5-flash',
    input: 'Explain quantum entanglement in simple terms.',
    store: true // Set to false to disable logging of this request
});

console.log(interaction.outputs[interaction.outputs.length - 1].text);

Просматривайте журналы проекта в AI Studio.

Перейдите на страницу «Журналы» в AI Studio .
Выберите проект из выпадающего списка.
Если журналы событий API взаимодействий существуют, они будут отображаться в таблице в обратном хронологическом порядке.
Чтобы просматривать журналы проекта для API генерации контента, сначала включите эту функцию на панели настроек .

Щелкните по записи, чтобы просмотреть содержимое. Вы можете ознакомиться с полным запросом и ответом от Gemini, а также с контекстом предыдущих ходов. Для запросов к API взаимодействий в журналах также содержится прямая ссылка на previous_interaction_id .

Настройка сохранения данных в хранилище проекта

Журналы будут удалены и удалены по истечении стандартного периода хранения в 55 дней (если только они не сохранены в набор данных , для которого этот период не истекает). Вы можете настроить период хранения журналов проекта на 7, 14, 28 или максимум 55 дней.

Создавайте и делитесь наборами данных.

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

На странице «Журналы» найдите вверху панель фильтров, чтобы выбрать свойство для фильтрации.
В отфильтрованном представлении используйте флажки, чтобы выбрать все или отдельные записи журнала.
Нажмите кнопку «Создать набор данных» , которая находится в верхней части списка.
Присвойте новому набору данных имя и, при необходимости, описание.
Вы увидите созданный вами набор данных, содержащий тщательно отобранный набор логов.
Экспортируйте свой набор данных для дальнейшего анализа в виде файлов CSV, JSONL или в Google Таблицы.

Наборы данных могут быть полезны в самых разных ситуациях.

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

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

Ограничения

В настоящее время ведение журналов не поддерживается для следующих случаев:

Модели Imagen и Veo
Модели встраивания Gemini
Модель Gemini Robotics
Входные данные, содержащие видео, GIF-файлы или PDF-документы.
Агенты для публичного предварительного просмотра в API Gemini

Что дальше?

Создание прототипа с историей сессий: используйте AI Studio Build для создания приложений с помощью Vibe Code и добавьте свой API-ключ, чтобы включить историю логов Gemini API для функций ИИ.
Повторный запуск обработки журналов с помощью Gemini Batch API: используйте наборы данных для выборки ответов и оценки моделей или логики приложения, повторно запуская обработку журналов с помощью Gemini Batch API .