GitHub Copilot 用量 API 停止保證舊代理欄位，儀表板須改讀 cloud agent 指標

GitHub Copilot 用量指標的一項小型但容易被忽略的 API 遷移已到期。GitHub 在把 Copilot coding agent 更名為 Copilot cloud agent 後，為企業及組織層級的使用者報表加入 `used_copilot_cloud_agent` 欄位；原有的 `used_copilot_coding_agent` 只承諾維持向後相容至 2026 年 8 月 1 日。依官方說明，新舊欄位在過渡期回傳相同、可為 null 的布林值，涵蓋單日及 28 日滾動視窗。

這不是模型或代理能力更新，卻會直接影響企業用來衡量代理採用率、授權效益與治理覆蓋率的資料管線。若 ETL、SQL 模型或 BI 儀表板仍固定選取舊欄位，後續可能出現 schema 錯誤；更難察覺的情況是資料供應端保留欄名卻停止更新，讓代理使用率被低估。以欄位是否存在作為版本判斷也不夠安全，整合端應同時檢查值的新鮮度與 null 比例。

較穩健的遷移方式是先以新欄位為主、舊欄位為回退，短期記錄兩者差異，再移除舊欄位依賴。資料契約可加入 schema 驗證、每日非空率告警及過渡期的雙寫比對；若報表跨越 8 月 1 日，還要確認歷史資料是否仍使用舊名稱，避免同一時間序列被拆成兩項指標。

官方原文使用「不會在 8 月 1 日前棄用」，並不等於當日必然刪除，因此目前不能斷言所有 API 回應已移除舊欄位。工程團隊應以實際端點回應和 GitHub 的 OpenAPI schema 為準，並把此次事件視為相容保證終止，而非已證實的立即下線。