GitHub Copilot 使用量 API、旧エージェントフィールドの保証を終了――ダッシュボードは cloud agent 指標への移行が必要

GitHub Copilot の使用量指標に関する、小規模ながら見落とされやすい API 移行の期限が到来した。GitHub は Copilot coding agent を Copilot cloud agent に改称した後、Enterprise および Organization レベルのユーザーレポートに `used_copilot_cloud_agent` フィールドを追加した。従来の `used_copilot_coding_agent` について後方互換性が保証されていたのは、2026年8月1日までに限られる。公式説明によると、移行期間中は新旧両フィールドが同一の nullable なブール値を返し、1日単位および28日間のローリングウィンドウを対象としていた。

これはモデルやエージェント機能のアップデートではないが、企業がエージェントの導入率、ライセンスの効果、ガバナンスのカバレッジを測定するために使用するデータパイプラインへ直接影響する。ETL、SQL モデル、または BI ダッシュボードが旧フィールドを固定的に選択し続けている場合、今後 schema エラーが発生する可能性がある。さらに検出が難しいのは、データ提供側がフィールド名を残したまま値の更新を停止し、エージェント使用率が過小評価されるケースだ。フィールドの有無だけをバージョン判定に用いる方法も十分に安全ではなく、統合側では値の鮮度と null の比率も併せて確認する必要がある。

より堅牢な移行方法は、新フィールドを優先し、旧フィールドをフォールバックとして使用しながら、短期間は両者の差分を記録し、その後に旧フィールドへの依存を削除することだ。データコントラクトには、schema 検証、日次の非 null 率アラート、移行期間中の二重書き込み結果の比較を追加できる。レポートの対象期間が8月1日をまたぐ場合は、履歴データで旧名称が引き続き使われていないかも確認し、同一の時系列が2つの指標に分断されないようにする必要がある。

公式の原文は「8月1日より前には廃止しない」としており、これは同日に必ず削除されるという意味ではない。したがって現時点では、すべての API レスポンスから旧フィールドがすでに削除されたとは断言できない。エンジニアリングチームは、実際のエンドポイントのレスポンスと GitHub の OpenAPI schema を正とし、今回の事象を確認済みの即時停止ではなく、互換性保証の終了として捉えるべきだ。