{"slug": "copilot-usage-metrics-api-adds-agent-app-activity", "title": "Copilot usage metrics API adds agent app activity", "summary": "GitHub's Copilot usage metrics API now reports agent app activity, broken out by individual agent, with a new optional `totals_by_3rd_party_agent` array in enterprise, organization, enterprise-user, and organization-user 1-day and 28-day reports. The array includes each agent's display name, stable `agent_id`, `user_initiated_interaction_count` (agent app job starts), and `session_count` (in aggregated reports only), enabling teams to track adoption of agents like Claude and Codex separately. The change is backward compatible and available to users with the View Copilot Metrics permission.", "body_md": "# Copilot usage metrics API adds agent app activity\n\nSince agent apps arrived on GitHub, teams have been able to run agents from partners like Claude and Codex directly in their GitHub workflows. The Copilot usage metrics API now reports that activity, broken out by individual agent. The usage metrics API does this in the enterprise, organization, enterprise-user, and organization-user 1-day and 28-day reports.\n\n[What’s new](#whats-new)\n\nA new optional `totals_by_3rd_party_agent`\n\narray contains one entry per recognized agent app. Each entry includes:\n\n: The agent’s display name. Display names can change, so group on`agent_name`\n\n`agent_id`\n\nrather than this field.: The agent’s stable identifier, and the right key for joining across reporting periods.`agent_id`\n\n: The number of user-initiated agent app job starts.`user_initiated_interaction_count`\n\n: The number of agent app sessions. Included in the aggregated enterprise and organization reports only. Per-user entries omit this field.`session_count`\n\n[Why this matters](#why-this-matters)\n\nUntil now, agent activity in your usage metrics was effectively a single bucket, so there was no way to tell Copilot coding agent work apart from work done through other agents. As teams adopt more than one agent, that made it hard to answer basic questions: which agents are actually being used, by how many people, and how does adoption of a newly rolled-out agent compare to the one it was meant to supplement.\n\nBreaking activity out per agent lets you distinctly track each agent app, compare adoption across them, and ground rollout and licensing decisions in real usage rather than assumption.\n\n[Important notes](#important-notes)\n\n- The nested\n`user_initiated_interaction_count`\n\ncounts agent app job starts. It is**distinct** from the top-level field of the same name, which counts explicit prompts from other supported telemetry. Do not sum the two or treat them as interchangeable. - Activity is aggregated by agent, so multiple apps belonging to the same agent are collapsed into one entry. Activity from agents that cannot be identified is omitted.\n- These metrics are available to enterprise owners and billing managers, organization owners, and anyone with a custom organization or enterprise role that grants the\n`View Copilot Metrics`\n\npermission. The Copilot usage metrics policy must be enabled. - The change is backward compatible. Existing fields keep their current shape, and reports omit\n`totals_by_3rd_party_agent`\n\nentirely when there is no recognized agent app activity for the reporting period.\n\nVisit the [Copilot usage metrics API documentation](https://docs.github.com/rest/copilot/copilot-usage-metrics) to get started, or see [Agent apps metrics fields](https://docs.github.com/copilot/reference/copilot-usage-metrics/copilot-usage-metrics#agent-apps-metrics-fields) for the full field definitions.", "url": "https://wpnews.pro/news/copilot-usage-metrics-api-adds-agent-app-activity", "canonical_source": "https://github.blog/changelog/2026-08-07-copilot-usage-metrics-api-adds-agent-app-activity", "published_at": "2026-08-07 18:20:47+00:00", "updated_at": "2026-08-09 09:08:33.684588+00:00", "lang": "en", "topics": ["developer-tools", "ai-agents", "ai-products"], "entities": ["GitHub", "Copilot", "Claude", "Codex"], "alternates": {"html": "https://wpnews.pro/news/copilot-usage-metrics-api-adds-agent-app-activity", "markdown": "https://wpnews.pro/news/copilot-usage-metrics-api-adds-agent-app-activity.md", "text": "https://wpnews.pro/news/copilot-usage-metrics-api-adds-agent-app-activity.txt", "jsonld": "https://wpnews.pro/news/copilot-usage-metrics-api-adds-agent-app-activity.jsonld"}}