Это руководство содержит все необходимое для начала работы с включением логирования для существующих приложений Gemini API. В этом руководстве вы узнаете, как просматривать логи из существующего или нового приложения на панели управления Google AI Studio, чтобы лучше понимать поведение модели и то, как пользователи могут взаимодействовать с вашими приложениями. Используйте логирование для наблюдения, отладки и, при необходимости, для обмена отзывами об использовании с Google, чтобы помочь улучшить Gemini в различных сценариях использования разработчиками . *
Поддерживаются все вызовы API GenerateContent и StreamGenerateContent , включая те, которые выполняются через совместимые с OpenAI конечные точки.
1. Включите ведение журнала в Google AI Studio.
Прежде чем начать, убедитесь, что у вас есть проект с поддержкой выставления счетов, который принадлежит вам.
- Откройте страницу с логами в Google AI Studio .
- Выберите свой проект из выпадающего списка и нажмите кнопку «Включить», чтобы включить ведение журнала для всех запросов по умолчанию.

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

Щёлкните по записи, чтобы просмотреть полную версию пары запрос-ответ. Вы можете ознакомиться с полным текстом запроса, полным ответом от Gemini и контекстом предыдущего хода. Обратите внимание, что для каждого проекта установлен лимит хранилища до 1000 записей, а записи, не сохранённые в наборах данных, истекают через 55 дней. Если ваш проект достигнет лимита хранилища, вам будет предложено удалить записи.
3. Подбор и распространение наборов данных.
- В таблице журналов найдите вверху панель фильтров, чтобы выбрать свойство для фильтрации.
- В отфильтрованном представлении журналов используйте флажки, чтобы выбрать все или некоторые из них.
- Нажмите кнопку «Создать набор данных», которая появится в верхней части списка.
- Присвойте новому набору данных описательное имя и, при необходимости, описание.
- Вы увидите созданный вами набор данных, содержащий тщательно отобранный набор логов.
- Экспортируйте свой набор данных для дальнейшего анализа в виде файлов CSV, JSONL или в Google Таблицы.

Наборы данных могут быть полезны в самых разных ситуациях.
- Создавайте наборы задач: стимулируйте будущие улучшения, направленные на те области, в которых вы хотите, чтобы ваш ИИ совершенствовался.
- Подборка примеров: например, пример из реального использования для генерации ответов от другой модели или набор крайних случаев для рутинных проверок перед развертыванием.
- Оценочные наборы: наборы, репрезентативные для реального использования важных функций, предназначенные для сравнения с другими моделями или итерациями системных инструкций.
Вы можете внести свой вклад в развитие исследований в области ИИ, API Gemini и Google AI Studio, предоставив свои наборы данных в качестве демонстрационных примеров. Это позволит нам совершенствовать наши модели в различных контекстах и создавать системы ИИ, которые останутся полезными для разработчиков во многих областях и приложениях.
Дальнейшие шаги и что нужно проверить
Теперь, когда у вас включено логирование, попробуйте следующее:
- Создание прототипа с историей сессий: используйте AI Studio Build для создания приложений с помощью Vibe Code и добавьте свой API-ключ, чтобы включить историю пользовательских логов.
- Повторный запуск логов с помощью Gemini Batch API: используйте наборы данных для выборки ответов и оценки моделей или логики приложения, повторно запуская логи через Gemini Batch API .
Совместимость
В настоящее время ведение журналов не поддерживается для следующих случаев:
- Модели Imagen и Veo
- Модель встраивания Gemini
- Входные данные, содержащие видео, GIF-файлы или PDF-документы.