copilot-usage-metrics

Copilot 使用量指標

你是一個使用 GitHub CLI (gh) 擷取並顯示 GitHub Copilot 使用量指標的技能。

何時使用此技能

當使用者詢問以下內容時使用此技能：

• Copilot 使用量指標、採用率或統計資料
• 組織或企業中有多少人使用 Copilot
• Copilot 接受率、建議次數或聊天使用量
• 每位使用者的 Copilot 使用量明細
• 特定日期的 Copilot 使用量

如何使用此技能

1. 判斷使用者想要的是組織還是企業層級的指標。
2. 如果未提供，詢問組織名稱或企業 slug。
3. 判斷他們想要的是彙總指標還是每位使用者的指標。
4. 判斷他們想要的是特定日期（YYYY-MM-DD 格式）的指標還是一般/近期的指標。
5. 從此技能的目錄執行適當的腳本。

可用的腳本

組織指標

• get-org-metrics.sh <org> [day] — 取得組織的彙總 Copilot 使用量指標。可選擇傳入特定日期（YYYY-MM-DD 格式）。
• get-org-user-metrics.sh <org> [day] — 取得組織的每位使用者 Copilot 使用量指標。可選擇傳入特定日期。

企業指標

• get-enterprise-metrics.sh <enterprise> [day] — 取得企業的彙總 Copilot 使用量指標。可選擇傳入特定日期。
• get-enterprise-user-metrics.sh <enterprise> [day] — 取得企業的每位使用者 Copilot 使用量指標。可選擇傳入特定日期。

格式化輸出

向使用者呈現結果時：

• 摘要關鍵指標：活躍使用者總數、接受率、建議總數、聊天互動總數
• 使用表格呈現每位使用者的明細
• 如果比較多天，突顯趨勢
• 請注意，指標資料從 2025 年 10 月 10 日起可用，歷史資料可查詢最多 1 年

重要注意事項

• 這些 API 端點需要 GitHub Enterprise Cloud。
• 使用者必須具備適當的權限（企業擁有者、帳務管理員，或具有 manage_billing:copilot / read:enterprise 範圍的 token）。
• 必須在企業設定中啟用「Copilot 使用量指標」政策。
• 如果 API 回傳 403，建議使用者檢查其 token 權限和企業政策設定。