Gemini 中文指南
获取 API 密钥 ↗

日志与数据集

↓ 下载 MarkdownInteractions API

在本指南中,您将了解如何在 Google AI Studio 仪表板中查看 Gemini API 使用情况的日志,以更好地了解模型行为以及用户如何与您的应用程序交互。使用日志记录来观察、调试并有选择地与 Google 共享使用反馈,以帮助跨开发人员使用案例改进 Gemini。要了解 Google 如何使用日志记录数据,请参阅 数据记录和共享 政策文件

全部 GenerateContent, BatchGenerateContent, StreamGenerateContent API 调用,以及 互动 支持 API 调用(不包括托管智能体)。这包括通过以下方式拨打的电话 OpenAI 兼容性 端点。

配置项目日志记录 #

默认情况下,两个 互动 API 和生成内容 API 存储请求(store=true)。对于 Interactions API,这还启用了服务器端状态管理功能。

在谷歌 人工智能工作室 您可以启用或禁用单个项目的存储,并通过以下方式随时更改这些首选项 设置 面板在你的 Gemini API 日志控制台。您可以单独打开或关闭登录 generateContent API 和 互动 API 更改项目的默认存储行为。

请求级日志记录 #

两个 API 都默认存储请求(store=true):

  • Interactions API: 默认存储请求以简化服务器端状态管理。
  • 生成内容 API (generateContent, streamGenerateContent, 和 batchGenerateContent): 默认情况下存储 10 月或之后创建的项目的请求 26, 2026. 在该日期之前创建的项目默认情况下不存储请求 (store=false) 除非在 AI Studio 中启用了日志记录。

请求级别 store 属性优先于项目级别设置。设置 store 生成内容 API 请求需要 google-genai 2.33.0 或更高版本(适用于 Python), @google/genai 2.31.0 或更高版本的 JavaScript, google-genai 1.79.0 或更高版本(适用于 Java),以及 google.golang.org/genai 1.76.0 或更高版本(适用于 Go)。您可以通过以下方式设置 store 属性:

生成内容 API

python
from google import genai

client = genai.Client()

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

print(response.text)

Interactions API

python
from google import genai

client = genai.Client()

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

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

在 AI Studio 中查看项目日志 #

  1. 进入日志页面 人工智能工作室.
  2. 从下拉列表中选择一个项目。
  3. 日志将按时间倒序显示在表中(如果存在)。
  4. 对于 10 月之前创建的项目 26, 2026, 首先启用生成内容 API 日志记录 设置面板 观察生成内容 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 中的公共预览版智能体

后续步骤 #

  • 具有会话历史记录的原型: 使用 人工智能工作室构建 到vibe代码应用程序并添加您的API 密钥以启用AI功能的Gemini API日志历史记录。
  • 使用 Gemini Batch API 重新运行日志: 通过使用以下命令重新运行日志,使用数据集进行响应采样和模型或应用程序逻辑的评估 Gemini Batch API.

搜索标题、API 名称或正文内容