日志和数据集

在本指南中，您将了解如何在 Google AI Studio 信息中心内查看 Gemini API 使用情况的日志，以便更好地了解模型行为以及用户与应用互动的方式。您可以使用日志记录来观察和调试，还可以选择与 Google 分享使用情况 反馈，以帮助改进 Gemini 在各种开发者使用情形下的表现。*

系统支持所有 GenerateContent、BatchGenerateContent、StreamGenerateContent API 调用，以及不包括 托管式智能体的 Interactions API 调用。这包括通过 OpenAI 兼容性端点进行的调用。

*注意：Gemini API 日志的存储空间仅适用于 Gemini API 付费层级的项目。

配置项目日志记录

默认情况下，API 会存储所有互动对象 (store=true)，以便简化服务器端状态管理功能的使用。相比之下，Generate Content API 默认不会存储请求，并且需要从 AI Studio 中针对每个请求或在项目级启用存储。

在 Google AI Studio 中，您可以为所有项目或特定项目启用或 停用日志记录，并随时通过“设置”面板在 “日志和数据集”页面中更改这些 偏好设置。您可以单独为 generateContent API 和 Interactions API 开启或关闭日志记录，以更改项目的默认存储行为。

请求级日志记录

存储和日志记录行为因 API 而异：

  • Interactions 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);

Interactions 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 中查看项目日志

  1. 前往 AI Studio 中的“日志”页面。
  2. 从下拉列表中选择一个项目。
  3. 如果存在 Interactions API 的日志，这些日志将以反向时间顺序显示在表格中。
  4. 如需查看 Generate Content API 的项目日志，请先在 设置面板 中启用此功能。

点击条目即可预览有效负载。您可以检查 Gemini 的完整提示和回答，以及之前轮次的上下文。对于 Interactions API 请求，日志还包含指向 previous_interaction_id 的直接链接。

配置项目存储保留期

日志将在默认保留期（ 55 天）过后过期并被标记为删除（除非保存到数据集，否则不会过期）。 您可以将项目日志的保留期配置为最多 7 天、14 天、28 天或 55 天。

创建和共享数据集

您可以将日志保存到数据集中，以便更有效地整理和导出日志。

  • 在“日志”页面中，找到顶部的过滤条件栏 ，选择要作为过滤条件的属性。
  • 在过滤后的视图中，使用复选框选择所有日志或单个日志。
  • 点击列表顶部显示的创建数据集 按钮。
  • 为新数据集命名，并添加可选说明。
  • 您将看到刚刚创建的数据集，其中包含精选的日志集。
  • 将数据集导出为 CSV、JSONL 文件或 Google 表格，以进行进一步分析。

数据集可用于多种不同的使用情形。

  • 精选挑战集： 推动未来的改进，以解决您希望 AI 改进的领域。
  • 精选示例集： 例如，从实际使用情况中提取的示例，用于从其他模型生成回答；或者，在部署前用于例行检查的边缘情况集合。
  • 评估集： 代表重要功能实际使用情况的集合，用于与其他模型或系统指令迭代进行比较。

您可以选择与 Google 共享数据集作为演示示例，为 Gemini 的研究和开发做出贡献。

限制

目前不支持以下内容的日志记录：

  • Imagen 和 Veo 模型
  • Gemini 嵌入模型
  • Gemini 机器人模型
  • 包含视频、GIF 或 PDF 的输入
  • Gemini API 中的公开预览版智能体

后续步骤

  • 使用会话历史记录构建原型： 使用 AI Studio Build 对应用进行氛围编程，并添加 API 密钥以启用 AI 功能的 Gemini API 日志历史记录。
  • 使用 Gemini Batch API 重新运行日志： 使用数据集进行回答抽样 并通过使用 Gemini Batch API重新运行日志来评估模型或应用逻辑。