查看 AI 開發人員工具指標

本文說明如何查看貴機構中AI 開發人員工具 (例如 Google Antigravity 和 Antigravity CLI) 的使用指標和遙測資料。這些指標會顯示使用者採用情形、權杖用量、API 呼叫和工具執行情形。

事前準備

查看 AI 開發人員工具指標前，請先確認您符合下列先決條件：

  • 啟用 AI 開發人員工具：如要查看 AI 開發人員工具指標，貴機構必須為專案啟用 AI 開發人員工具。請參閱「啟用 AI 開發人員工具」。

  • 可開立月結單的 Cloud Billing 帳戶：專案必須啟用 Cloud Billing，並使用可開立月結單的帳戶。請參閱「Cloud Billing 帳戶類型」。

  • 支援的版本：使用者必須訂閱 Gemini Enterprise Standard、Plus、Standard Emerging Market 或即付即用版本。

  • 必要角色：如要在Google Cloud 控制台中存取「開發人員工具指標」頁面，您需要具備 Gemini Enterprise 管理員 (roles/discoveryengine.agentspaceAdmin) 角色。

存取指標資訊主頁

如要在 Google Cloud 控制台中查看 AI 開發人員工具指標，請按照下列步驟操作：

  1. 前往 Google Cloud 控制台的「Gemini Enterprise」頁面。

    前往 Gemini Enterprise

  2. 選取您啟用 AI 開發人員工具的 Google Cloud 專案。

  3. 在導覽選單中，按一下「開發人員工具指標」。

  4. 使用資訊主頁右上角的時間範圍控制選項，調整報表時間範圍：

    控制 說明
    時間範圍選取器選單 根據預設，資訊主頁會顯示「過去 1 天」的資料，並啟用自動即時重新整理功能。按一下選單，然後執行下列任一操作：
    • 直接在「相對時間」篩選器欄位中輸入自訂時間長度 (例如 15m、1h、1d 或 1w)。
    • 選取預設的相對時間範圍：「今天」、「昨天」、「過去 15 分鐘」、「過去 30 分鐘」、「過去 1 小時」、「過去 3 小時」、「過去 6 小時」、「過去 12 小時」、「過去 1 天」、「過去 2 天」、「過去 7 天」或「過去 14 天」。
    • 按一下「開始和結束時間」，為報表時間範圍指定自訂開始和結束日期與時間。
    • 按一下「Around a time」(特定時間前後)，指定日期和時間，然後顯示以該時間戳記為中心的指標。
    • 按一下「時區」，為圖表選取其他顯示時區 (例如「太平洋夏令時間 (UTC-7)」)。
    向左和向右箭頭 在選單中選取時間長度，然後按一下「向後移動」圖示 或「向前移動」圖示 ，即可將報表時間範圍向後或向前移動。舉例來說，如果選取「最近 1 天」，按一下 會將圖表往後移動一天。
    縮小時間範圍 按一下 即可縮小特定時間範圍。所有圖表都會更新，顯示縮放後的時間範圍資料。如要放大並重設檢視畫面，請從「時間範圍選取器」選單選取時間長度。
    自動重新整理 查看相對時間範圍時，可以開啟或關閉資訊主頁資料的自動即時重新整理功能。選取絕對時間範圍 (例如自訂開始和結束時間或歷史記錄時間範圍) 時，系統會停用自動重新整理功能，因為自動重新整理功能不支援絕對時間範圍。

探索圖表資料

「開發人員工具指標」資訊主頁上的每個圖表都提供互動式控制項，方便您檢查時間序列、將指標與記錄檔建立關聯，以及分析基礎資料：

控制 說明
資訊 按一下圖表標題旁的「資訊」，即可查看套用至圖表指標查詢的篩選器、分組和匯總屬性詳細資料。
建立快訊政策 在指標折線圖中，按一下圖表工具列中的「建立快訊政策」，即可在 Cloud Monitoring 中開啟快訊工作流程，並預先填入圖表的時間序列查詢。接著，您可以為指標設定閾值條件和通知管道。
探索資料 在圖表工具列中，按一下「探索資料」，即可在 Metrics Explorer 中開啟指標查詢。 在 Metrics Explorer 中，您可以檢查、篩選、分組及修改不同維度中的基礎時間序列查詢，或將自訂檢視畫面儲存至自訂資訊主頁。
以全螢幕模式查看 在圖表工具列中，按一下「更多圖表選項」，然後選取「全螢幕檢視」，即可將圖表展開至全螢幕，詳細檢查時序和圖例資料。
檢查相關記錄 您可以將指標資料與同一時間範圍內寫入的記錄項目建立關聯，藉此排解活動和錯誤問題：
  • 資訊主頁檢視畫面：在圖表工具列中，按一下「更多圖表選項」，然後選取「檢查相關記錄」，開啟分割檢視畫面面板，顯示圖表和相關記錄項目。
  • 資料點工具提示：在任何圖表時間序列中，將指標懸停在特定資料點上，然後從工具提示中選取「檢查相關記錄」。在此模式下，分割畫面面板會篩選記錄項目，時間範圍為所選時間戳記前後五分鐘。

可用的指標

下表列出資訊主頁上顯示的所有指標。

區段 指標名稱 說明
活躍使用者 (採用) 活躍使用者是指在報表時間範圍內，至少啟動過一次 AI 開發人員工具動作 (例如 API 要求、提示或工具執行) 的不重複使用者。
每小時活躍使用人數 (平均) 顯示所選時間範圍內，每小時的平均不重複活躍使用者人數。
每日活躍使用人數 (平均) 顯示所選時間範圍內，每日平均不重複活躍使用者人數。
每週活躍使用人數 (平均) 顯示所選時間範圍內，每週平均不重複活躍使用者人數。
每月活躍使用人數 (平均) 顯示所選時間範圍內，每月不重複活躍使用者 (28 天活躍使用者) 的平均人數。
每小時活躍使用者 這張趨勢折線圖顯示所選時間範圍內，每小時的不重複活躍使用者人數。
每日活躍使用人數 這張趨勢折線圖顯示所選時間範圍內，每天的不重複活躍使用者人數。
每週活躍使用者人數 這張趨勢折線圖顯示所選時間範圍內，每週的不重複活躍使用者人數。
每月活躍使用人數 趨勢折線圖，顯示所選時間範圍內每月的不重複活躍使用者人數 (28 天活躍使用者)。
工具和 API 呼叫 權杖總數 在所選時間範圍內，AI 開發人員工具使用的輸入和輸出內容詞元總數。
每日權杖用量 這張折線圖顯示一段時間內的每日權杖消耗量。
每日 API 呼叫次數 折線圖：顯示 AI 開發人員工具每日的 API 呼叫次數，並按 error_type 標籤細分錯誤 (例如配額限制、驗證錯誤或用戶端錯誤)。
每日工具呼叫次數 折線圖：顯示 AI 開發人員工具每天發起的工具呼叫次數。
每日接受的工具呼叫次數 這張折線圖顯示使用者接受並執行的每日代理程式建議工具呼叫次數。

限制

AI 開發人員工具指標有以下限制：

  • 「每日工具呼叫次數」和「每日接受的工具呼叫次數」指標不會顯示資料。

後續步驟