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

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

Поддерживаются все вызовы API GenerateContent и StreamGenerateContent , включая те, которые выполняются через совместимые с OpenAI конечные точки.

1. Включите ведение журнала в Google AI Studio.

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

  1. Откройте страницу с логами в Google AI Studio .
  2. Выберите свой проект из выпадающего списка и нажмите кнопку «Включить», чтобы включить ведение журнала для всех запросов по умолчанию.

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

2. Просмотр журналов в AI Studio

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

Щёлкните по записи, чтобы просмотреть полную версию пары запрос-ответ. Вы можете ознакомиться с полным текстом запроса, полным ответом от 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-документы.