O Copilot painel de métricas de uso e as APIs exibem e exportam dados usando um conjunto consistente 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 Copilot painéis de métricas de uso estão disponíveis no nível da empresa e da organização .
- As Copilot APIs de métricas de uso dão suporte a registros empresariais, organizacionais e de nível de usuário .
Para obter diretrizes sobre como ler e interpretar essas métricas, consulte Métricas de uso do GitHub Copilot.
Copilot painel de métricas de uso
Essas métricas aparecem diretamente no Copilot painel de uso. Esses gráficos não incluem CLI do Copilot uso.
| Métrica | Description |
|---|---|
| Adoção do agente | Porcentagem de Copilotusuários ativos licenciados que experimentaram um agente no mês do calendário atual. |
| 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 durante uma janela 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 usadas 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 por Copilot recurso (pergunta, edição, planejamento, 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 Copilot métricas de uso. Eles fornecem registros diários no âmbito empresarial, organizacional ou do usuário, dependendo da métrica.
Por exemplo, esquemas dos dados retornados pelas APIs, consulte Esquema de exemplo para métricas de uso de Copilot.
| Campo | Description |
|---|---|
agent_edit | Captura linhas adicionadas e excluídas quando Copilot (no modo de 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 distintos 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 para adicionar (complementos, chat embutido, painel de chat etc.; exclui as edições do agente). |
| loc_suggested_to_delete_sum | Linhas de código Copilot sugeridas para excluir (suporte futuro planejado). |
| 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 Copilot recurso (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). Quando Seleção de modelo automática está habilitada, a atividade é atribuída ao modelo real usado em vez de aparecer como Auto. |
| last_known_ide_version / last_known_plugin_version | Os IDEs e as versões de extensões mais recentes detectadas para cada usuário. |
| daily_active_cli_users | Número de usuários exclusivos na empresa ou organização que usaram Copilot por meio 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 ou organizações sem uso da CLI naquele dia. |
| totals_by_cli | Detalhamento de métricas específicas da CLI para a empresa, organização ou usuário 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 quando não há uso da CLI nesse dia. Veja CLI do Copilot os campos de métricas abaixo. |
| used_cli | Captura se o usuário usou CLI do Copilot esse dia. |
| used_agent | Captura se o usuário usou o modo de agente no IDE naquele dia. Não inclui a atividade Revisão de código do Copilot, que é capturada separadamente em used_copilot_code_review_active e used_copilot_code_review_passive. |
| used_chat | Captura se o usuário usou o chat IDE naquele dia. |
| used_copilot_code_review_active | Captura se o usuário se envolveu ativamente com Revisão de código do Copilot esse dia. Um usuário é considerado ativo se solicitou manualmente uma Copilot revisão ou aplicou uma Copilot sugestão de revisão. |
| used_copilot_code_review_passive | Captura se o usuário teve Copilot atribuído automaticamente para revisar seu pull request naquele dia, sem participar ativamente da revisão. |
CLI do Copilot campos de métricas (somente API)
O totals_by_cli objeto contém os seguintes campos aninhados quando o uso da CLI está presente.
| Campo | Description |
|---|---|
totals_by_cli.session_count | Número de sessões distintas da CLI iniciadas neste dia. |
totals_by_cli.request_count | Número total de solicitações feitas para Copilot via CLI neste dia, incluindo prompts iniciados pelo usuário e chamadas de acompanhamento feitas por agentes automatizados. |
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 | A versão mais recente CLI do Copilot foi detectada para o usuário naquele dia. |
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 de solicitação pull, revisão, mesclagem e sugestão no escopo da empresa ou da organização, incluindo a atividade executada por 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 pull requests criados por Copilot neste dia específico. |
pull_requests.total_reviewed_by_copilot | Número de solicitações de pull revisadas por 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 pull requests criados por Copilot que foram mesclados 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 das solicitações de pull, criadas por Copilot e mescladas neste dia específico. |
pull_requests.total_copilot_suggestions | Número de sugestões de revisão de pull requests geradas por Copilot neste dia específico. |
pull_requests.total_copilot_applied_suggestions | Número de sugestões de revisão de pull request geradas por Copilot que foram aplicadas neste dia específico. |