Sobre métricas de uso de Copilot
Copilot as métricas de uso ajudam os principais stakeholders e tomadores de decisão a entender como suas equipes estão adotando e usando Copilot. Ao acompanhar padrões de uso em toda a empresa, você pode medir o engajamento, identificar oportunidades para aumentar o valor e avaliar como os fluxos de trabalho assistidos por IA influenciam a taxa de transferência de solicitação de pull e o tempo para mesclagem.
As métricas estão disponíveis por meio de:
- As Copilot APIs de métricas de uso, que fornecem dados detalhados e exportáveis nos níveis corporativo, organizacional e de usuário.
- O Copilot painel de métricas de uso, que visualiza as tendências de uso em um período de 28 dias em toda a sua empresa e suas organizações.
- O painel de geração de código, que divide como o código está sendo gerado por usuários e agentes em sua empresa e organizações.
- A exportação de métricas de uso no formato NDJSON oferece dados brutos para ferramentas de Business Intelligence personalizadas ou armazenamento de longo prazo.
Qual uso está incluído?
Copilot as métricas de uso são derivadas da telemetria em várias Copilot superfícies, incluindo IDE e CLI do Copilot atividade. Como muitas métricas vêm da telemetria do IDE, **os usuários finais devem ter a telemetria habilitada em seu IDE para serem incluídas nessas métricas**.
Os dados não incluem atividade de outras Copilot superfícies, como:
-
Chat Copilot em GitHub.com - GitHub Mobile
Os dados de gerenciamento de licenças e assentos não estão incluídos nos Copilot relatórios de métricas de uso. Para exibir ou gerenciar atribuições de licença, use a Copilot API de gerenciamento de usuário, que é a fonte da verdade para informações de licença e assento. Confira Endpoints da API REST para gerenciamento de usuários do Copilot.
Por que Copilot as métricas de uso podem ser diferentes entre os recursos de API
Os recursos de API a seguir expõem Copilotdados relacionados, mas não são intercambiáveis e não devem ser comparados diretamente. Cada recurso de API foi projetado para um caso de uso específico e um modelo de dados, e são esperadas diferenças nos totais ou na cobertura. Use esta tabela para entender qual recurso de API melhor atende às suas necessidades de relatório.
Observação
É altamente recomendável usar a Copilot API de métricas de uso para novas integrações e análises, pois ela fornece a visão mais completa e futura do Copilot uso.
| Recurso de API | Scope | Principais capacidades |
|---|
[AUTOTITLE](/rest/copilot/copilot-usage-metrics) | Telemetria avançada de eventos no nível da empresa, da organização e do usuário | Fornece telemetria unificada para conclusões de tarefas, chat e modos de agente. Inclui métricas de uso e de linhas de código em todos os modos, linguagens e modelos do IDE. Dá suporte a detalhamentos por recurso, IDE, linguagem, modelo e usuário e é o principal recurso de API que está sendo desenvolvido e mantido ativamente. |
|
Endpoints da API REST para gerenciamento de usuários do Copilot | Licença e atribuição de assento | Lista os assentos atribuídos Copilot para uma organização ou empresa, incluindo estado de licença, associação de usuário e last_activity_at. Este recurso da API é a fonte oficial de informações sobre licenças e assentos. |
Como as métricas são atribuídas entre organizações?
Observação
Você pode conceder visibilidade somente da organização nas Copilot métricas de uso sem fornecer acesso de nível empresarial.
Você pode fazer isso criando uma função personalizada da organização que inclui a permissão "Exibir métricas da organização Copilot " e atribuindo essa função a usuários que precisam de visibilidade das métricas para uma única organização. Confira Permissões de funções de organização personalizadas.
As métricas de uso no nível Copilot da organização são baseadas na associação da organização, não no local em que ocorrem ações individuais. Para aparecer nas métricas de uma empresa, um usuário deve ter um assento ativo Copilot atribuído dentro dessa empresa (em qualquer organização que pertença à empresa). Como resultado, o uso de um único usuário pode aparecer em vários painéis da organização, enquanto esse mesmo usuário é contado apenas uma vez no total de nível empresarial. A análise no nível da organização destina-se à visibilidade da adoção e do uso em uma organização e não foi projetada para ser diretamente comparada aos totais de nível empresarial.
A análise no nível Copilot da organização está disponível a partir de 12 de dezembro de 2025. Esta é a primeira data para a qual os relatórios no nível da organização são fornecidos.
Depois que um usuário tem um assento na empresa, seu uso é atribuído a todas as organizações às quais pertence, independentemente de onde o assento é atribuído.
Isso significa:
- Se as licenças forem atribuídas em uma organização dedicada de "shell" para fins administrativos dentro da empresa, os usuários ainda aparecerão nas métricas para todas as outras organizações da empresa à qual pertencem.
- Se um usuário também tiver um Copilot assento em uma organização separada fora da empresa, sua atividade ainda será incluída nas métricas de nível de organização da empresa, desde que tenha pelo menos um assento dentro da empresa.
Resumindo: os usuários devem ser licenciados em algum lugar da empresa para aparecer em suas métricas. Uma vez que estejam, as métricas refletem onde trabalham (sua filiação à organização), não qual organização fornece o Copilot assento ou de onde se originou a atividade.
IDEs compatíveis
Para serem incluídos nas métricas de uso, os Copilot usuários finais devem usar uma das seguintes IDEs e Chat Copilot versões de extensão.
| IDE | Versão mínima do IDE | Versão mínima Chat Copilot da extensão |
|---|---|---|
| Eclipse | 4.31 | 0.9.3.202507240902 |
| JetBrains / IntelliJ | 2024.2.6 | 1.5.52-241 |
| Visual Studio | 17.14.13 | 18.0.471.29466 |
| VS Code | 1.101 | 0.28.0 |
| Xcode | 13.2.1 | 0.40.0 |
Atualização dos dados
Os dados nos Copilot dashboards de métricas de uso e nos relatórios de API são atualizados regularmente.
Você pode esperar que os dados estejam disponíveis dentro de dois dias completos. Isso significa que os dados de um determinado dia são processados e disponibilizados dentro de dois dias UTC completos após o fechamento desse dia.
O que os dados medem?
Copilot as métricas de uso podem ser agrupadas em algumas categorias principais: Adoção, engajamento, taxa de aceitação, LoC (Linhas de Código) e métricas de ciclo de vida de solicitação pull.
**A adoção** mede quantos desenvolvedores licenciados estão usando ativamente Copilot. Por exemplo, "usuários ativos diários" (DAU) informa quantos usuários exclusivos interagiram com Copilot em um determinado dia. O ideal é que você veja uma tendência de alta consistente nessas métricas durante a distribuição.
**As** medidas de engajamento descrevem como os desenvolvedores usam Copilot profundamente depois de adotá-lo. As principais métricas de engajamento mostram não apenas a frequência de uso, mas também a amplitude entre os recursos. Por exemplo, as solicitações médias de chat por usuário ativo medem a frequência com que os usuários abrem e interagem.Chat Copilot Você gostaria de ver o uso regular e crescente de chat entre idiomas e IDEs.
**A taxa de aceitação** mede a frequência com que os desenvolvedores aceitam Copilotsugestões. Isso ajuda você a entender se as sugestões são relevantes e confiáveis. Por exemplo, uma alta taxa de aceitação de sugestões embutidas indica que as sugestões são relevantes e úteis.
**As métricas de Linhas de Código (LoC)** medem o número de linhas sugeridas, adicionadas Copilot ou excluídas no editor, fornecendo uma exibição direcional da Copilotsaída tangível. Por exemplo, "Linhas adicionadas" mostra a quantidade de código realmente aceita e inserida no editor.
**As métricas do ciclo de vida da solicitação de pull** medem como Copilot a atividade se relaciona com os resultados da solicitação de pull e o fluxo de entrega. Essas métricas incluem contagem de pull requests criadas e mescladas, tempo médio para mesclagem e atividade de sugestão de revisão. Comparando a atividade geral de solicitação de pull com solicitações de pull criadas por Copilot, você pode avaliar como os fluxos de trabalho assistidos por Copilot IA influenciam a taxa de transferência e o tempo de ciclo em nível organizacional ou empresarial.
Interpretando métricas de ciclo de vida de pull requests em diferentes escopos
As métricas do ciclo de vida da solicitação pull estão disponíveis no nível da organização e da empresa. Ao comparar relatórios, tenha o seguinte em mente:
-
**Eliminação de duplicação**: relatórios de nível empresarial eliminam duplicação de usuários entre organizações. Os relatórios no nível da organização não são gerados. -
**Dados exclusivamente de solicitações de pull**: As métricas do ciclo de vida da solicitação de pull podem aparecer mesmo na ausência de métricas de uso do IDE, já que esses dados são derivados da atividade do repositório. -
**Tempo de atribuição**: se um repositório ou organização for transferido entre proprietários, os eventos de criação, revisão e mesclagem de solicitação de pull poderão ser atribuídos a entidades diferentes, dependendo de quando cada evento ocorreu.
Como posso usar essas métricas?
Essas métricas podem ser usadas em conjunto para responder às principais perguntas sobre o uso de suas equipes de Copilot.
| Pergunta | Usar essas métricas |
|---|---|
| Minhas equipes estão usando Copilot regularmente? | Usuários ativos diários e semanais |
| Quais recursos oferecem mais valor? | Solicitações por modo de chat, adoção do agente |
| Os desenvolvedores confiam no resultado Copilot? | Tendências de taxa de aceitação |
| Os esforços de habilitação estão funcionando? | Crescimento na adoção e engajamento após campanhas de treinamento ou comunicação |
| Está Copilot influenciando a velocidade de entrega ou a taxa de pull requests? | Número de mesclagens de solicitações pull e tempo mediano de mesclagem |
Procure padrões nesses sinais em vez de se concentrar em qualquer número único. Por exemplo, um DAU estável emparelhado com uma taxa de aceitação crescente indica confiança e valor crescentes.
Próximas etapas
Agora que você entende o que cada Copilot métrica mede e como usá-las, você pode explorar os painéis para ver essas métricas em ação.
- Para exibir tendências de adoção e uso em sua empresa e organizações, consulte Exibindo o painel de métricas de uso do Copilot.
- Para analisar como o código está sendo gerado por usuários e agentes, consulte Exibindo o painel de geração de código.
- Para acessar Copilot as métricas de uso de forma programática, consulte Endpoints da API REST para métricas de uso do Copilot.