Copilot 使用情況指標 API 新增 AI 採用階段分類

GitHub 於近日宣佈對其 Copilot 使用情況指標 API 進行重要更新，引入了一項名為“AI 採用階段”（ai_adoption_phase）的新分類功能。該功能旨在幫助管理員更深入地瞭解開發者如何實際使用 Copilot，而不僅僅是追蹤活躍使用者數量。透過將每個活躍使用者根據其在過去 28 天內使用 Copilot 功能的情況劃分為四個階段，管理員可以清晰地看到使用者從基礎程式碼補全到高階多代理工作流的演進路徑。

新的 ai_adoption_phase 欄位現已加入使用者級報告，同時在企業和組織級報告中新增了 totals_by_ai_adoption_phase 陣列，按階段展示聚合指標。每個活躍使用者根據過去 28 天內至少兩天使用不同 Copilot 功能的記錄被分配到以下四個階段之一：

• 階段 0（無佇列）：使用者未達到任何階段的參與標準。
• 階段 1（程式碼優先）：使用者主要使用程式碼補全和/或 IDE 代理模式。
• 階段 2（代理優先）：使用者使用了單一的基於 GitHub 的代理功能，例如 Copilot 雲代理、Copilot 程式碼審查或 Copilot CLI。
• 階段 3（多代理）：使用者使用了兩個或更多基於 GitHub 的代理功能，或者使用了新的 GitHub Copilot 應用。

每個 ai_adoption_phase 值都包含一個版本欄位（起始為 v1），這使得分類邏輯可以隨著 Copilot 產品功能的增長而演進，而不會破壞歷史資料的上下一致性。

在企業級和組織級報告中，新的 totals_by_ai_adoption_phase 陣列按階段提供了多項關鍵指標的平均值，包括：總活躍使用者數（基於 28 天內至少 2 天的參與視窗）、使用者發起互動的平均次數、程式碼生成與接受活動的平均值、程式碼行數增加和刪除的平均值、拉取請求建立、合併和審查的平均值，以及中位合併時間的平均值。需要注意的是，這些聚合指標報告的是每個階段內每位使用者的平均值，而非總和。

為什麼這很重要？首先，它幫助管理員講述使用者成熟度的故事，超越簡單的活躍使用者統計，展示開發者實際採用的 Copilot 能力。其次，可以追蹤使用者的階段進展，觀察使用者如何從程式碼優先逐步過渡到代理優先和多代理工作流。最後，能夠更有針對性地進行賦能，將培訓、文件和推廣計劃聚焦於最具潛力的階段。

重要提示：這些指標目前面向擁有 Copilot 使用情況指標訪問許可權的企業管理員和組織所有者開放，可透過 REST API 獲取。此外，管理員可以將此功能與團隊過濾器結合使用，以獲得更精細的粒度。GitHub 鼓勵使用者在社群中分享反饋，共同探討如何更好地利用這些資料推動 AI 工具在企業中的深度採用。