本指南包含开始为现有 Gemini API 应用启用日志记录所需的一切信息。在本指南中,您将了解如何在 Google AI Studio 信息中心内查看现有应用或新应用的日志,以便更好地了解模型行为以及用户与应用互动的方式。您可以使用日志记录来观察和调试,还可以选择性地与 Google 分享使用情况反馈,以帮助改进 Gemini 在各种开发者使用情形下的表现。*
所有 GenerateContent 和 StreamGenerateContent API 调用(包括通过 OpenAI 兼容性端点进行的调用)都受支持。
1. 在 Google AI Studio 中启用日志记录
在开始之前,请确保您拥有一个已启用结算的项目。
- 在 Google AI Studio 中打开日志页面。
- 从下拉菜单中选择您的项目,然后按“启用”按钮,默认情况下为所有请求启用日志记录。
您可以为所有项目或特定项目启用或停用日志记录,并随时通过 Google AI Studio 更改这些偏好设置。
2. 在 AI Studio 中查看日志
- 前往 AI Studio。
- 选择您已启用日志记录的项目。
- 您应该会看到日志以反向时间顺序显示在表格中。
点击条目即可查看请求和响应对的完整页面视图。您可以检查完整提示、Gemini 的全卷答完的回答以及上一轮的上下文。请注意,每个项目的默认存储空间上限为 1,000 条日志,而未保存在数据集中的日志将在 55 天后过期。如果您的项目达到存储空间上限,系统会提示您删除日志。
3. 整理和共享数据集
- 在日志表格中,找到顶部的过滤条件栏,选择要过滤的属性。
- 在过滤后的日志视图中,使用复选框选择全部或部分日志。
- 点击列表顶部显示的“创建数据集”按钮。
- 为新数据集添加描述性名称和说明(可选)。
- 您将看到刚刚创建的数据集,其中包含整理后的日志集。
- 将数据集导出为 CSV、JSONL 文件或 Google 表格,以进行进一步分析。
数据集可用于多种不同的使用情形。
- 精选挑战集: 推动未来的改进,以解决您希望 AI 改进的领域。
- 精选样本集: 例如,从实际使用情况中提取样本以生成来自其他模型的响应,或收集边缘情况以在部署前进行例行检查。
- 评估集: 这些集合代表了重要功能在实际使用中的情况,可用于与其他模型或系统指令迭代进行比较。
您可以选择将数据集作为演示示例进行分享,从而帮助推动 AI 研究、Gemini API 和 Google AI Studio 的发展。这样,我们就可以在各种情境中优化模型,并创建对许多领域和应用的开发者都有用的 AI 系统。
后续步骤和测试内容
现在您已启用日志记录,可以尝试以下操作:
- 使用会话记录进行原型设计: 利用 AI Studio Build 来编写代码应用,并添加 API 密钥以启用用户日志记录。
- 使用 Gemini Batch API 重新运行日志: 使用数据集进行响应抽样 和模型或应用逻辑评估,方法是通过 Gemini Batch API 重新运行日志。
兼容性
目前不支持以下内容的日志记录:
- Imagen 和 Veo 模型
- Gemini 嵌入模型
- 包含视频、GIF 或 PDF 的输入