# 日志与数据集

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

全部 `GenerateContent`, `BatchGenerateContent`, `StreamGenerateContent` API 调用，以及 [互动](/docs/interactions-overview) 支持 API 调用（不包括托管智能体）。这包括通过以下方式拨打的电话 [OpenAI 兼容性](/docs/openai) 端点。

{% callout type="note" %}
Gemini API 日志的存储仅适用于 Gemini API 付费层上的项目。
{% /callout %}

## 配置项目日志记录  {% #configure-logging %}

默认情况下，两个 [互动](/docs/interactions-overview) API 和生成内容 API 存储请求（`store=true`）。对于 Interactions API，这还启用了服务器端状态管理功能。

{% callout type="note" %}
从 10 月开始 26, 2026, 生成内容 API 默认存储请求 *新的* 项目。在此日期之前创建的项目将保留生成内容 API 的现有存储设置，该设置已关闭 (`store=false`) 除非之前在 AI Studio 中启用。
{% /callout %}

在谷歌 [人工智能工作室](/logs) 您可以启用或禁用单个项目的存储，并通过以下方式随时更改这些首选项 **设置** 面板在你的 [Gemini API 日志控制台](https://aistudio.google.com/logs)。您可以单独打开或关闭登录 `generateContent` API 和 [互动](/docs/interactions-overview) API 更改项目的默认存储行为。

{% callout type="warning" %}
切换 Interactions API 日志记录 *关闭* 在人工智能工作室 **设置** 面板将阻止 API 自动存储和检索对话历史记录，除非按请求显式覆盖。
{% /callout %}

### 请求级日志记录  {% #request-logging %}

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

* **[Interactions API](/docs/interactions-overview):** 默认存储请求以简化服务器端状态管理。
* **生成内容 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**

{% tabs %}
{% tab label="Python" %}
```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)
```
{% /tab %}

{% tab label="JavaScript" %}
```javascript
import { GoogleGenAI } from '@google/genai';

const client = new GoogleGenAI({});

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

console.log(response.text);
```
{% /tab %}

{% tab label="Java" %}
```java
import com.google.genai.Client;
import com.google.genai.types.GenerateContentConfig;
import com.google.genai.types.GenerateContentResponse;

Client client = new Client();

GenerateContentResponse response =
    client.models.generateContent(
        "gemini-4-hydrogen",
        "Explain quantum entanglement in simple terms.",
        GenerateContentConfig.builder()
            .store(true) // Set to false to disable logging of this request
            .build());

System.out.println(response.text());
```
{% /tab %}

{% tab label="Go" %}
```go
package main

import (
    "context"
    "fmt"
    "log"

    "google.golang.org/genai"
)

func main() {
    ctx := context.Background()
    client, err := genai.NewClient(ctx, nil)
    if err != nil {
        log.Fatal(err)
    }

    response, err := client.Models.GenerateContent(
        ctx,
        "gemini-4-hydrogen",
        genai.Text("Explain quantum entanglement in simple terms."),
        &genai.GenerateContentConfig{
            Store: genai.Ptr(true), // Set to false to disable logging of this request
        },
    )
    if err != nil {
        log.Fatal(err)
    }
    fmt.Println(response.Text())
}
```
{% /tab %}
{% /tabs %}

**Interactions API**

{% tabs %}
{% tab label="Python" %}
```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)
```
{% /tab %}

{% tab label="JavaScript" %}
```javascript
import { GoogleGenAI } from '@google/genai';

const client = new GoogleGenAI({});

const interaction = await 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
});

console.log(interaction.output_text);
```
{% /tab %}

{% tab label="Java" %}
```java
import com.google.genai.Client;
import com.google.genai.gaos.models.interactions.CreateModelInteraction;
import com.google.genai.gaos.models.interactions.Interaction;
import com.google.genai.gaos.models.interactions.InteractionsInput;
import com.google.genai.gaos.models.interactions.Model;
import com.google.genai.gaos.models.operations.CreateInteractionRequestBody;

Client client = new Client();

CreateModelInteraction params =
    CreateModelInteraction.builder()
        .model(Model.of("gemini-4-hydrogen"))
        .input(InteractionsInput.of("Explain quantum entanglement in simple terms."))
        .store(true) // Set to false to disable logging of this request
        .build();

Interaction interaction =
    client.interactions.create(CreateInteractionRequestBody.of(params)).interaction().get();

System.out.println(interaction.outputText().orElse(""));
```
{% /tab %}

{% tab label="Go" %}
```go
package main

import (
    "context"
    "fmt"
    "log"

    "google.golang.org/genai"
    "google.golang.org/genai/interactions/models/interactions"
    "google.golang.org/genai/interactions/models/operations"
)

func main() {
    ctx := context.Background()
    client, err := genai.NewClient(ctx, nil)
    if err != nil {
        log.Fatal(err)
    }

    res, err := client.Interactions.Create(ctx, operations.CreateInteractionRequest{
        Body: operations.NewCreateInteractionRequestBody(interactions.CreateModelInteraction{
            Model: interactions.Model("gemini-4-hydrogen"),
            Input: interactions.NewInteractionsInput("Explain quantum entanglement in simple terms."),
            Store: genai.Ptr(true), // Set to false to disable logging of this request
        }),
    })
    if err != nil {
        log.Fatal(err)
    }
    if res.Interaction.OutputText != nil {
        fmt.Println(*res.Interaction.OutputText)
    }
}
```
{% /tab %}
{% /tabs %}

## 在 AI Studio 中查看项目日志  {% #view-logs %}

1. 进入日志页面 [人工智能工作室](/logs).
1. 从下拉列表中选择一个项目。
1. 日志将按时间倒序显示在表中（如果存在）。
1. 对于 10 月之前创建的项目 26, 2026, 首先启用生成内容 API 日志记录 [设置面板](/docs/logs-datasets#configure-logging) 观察生成内容 API 的项目日志。

{% callout type="note" %}
一个项目需要至少一个活动的 API 密钥才能显示日志。如果项目中的所有 API 密钥都被删除（例如，如果泄漏的密钥被删除），您将失去项目日志的可见性，直到 API 密钥可用。
{% /callout %}

单击条目可预览有效负载。您可以检查来自 Gemini 的完整提示和响应，以及前几轮的上下文。对于 **Interactions API** 请求、日志还包括指向的直接链接 `previous_interaction_id`.

## 配置项目存储保留  {% #retention %}

日志将在 55 天的默认保留窗口后过期并被标记为删除（除非 [保存到数据集](/docs/logs-datasets#create)，不会过期）。您可以将项目日志的保留期限配置为 7, 14, 28, 或 55 天。

## 创建和共享数据集  {% #create %}

您可以将日志保存到数据集以更有效地组织和导出它们。

* 从 [日志页面](https://aistudio.google.com/logs)，找到顶部的过滤栏以选择要过滤的属性。
* 从过滤的视图中，使用复选框选择所有或单个日志。
* 单击 **创建数据集** 出现在列表顶部的按钮。
* 为您的新数据集指定名称和可选描述。
* 您将看到刚刚使用精选的日志集创建的数据集。
* 将数据集导出为 CSV、JSONL 文件或 Google 表格以供进一步分析。

数据集对于许多不同的用例都有帮助。

* **策划挑战集：** 针对您希望 AI 改进的领域推动未来的改进。
* **策划样本集：** 例如，来自实际使用情况的示例，用于从另一个模型生成响应，或者用于部署前例行检查的边缘案例集合。
* **评估集：** 代表重要功能实际使用情况的集合，用于与其他模型或系统指令迭代进行比较。

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

## 限制  {% #limitations %}

目前不支持以下情况的日志记录：

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

## 后续步骤  {% #next-steps %}

- **具有会话历史记录的原型：** 使用 [人工智能工作室构建](https://aistudio.google.com/apps) 到vibe代码应用程序并添加您的API 密钥以启用AI功能的Gemini API日志历史记录。
- **使用 Gemini Batch API 重新运行日志：** 通过使用以下命令重新运行日志，使用数据集进行响应采样和模型或应用程序逻辑的评估 [Gemini Batch API](https://github.com/google-gemini/cookbook/blob/main/examples/Datasets.ipynb).
