O painel de controle de métricas de uso do Copilot e as APIs exibem e exportam dados utilizando um conjunto padronizado de campos. Essa referência lista todas as métricas disponíveis e descreve como interpretar seus valores em visuais de painel e exportações de NDJSON ou API.
- Os painéis de métricas de uso do Copilot estão disponíveis nos níveis de empresa e organização.
- As APIs de métricas de uso Copilot suportam registros de nível empresarial, organizacional e de usuário.
Para obter diretrizes sobre como ler e interpretar essas métricas, consulte Métricas de uso do GitHub Copilot.
métricas do painel uso Copilot
Essas métricas aparecem diretamente no painel de uso do Copilot. Esses gráficos não incluem o uso de CLI do Copilot.
| Métrica | Description |
|---|---|
| Adoção do agente | Porcentagem de usuários ativos licenciados por Copilot que experimentaram um agente no mês corrente do calendário. |
| Média de solicitações de chat por usuário ativo | Número médio de solicitações de chat por usuário ativo. |
| Preenchimentos de código (sugeridas/aceitas) | Número total de sugestões de código em linha mostradas e aceitas. |
| Taxa de aceitação de conclusão de código | Percentual de sugestões aceitas pelos usuários. |
| Usuários ativos diários | Número de usuários exclusivos que usaram Copilot em um determinado dia. |
| Usuários ativos semanais | Número de usuários exclusivos que usaram Copilot em um período de sete dias. |
| Total de usuários ativos | Usuários licenciados ativos no mês do calendário atual. |
| Uso do idioma | Distribuição de linguagens de programação utilizadas com Copilot. |
| Uso de idioma por dia | Detalhamento diário dos idiomas usados. |
| Uso do modelo | Distribuição de modelos de IA usados para chat. |
| Utilização do modelo por dia | Detalhamento diário do uso do modelo de chat. |
| Uso de modelo por modo de chat | Uso do modelo pelo recurso Copilot (perguntar, editar, planejar, agente). |
| Uso de modelo por idioma | Distribuição de idiomas divididos por modelo. |
| Modelo de chat mais usado | O modelo de chat mais usado nos últimos 28 dias. |
| Solicitações por modo de chat | Número de solicitações de chat por modo (pergunte, edite, planeje, agente). |
Métricas do painel de geração de código
Essas métricas aparecem no painel de geração de código e fornecem uma divisão de como o código está sendo gerado entre atividades iniciadas pelo usuário e iniciadas pelo agente. Todos os valores são derivados de linhas de código (LoC) adicionadas ou excluídas no IDE.
| Métrica | Description |
|---|---|
| Linhas de código alteradas com IA | Total de linhas de código adicionadas e excluídas em todos os modos nos últimos 28 dias. |
| Contribuição do agente | Percentual de linhas de código adicionadas e excluídas por agentes (incluindo editar, agente e modos personalizados) nos últimos 28 dias. |
| Número médio de linhas excluídas pelo agente | Número médio de linhas excluídas automaticamente por agentes em nome de usuários ativos durante o mês do calendário atual. |
| Total diário de linhas adicionadas e excluídas | Número total de linhas adicionadas e excluídas da base de código em todos os modos para cada dia. |
| Alterações de código iniciadas pelo usuário | Linhas sugeridas ou adicionadas manualmente pelos usuários por meio de conclusões de código e ações do painel de chat (inserir, copiar ou aplicar). |
| Alterações de código iniciadas pelo agente | Linhas adicionadas ou excluídas automaticamente da base de código por agentes em nome de usuários nos modos de edição, agente e personalizado. |
| Alterações de código iniciadas pelo usuário por modelo | Linhas de código iniciadas pelo usuário, agrupadas por modelo usado no IDE. |
| Alterações de código iniciadas pelo agente por modelo | Linhas de código iniciadas pelo agente, agrupadas por modelo executando as ações do agente. |
| Alterações de código iniciadas pelo usuário por idioma | Linhas de código iniciadas pelo usuário, agrupadas pela linguagem de programação. |
| Alterações de código iniciadas pelo agente por idioma | Linhas de código iniciadas pelo agente, agrupadas pela linguagem de programação. |
Campos de API e exportação
Esses campos aparecem nos relatórios NDJSON exportados e nas APIs de métricas de uso Copilot . Eles fornecem registros diários no âmbito empresarial, organizacional ou do usuário, dependendo da métrica.
| Campo | Description |
|---|---|
agent_edit | Captura linhas adicionadas e excluídas quando Copilot (no modo agente e edição) grava alterações diretamente em seus arquivos no IDE. |
`agent_edit` não está incluído em métricas baseadas em sugestões e pode não preencher campos de estilo de sugestão (por exemplo, `user_initiated_interaction_count`). Conta edições de agentes personalizados também. |
| report_start_day / report_end_day | Datas de início e término do período de relatórios de 28 dias. |
| day | Dia do calendário que este registro representa. |
| enterprise_id | ID exclusiva da empresa. |
|
organization_id (Somente API) | ID exclusivo da organização. |
| user_id / user_login | Identificador exclusivo e GitHub nome de usuário para o usuário. |
| user_initiated_interaction_count | Número de prompts explícitos enviados para Copilot.
Conta apenas mensagens ou prompts enviados ativamente para o modelo. Não inclui abrir o painel de bate-papo, alternar entre modos (por exemplo, perguntar, editar, planejar ou agente), usar atalhos de teclado para abrir a interface do usuário embutida ou fazer alterações na configuração. |
| chat_panel_agent_mode | Captura interações iniciadas pelo usuário no painel de chat com o modo de agente selecionado. |
| chat_panel_ask_mode | Captura interações iniciadas pelo usuário no painel de chat com o modo de solicitação selecionado. |
| chat_panel_custom_mode | Captura interações iniciadas pelo usuário no painel de chat com um agente personalizado selecionado. |
| chat_panel_edit_mode | Captura interações iniciadas pelo usuário no painel de chat com o modo de edição selecionado. |
| chat_panel_unknown_mode | Captura interações iniciadas pelo usuário no painel de chat em que o modo é desconhecido. |
| code_generation_activity_count | Número de eventos de saída Copilot gerados.
Inclui: Todo o conteúdo gerado, incluindo comentários e docstrings.
Vários blocos: Cada bloco de código distinto de um único prompt de usuário conta como uma geração separada.
Nota: Essa métrica não é diretamente comparável a user_initiated_interaction_count, uma vez que um prompt pode produzir várias gerações. |
| code_acceptance_activity_count | Número de sugestões ou blocos de código aceitos pelos usuários.
Conta: Todas as ações de aceitação internas, como "aplicar ao arquivo", "inserir no cursor", "inserir no terminal" e usar o botão Copiar .
Não conta: Ações manuais da área de transferência do sistema operacional (por exemplo, Ctrl+C).
Granularidade: Cada ação de aceitação incrementa a contagem uma vez, independentemente de quantos blocos de código foram gerados pelo prompt inicial. |
| loc_suggested_to_add_sum | Linhas de código Copilot sugeridas a adicionar (preenchimentos, chat embutido, painel de chat etc.; exclui edições do agente). |
| loc_suggested_to_delete_sum | Linhas de código Copilot sugeridas para exclusão (planejamento de suporte futuro). |
| loc_added_sum | Linhas de código realmente adicionadas ao editor (conclusões aceitas, blocos de código aplicados, modo agente/edição). |
| loc_deleted_sum | Linhas de código excluídas do editor (atualmente de edições de agente). |
| totals_by_ide | Detalhamento das métricas por IDE usadas. |
| totals_by_feature | Detalhamento das métricas por funcionalidade do Copilot (por exemplo, chat embutido, painel de chat). |
| totals_by_language_feature | Detalhamento combinando dimensões de funcionalidades e linguagem. |
| totals_by_model_feature / totals_by_language_model | Detalhamentos específicos do modelo para atividade de chat (não conclusões). |
| last_known_ide_version / last_known_plugin_version | A versão mais recente do IDE e da extensão Chat Copilot detectada para cada usuário. |
| daily_active_cli_users | NNúmero de usuários únicos na empresa que utilizaram Copilot através da CLI em um determinado dia. Esse campo é independente das contagens de usuários ativos do IDE e não está incluído nas definições de usuário ativo baseadas em IDE. Omitido para empresas sem uso da CLI naquele dia. |
| totals_by_cli | Detalhamento de métricas específicas da CLI para a empresa em um determinado dia. Independente das métricas do IDE — o uso da CLI não é refletido em outros campos, como totals_by_ide ou totals_by_feature. Omitido para empresas sem uso da CLI naquele dia. Consulte os campos de métricas CLI do Copilot abaixo. |
| used_cli | Captura se o usuário usou CLI do Copilot naquele dia. |
| used_agent | Captura se o usuário usou o modo de agente IDE naquele dia. |
| used_chat | Captura se o usuário usou o chat IDE naquele dia. |
CLI do Copilot campos de métrica (somente API)
O totals_by_cli objeto contém os seguintes campos aninhados quando o uso da CLI está presente. No momento, essas métricas só estão disponíveis nos relatórios de nível empresarial e de nível de usuário.
| Campo | Description |
|---|---|
totals_by_cli.session_count | Número de sessões distintas da CLI iniciadas neste dia. |
totals_by_cli.request_count | NúmerNúmero total de solicitações feitas ao Copilot por meio da CLI neste dia, incluindo solicitações iniciadas pelo usuário e chamadas de acompanhamento automatizadas do agente. |
totals_by_cli.token_usage.output_tokens_sum | Número total de tokens de saída gerados em todas as solicitações da CLI neste dia. |
totals_by_cli.token_usage.prompt_tokens_sum | Número total de tokens de prompt enviados em todas as solicitações da CLI neste dia. |
totals_by_cli.token_usage.avg_tokens_per_request | Número médio de tokens de saída e prompt por solicitação da CLI, computado como (output_tokens_sum + prompt_tokens_sum) ÷ request_count. |
totals_by_cli.prompt_count | Número total de prompts, comandos ou consultas do usuário executados em uma sessão. |
totals_by_cli.last_known_cli_version | Naquele dia, a versão mais recente do Copilot CLI foi detectada para o usuário. |
Campos de atividade de pull request (somente API)
Importante
Os relatórios de nível organizacional e empresarial podem mostrar totais diferentes devido a diferenças na deduplicação do usuário e no timing de atribuição. Para obter diretrizes sobre como interpretar métricas de solicitação de pull entre escopos, consulte Métricas de uso do GitHub Copilot.
Esses campos capturam atividades diárias de criação, revisão, mesclagem e sugestão de solicitação pull no escopo da empresa ou da organização, incluindo a atividade executada pelo Copilot.
| Campo | Description |
|---|---|
pull_requests.total_created | Número total de solicitações de pull criadas neste dia específico. A criação é um evento único. Cada solicitação de pull é contada somente no dia em que é criada. |
pull_requests.total_reviewed | Número total de solicitações de pull revisadas neste dia específico. A mesma solicitação de pull pode ser contada em dias diferentes se receber revisões em mais de um dia. No decorrer de um único dia, cada pull request é contado uma vez, mesmo se várias ações de revisão ocorrerem. |
pull_requests.total_merged | Número total de solicitações de pull mescladas neste dia específico. A mesclagem é um evento único. Cada solicitação de pull é contada somente no dia em que é mesclada. |
pull_requests.median_minutes_to_merge | Tempo médio, em minutos, entre a criação da solicitação pull e a mesclagem para solicitações pull mescladas neste dia específico. A mediana é usada para reduzir o impacto de valores atípicos em solicitações pull incomumente longas. |
pull_requests.total_suggestions | Número total de sugestões de revisão de solicitação de pull geradas neste dia específico, independentemente do autor. |
pull_requests.total_applied_suggestions | Número total de sugestões de revisão de solicitações pull que foram aplicadas neste dia específico, independentemente do autor. |
pull_requests.total_created_by_copilot | Número de solicitações pull criadas pelo Copilot neste dia específico. |
pull_requests.total_reviewed_by_copilot | Número de solicitações pull revisadas pelo Copilot neste dia específico. Uma solicitação de pull poderá ser contada em vários dias se Copilot revisá-la em vários dias. |
pull_requests.total_merged_created_by_copilot | Número de solicitações pull criadas pelo Copilot que foram mescladas neste dia específico. Cada solicitação de pull é contada somente no dia em que é mesclada. |
pull_requests.median_minutes_to_merge_copilot_authored | Tempo médio, em minutos, entre a criação e a mesclagem de solicitações pull criadas pelo Copilot e mescladas neste dia específico. |
pull_requests.total_copilot_suggestions | Número de sugestões de revisão de solicitações pull geradas pelo Copilot neste dia específico. |
pull_requests.total_copilot_applied_suggestions | Número de sugestões de revisão de solicitações pull geradas pelo Copilot que foram aplicadas neste dia específico. |