本指南包含所有必要資訊，可協助您開始為現有的 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 的輸入內容