這份指南包含所有必要資訊,可協助您為現有的 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. 管理及分享資料集
- 在記錄表格中,找到頂端的篩選列,選取要篩選的屬性。
- 在篩選後的記錄檢視畫面中,使用核取方塊選取全部或部分記錄。
- 按一下清單頂端的「建立資料集」按鈕。
- 為新資料集提供描述性名稱,並視需要新增說明。
- 您會看到剛建立的資料集,其中包含精選的記錄集。
 
  資料集可用於多種用途。
- 策劃挑戰集:針對您希望 AI 改進的領域,推動未來的改善措施。
- 策劃樣本集:例如,從實際使用情況中取得樣本,以生成另一個模型的回覆,或是收集極端案例,以便在部署前進行例行檢查。
- 評估集:代表重要功能實際用量的集合,可用於比較其他模型或系統指令疊代。
您可以選擇分享資料集做為示範範例,協助推動 AI 研究、Gemini API 和 Google AI Studio 的進展。這讓我們能在各種情境中改良模型,並建立 AI 系統,持續為許多領域和應用程式的開發人員提供實用功能
後續步驟和測試內容
啟用記錄功能後,請嘗試下列幾種做法:
- 使用工作階段記錄建立原型:運用 AI Studio Build 直覺式程式開發工具建立應用程式,並新增 API 金鑰,啟用使用者記錄記錄功能。
- 使用 Gemini Batch API 重新執行記錄:使用資料集進行回應取樣,並透過 Gemini Batch API 重新執行記錄,評估模型或應用程式邏輯。
相容性
目前系統不支援記錄下列項目:
- Imagen 和 Veo
- 含有影片、GIF 或 PDF 的輸入內容