Sobre Copilot métricas de uso
Copilot as métricas de uso ajudam as principais partes interessadas e tomadores de decisão a entender como suas equipes estão adotando e usando o 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 APIs para métricas de uso Copilot, que fornecem dados detalhados e exportáveis nos níveis empresarial, organizacional e de usuário.
- O painel de métricas de utilização do Copilot, que visualiza as tendências de uso de 28 dias em toda a sua empresa e 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 do Copilot, que oferece dados brutos para ferramentas personalizadas de BI ou armazenamento a longo prazo.
Qual uso está incluído?
Copilot as métricas de uso são derivadas da telemetria em várias superfícies Copilot , incluindo a atividade IDE e CLI do Copilot . 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 superfícies Copilot , como:
- Chat Copilot no GitHub.com
- GitHub Mobile de dados
Os dados de gerenciamento de licenças e assentos não estão incluídos nos relatórios de métricas de uso Copilot. Para exibir ou gerenciar atribuições de licença, use a API de gerenciamento de usuário Copilot de dados, 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 as métricas de uso de Copilot podem variar entre os recursos da API
Os recursos de API a seguir expõem dados relacionados a Copilot, mas eles 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 API de métricas de uso Copilot para novas integrações e análises, pois ela fornece a visão mais completa e voltada para o futuro do uso do Copilot.
| 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 de assentos atribuídos Copilot para uma organização ou empresa, incluindo o estado da licença, 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. |
|
Endpoints da API REST para métricas do Copilot | Métricas de uso no nível da empresa, da organização e da equipe | Fornece dados de uso agregados para recursos do Copilot no GitHub.com (como resumos de solicitações de pull) e algumas conclusões e bate-papo baseados em IDE. Não inclui telemetria do modo Agente ou de Edição. Oferece detalhamentos em nível corporativo e por funcionalidade, organizados por IDE e idioma. Não inclui dados de nível individual. |
Como as métricas são atribuídas entre organizações?
Observação
Você pode conceder visibilidade apenas para organização nas métricas de uso de Copilot sem fornecer acesso ao nível empresarial.
Você pode fazer isso criando uma função personalizada da organização que inclua a permissão "Visualizar métricas da organização Copilot" e atribuindo essa função aos usuários que precisam de visibilidade das métricas de uma única organização. Confira Permissões de funções de organização personalizadas.
As métricas de uso de Copilot no nível de 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, é necessário que o usuário tenha uma estação ativa do Copilot atribuída 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.
As análises Copilot de nível de organização estão disponíveis 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 assento Copilot 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. Quando os dados estiverem disponíveis, as métricas refletem o local de trabalho (sua afiliação organizacional), não qual organização oferece o assento Copilot ou a origem da atividade.
IDEs compatíveis
Para serem incluídos nas métricas de uso do Copilot, os usuários finais devem usar uma das seguintes IDEs e versões Chat Copilot.
| IDE | Versão mínima do IDE | Versão mínima da extensão Chat Copilot |
|---|---|---|
| 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 de dados | 1.101 | 0.28.0 |
| Xcode | 13.2.1 | 0.40.0 |
Atualização dos dados
Os dados no painel de métricas de uso Copilot e nos relatórios de API são atualizados em uma programação 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, Linhas de Código (LoC) e métricas de ciclo de vida de pull request.
**A adoção** mede quantos desenvolvedores licenciados estão usando ativamente Copilot. Por exemplo, o DAU (usuários ativos diários) 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.
**Medidas de engajamento** descrevem como os desenvolvedores usam Copilot uma vez que adotaram. 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 com 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 as sugestões de Copilot. 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 que Copilot sugeriu, adicionou ou excluiu no editor, fornecendo uma visão direcional da saída tangível de Copilot. Por exemplo, "Linhas adicionadas" mostra a quantidade de código realmente aceita e inserida no editor.
**Métricas do ciclo de vida de Pull Request** medem como a atividade do Copilot se relaciona com os resultados dos Pull Requests 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ções pull com as solicitações pull criadas pelo Copilot, você pode avaliar como os fluxos de trabalho assistidos por IA influenciam o desempenho e o tempo de ciclo no nível da organização ou da empresa.
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 do Copilot por suas equipes.
| Pergunta | Usar essas métricas |
|---|---|
| Minhas equipes estão utilizando Copilot de forma regular? | 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 na saída do 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 o throughput dos 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 métrica de Copilot 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 as métricas de uso do Copilot programaticamente, consulte Endpoints da API REST para métricas de uso do Copilot.