{"slug": "copilot-usage-metrics-api-adds-cohorts-for-ai-adoption", "title": "Copilot usage metrics API adds cohorts for AI adoption", "summary": "GitHub's Copilot usage metrics API now classifies each engaged user into one of four AI adoption phases—Code first, Agent first, Multi-agent, or No cohort—based on their Copilot surface usage over a rolling 28-day window. The new `ai_adoption_phase` field on user-level reports and `totals_by_ai_adoption_phase` array on enterprise- and organization-level reports provide per-phase engagement and activity metrics. This update enables administrators to track cohort progression and target enablement efforts beyond simple active-user counts.", "body_md": "# Copilot usage metrics API adds cohorts for AI adoption\n\nTo help you tell a deeper Copilot adoption story—not just *who* is active, but *how* they’re using Copilot—the [Copilot usage metrics API](https://docs.github.com/enterprise-cloud@latest/rest/copilot/copilot-usage-metrics?apiVersion=2026-03-10) now classifies each engaged user into an AI adoption phase based on their Copilot product usage over a rolling 28-day window. A new `ai_adoption_phase`\n\nfield is available on user-level reports, and a new `totals_by_ai_adoption_phase`\n\narray surfaces per-phase metrics on enterprise- and organization-level reports.\n\n[What’s new](#whats-new)\n\nEach engaged user is assigned to one of four phases based on the Copilot surfaces they’ve used on at least two days in the last 28-day window:\n\n**Phase 0 — No cohort**: User did not meet the engagement criteria for any phase.** Phase 1 — Code first**: User engaged with code completion and/or IDE agent mode.** Phase 2 — Agent first**: User engaged with a single GitHub-based agent surface (i.e., Copilot cloud agent, Copilot code review, or Copilot CLI).**Phase 3 — Multi-agent**: User engaged with two or more GitHub-based agent surfaces, or with the new GitHub Copilot app.\n\nEach `ai_adoption_phase`\n\nvalue includes a `version`\n\nfield (starting at `v1`\n\n) so the classification logic can evolve as Copilot’s product surface grows, without breaking historical context.\n\nOn the enterprise- and organization-level reports, the new `totals_by_ai_adoption_phase`\n\narray groups engagement and activity metrics by phase, including:\n\n- Total engaged users (2-day-in-28 engagement window)\n- User-initiated interaction average\n- Code generation and acceptance activity averages\n- Lines of code added and deleted averages\n- Pull requests created, merged, and reviewed averages\n- Median time-to-merge average\n\nAggregated metrics report the **average** per user within each phase rather than the sum.\n\n[Why this matters](#why-this-matters)\n\n**Tell the maturity story:** Move beyond simple active-user counts and show which Copilot capabilities your developers are actually adopting.**Track cohort progression:** Watch users graduate from code-first usage into agent-first and multi-agent workflows over time.**Target enablement:** Focus training, documentation, and rollout programs on the phases where you see the biggest opportunity.\n\n[Important notes](#important-notes)\n\n- These metrics are available to enterprise administrators and organization owners who have access to\n[Copilot usage metrics](https://docs.github.com/copilot/concepts/copilot-usage-metrics)through the REST API. - You can use this release in combination with the\n[teams filter](https://github.blog/changelog/2026-05-14-team-level-copilot-usage-metrics-now-available-via-api/)ship for greater granularity.\n\nJoin the discussion within [GitHub Community](https://github.com/orgs/community/discussions/categories/announcements).", "url": "https://wpnews.pro/news/copilot-usage-metrics-api-adds-cohorts-for-ai-adoption", "canonical_source": "https://github.blog/changelog/2026-05-29-copilot-usage-metrics-api-adds-cohorts-for-ai-adoption", "published_at": "2026-05-29 21:03:00+00:00", "updated_at": "2026-05-29 21:31:53.295637+00:00", "lang": "en", "topics": ["ai-products", "ai-tools", "artificial-intelligence", "generative-ai", "ai-agents"], "entities": ["GitHub", "Copilot"], "alternates": {"html": "https://wpnews.pro/news/copilot-usage-metrics-api-adds-cohorts-for-ai-adoption", "markdown": "https://wpnews.pro/news/copilot-usage-metrics-api-adds-cohorts-for-ai-adoption.md", "text": "https://wpnews.pro/news/copilot-usage-metrics-api-adds-cohorts-for-ai-adoption.txt", "jsonld": "https://wpnews.pro/news/copilot-usage-metrics-api-adds-cohorts-for-ai-adoption.jsonld"}}