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, repositório e 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.
- O Copilot painel de impacto, que agrupa os usuários em coortes de adoção e conecta essa adoção à saída da solicitação de pull.
- A exportação de métricas de uso no formato NDJSON Copilot, que oferece dados brutos para ferramentas de BI 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 Copilot CLIe agent apps atividade. A maioria das métricas vem da telemetria de IDE do lado do cliente e os usuários finais precisam de telemetria habilitada em seu IDE para os dados mais avançados nessas métricas.
Além disso, as métricas de uso Copilot incorporam telemetria do lado do servidor para identificar usuários ativos que a telemetria do lado do cliente, sozinha, pode não captar. As condições de rede, as configurações de proxy e as configurações do cliente podem impedir que a telemetria do cliente atinja GitHub, portanto, os sinais do lado do servidor garantem que esses usuários ainda apareçam em seus relatórios.
Os usuários exibidos por meio da telemetria do lado do servidor são totalmente contados para os totais de usuário ativos (como usuários ativos diários). daily_active_users Quando disponível, eles também podem aparecer totals_by_ide (incluindo as versões de IDE e Copilot extensão detectadas mais recentemente em relatórios por usuário). No entanto, outras divisões dimensionais , como totals_by_feature e métricas de linhas de código, permanecem vazias até que a telemetria mais rica esteja disponível para elas. Os totais de nível mais alto e os detalhes dos usuários já capturados pela telemetria do cliente permanecem inalterados.
Os dados não incluem atividade de outras Copilot superfícies, como:
- Copilot Chat 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 API de gerenciamento de usuário Copilot, 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 |
|---|---|---|
| Endpoints da API REST para métricas de uso do Copilot | Telemetria avançada de eventos com escopo empresarial e organizacional com relatórios de nível de usuário e repositó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, bem como relatórios de atividade de solicitação de pull no nível do repositório e é o recurso de API principal 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 Copilot atribuídos 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 Copilot Chat versões de extensão.
| IDE | Versão mínima do IDE | Versão mínima Copilot Chat 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.107.1 | 0.35.3 |
| Xcode | 13.2.1 | 0.40.0 |
Atualização dos dados
Os dados nos dashboards e relatórios de API são atualizados em um agendamento regular.
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. Copilot code review A adoção é controlada separadamente, com contagens de usuários ativas e passivas distintas. Os usuários ativos solicitaram manualmente uma revisão ou aplicaram uma sugestão; os usuários passivos tinham Copilot code review atribuído automaticamente para revisar sua solicitação de pull. Quando um usuário tem ambos os sinais no mesmo período, eles são contados apenas como ativos. Para uma visão mais profunda da profundidade da adoção, os usuários também são agrupados em coortes de adoção. Consulte Noções básicas sobre coortes de adoçã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.Copilot Chat 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 IA influenciam a taxa de transferência e o tempo de ciclo em nível organizacional ou empresarial.
Noções básicas sobre coortes de adoção
Em vez de medir a adoção como uma única contagem de usuários ativos, Copilot agrupa os usuários em coortes de adoção com Copilotbase em como eles se envolvem, não apenas se eles se envolvem. Uma contagem simples de usuários ativos trata alguém que ocasionalmente aceita uma conclusão de código da mesma forma que alguém que orquestra vários fluxos de trabalho controlados por agente ao longo do dia. A coorte separa esses dois usuários, para que você possa ver se o uso da sua organização está se aprofundando ao longo do tempo, em vez de se nivelar na avaliação inicial.
Os usuários são agrupados nas seguintes fases:
| Phase | O que ele representa |
|---|---|
| Usuários passivos | O usuário não atingiu o limite de envolvimento de uma fase durante o período. Um usuário passivo ainda pode estar usando Copilot regularmente, por exemplo, fazendo perguntas no Copilot Chat modo de agente ou sem aplicar nenhuma edição de código. Na API, essa fase é rotulada No Cohort. |
| Fase 1: Código primeiro | O usuário envolvido com conclusões de código e/ou edições de agente, em que Copilot grava alterações diretamente em arquivos no IDE. O uso Copilot Chat ou o modo de agente sem produzir a conclusão do código ou a atividade de edição do agente não se qualifica por conta própria. |
| Fase 2: Agente primeiro | O usuário envolvido com uma superfície de agente baseada em um único GitHub, como Copilot cloud agent, Copilot code reviewou Copilot CLI. Tanto o envolvimento ativo com Copilot code review quanto o ter atribuído automaticamente para revisar uma contagem de solicitações pull como a mesma superfície. |
| Fase 3: Vários agentes | O usuário envolvido com duas ou mais GitHubsuperfícies de agente baseadas ou com o GitHub Copilot app. |
Para ser agrupado em uma fase, um usuário deve atender a um limite de envolvimento de pelo menos dois dias ativos fora da janela de 28 dias à direita, usando as superfícies associadas a essa fase. Um usuário só precisa de dois dias de qualificação nas superfícies de uma fase mais alta para progredir para essa fase. O uso do agente sozinho pode qualificar um usuário, sem dias separados de conclusões sem formatação.
A atribuição de fase é recalculada diariamente da janela de 28 dias à direita, de modo que a fase de um usuário pode mudar de um dia para o outro conforme a atividade dentro dessa janela é alterada. Esse é o comportamento esperado, não um erro de dados.
O painel de impacto conta cada usuário que estava ativo durante a janela de 28 dias à direita e agrupa cada usuário pela fase atual. As regras de classificação de fase são as mesmas, mas a população do painel é mais ampla do que o totals_by_ai_adoption_phase.total_engaged_users campo em relatórios de API e NDJSON, que conta os usuários que estavam ativos em um dia específico.
Os usuários que não atingiram o limite de nenhuma fase são agrupados em usuários passivos, o que não é uma medida de inatividade, mas um sinal de que o envolvimento de um usuário ainda não atingiu o nível necessário para classificar de forma confiável sua profundidade de adoção. Por exemplo, um usuário com menos de dois dias ativos na janela de 28 dias à direita ou um que só usa levemente uma superfície como Copilot Chat em GitHub.com, é mostrado como um usuário passivo.
Como a atribuição de fase é baseada em quais superfícies um usuário se envolve, não apenas com quantas ações ele executa, um usuário com alto volume de conclusão, mas nenhum uso de agente permanece na Fase 1, enquanto um usuário com uso mais leve, mas mais amplo em superfícies de agente, progride para a Fase 2 ou Fase 3.
Para os campos de esquema subjacentes, consulte os campos de fase de adoção de IA.
O multiplicador de adoção do painel de impacto divide a quantidade média de solicitações de pull mescladas para usuários envolvidos, que são aqueles na Fase 1, 2 ou 3, pela quantidade de solicitações de pull mescladas para usuários passivos.
Isso mostra o impacto relativo de uma adoção mais profunda, independentemente de quantos usuários se enquadram em cada fase. Essa é uma medida para entender a potencial elevação que se tornar um usuário mais engajado pode fornecer.
Por exemplo, se os usuários das coortes envolvidas tiverem uma média de 20 solicitações de pull/usuário/mês e a coorte passiva tiver uma média de 10, a equação será 20/10 = 2x multiplicador.
Estimando um possível retorno sobre o investimento
A seção Potencial retorno sobre o investimento do painel de impacto fornece uma comparação de custo e saída de solicitação de pull entre os primeiros usuários passivos e de código da fase 0-1 e****os primeiros usuários do agente da fase 2-3.
Para cada grupo de fases, o painel mostra o custo mensal Copilot por desenvolvedor, com base no consumo real AI credits , e esse custo como um percentual de compensação do desenvolvedor. Ele também mostra a média de solicitações de pull por desenvolvedor por mês.
Você pode selecionar uma faixa de compensação para atualizar estimativas que dependem da compensação do desenvolvedor. Esses números são estimativas em vez de resultados financeiros exatos, portanto, interprete-os juntamente com as comparações de código e tempo de mesclagem do multiplicador de adoção. As estimativas de retorno sobre o investimento estão disponíveis apenas no painel e não estão incluídas nas exportações de Copilot API de métricas de uso ou NDJSON.
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 |
| Copilot está influenciando a velocidade de entrega ou a taxa de solicitações de pull? | Número de mesclagens de solicitações pull e tempo mediano de mesclagem |
| Como Copilot code review está sendo adotado? | Contagens de usuários de revisão de código ativo versus passivo |
| A adoção da minha organização está se aprofundando ao longo do tempo? | Tendências de distribuição e engajamento da coorte de adoção |
| Como faço para agir sobre os insights do painel? | Confira Interpretando métricas de uso e adoção para GitHub Copilot |
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.