Dados disponíveis nas métricas de uso do Copilot

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 retornam relatórios no escopo da empresa ou da organização , com granularidades agregadas, de nível de repositório e de relatórios individuais no nível do usuário . As formas variam de acordo com o escopo e a granularidade.
• As métricas de nível de equipe não são pré-agregadas; você os constrói ingressando no relatório de equipes de usuários com o relatório de métricas de uso por usuário. Consulte Métricas de uso de Copilot no nível da equipe.
• Os relatórios em nível de repositório contêm um registro por repositório com atividade de pull request no dia solicitado. Consulte campos no nível do repositório (somente API) mais adiante neste artigo.

Para obter diretrizes sobre como ler e interpretar essas métricas, consulte GitHub Copilot usage metrics.

Copilot métricas do painel de uso

Essas métricas aparecem diretamente no Copilot painel de uso. Esses gráficos não incluem Copilot CLI 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 impacto

Essas métricas aparecem no painel de impacto, que agrupa os usuários em coortes de adoção e relaciona essa adoção aos resultados das pull requests. Para obter diretrizes sobre como interpretar coortes de adoção, consulte GitHub Copilot usage metrics.

Métrica	Description
Tendências de engajamento	Como a composição da coorte de adoção da organização e a taxa de transferência de pull requests (total de pull requests mesclados por mês) mudaram nos últimos seis meses.
Distribuição de coorte de adoção	Compartilhamento de usuários licenciados agrupados em cada fase de adoção (Usuários passivos, Fase 1, Fase 2, Fase 3) para o período. Os usuários passivos correspondem ao No Cohort valor na API.
Multiplicador de adoção	Compara usuários engajados (Fase 1, 2 ou 3) com usuários passivos em relação ao código entregue (pull requests mesclados por usuário por mês) e ao tempo para mesclar pull requests, para mostrar o impacto relativo de uma adoção mais profunda Copilot.
Recommendations	Ações sugeridas, como configurar Copilot cloud agent ou habilitar Copilot code review, com base na distribuição de coorte atual da organização.

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. A maioria das tabelas abaixo lista o nome do campo, seu tipo JSON, se o valor pode ser nulo e uma descrição.

Os relatórios vêm em formas diferentes dependendo de seu escopo e granularidade, portanto, os campos disponíveis em um registro dependem de qual relatório ele vem:

• Os relatórios por usuário (*-users-1-day e *-users-28-day) contêm um registro por usuário, incluindo user_id, user_login, , ai_credits_usedos used_* indicadores e ai_adoption_phase. Eles não contêm contagens de usuários ativos, pull_requests, ou totals_by_ai_adoption_phase.
• Os relatórios agregados (enterprise-1-day e org-1-day) contêm um registro agregado por empresa ou organização, incluindo contagens de usuário ativo e pull_requests``totals_by_ai_adoption_phase. Eles não contêm user_id, user_loginou os used_* indicadores.
• Relatórios de 28 dias (enterprise-28-day e org-28-day) encapsulam uma matriz de registros agregados diários em um day_totals campo, com a janela de relatório no nível superior.
• Os relatórios de equipes de usuário (*-user-teams-1-day) mapeiam os usuários para as equipes às quais pertencem, para que você possa construir métricas de nível de equipe.
• Os relatórios em nível de repositório (*-repos-1-day) contêm um registro por repositório com atividade de pull request do dia, incluindo pull requests criados por Copilot cloud agent e revisados por Copilot code review.

Os relatórios no escopo da organização também incluem organization_id juntamente com enterprise_id. Por exemplo, esquemas dos dados retornados pelas APIs, consulte Esquema de exemplo para métricas de uso de Copilot.

A coluna Type usa tipos de esquema JSON: string, , integer, number, , boolean, arraye object. A coluna Anulável indica se o valor de um campo pode estar null ou ausente de um registro em que ele se aplicaria de outra forma. Matrizes de divisão de atividades estão sempre presentes, mas podem estar vazias ([]). As matrizes opcionais são marcadas como anuláveis e podem estar ausentes.

Campos de identificação e de partição do relatório

Esses campos identificam o escopo, a data e, no caso de exportações, a partição de cada registro. O conjunto exato presente depende da forma do relatório.

Campo	Tipo	Anulável	Description
day	string	Não	Dia do calendário que este registro representa, em YYYY-MM-DD formato. Em relatórios de 28 dias, day aparece dentro de cada day_totals entrada em vez de no nível superior.
enterprise_id	string	Não	ID exclusiva da empresa. Incluído em relatórios de escopo corporativo e de organização.
organization_id	string	Sim	ID exclusivo da organização. Incluído somente em relatórios de escopo da organização; omitido de relatórios de escopo empresarial.
etl_id / day_partition	string	Não	Campos de partição usados para manutenção. Incluído em arquivos NDJSON exportados e retornados pelas APIs de métricas de uso.
entity_id_partition	integer	Não	Partição de entidade usada para manutenção. Incluído em arquivos NDJSON exportados e retornados pelas APIs de métricas de uso.

Campos de relatório por usuário

Os relatórios por usuário contêm um registro por usuário para o período de relatório. O relatório de 28 dias por usuário também inclui report_start_day e report_end_day para marcar a janela de relatório.

Campo	Tipo	Anulável	Description
user_id	integer	Não	Identificador exclusivo do usuário.
user_login	string	Não
GitHub nome de usuário para o usuário.
ai_credits_used	number	Não	Total de créditos de IA consumidos pelo usuário no período de relatório. Esse campo é incluído somente em relatórios por usuário e não é dividido por recurso, modelo ou superfície. Essa métrica é para análise de consumo, não para faturamento de totais.
user_initiated_interaction_count	integer	Não	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.
code_generation_activity_count	integer	Não	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	integer	Não	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	integer	Não	Linhas de código Copilot sugeridas para adicionar (sugestões automáticas, chat integrado, painel de chat e assim por diante; exclui as edições do agente).
loc_suggested_to_delete_sum	integer	Não	Linhas de código Copilot sugeridas para excluir (suporte futuro planejado).
loc_added_sum	integer	Não	Linhas de código realmente adicionadas ao editor (conclusões aceitas, blocos de código aplicados, agente e modo de edição).
loc_deleted_sum	integer	Não	Linhas de código excluídas do editor (atualmente de edições de agente).
used_agent	boolean	Não	Se o usuário usou o modo de agente no IDE naquele dia. Não inclui a atividade Copilot code review, que é capturada separadamente em used_copilot_code_review_active e used_copilot_code_review_passive.
used_chat	boolean	Não	Se o usuário usou o chat IDE naquele dia.
used_cli	boolean	Não	Se o usuário usou Copilot CLI esse dia.
used_copilot_app	boolean	Não	Se o usuário usou o Copilot app naquele dia.
used_copilot_coding_agent	boolean	Não	Se o usuário usou Copilot cloud agent (anteriormente Copilot agente de codificação) naquele dia.
used_copilot_cloud_agent	boolean	Não	Se o usuário usou Copilot cloud agent esse dia. Carrega o mesmo valor que used_copilot_coding_agent; ambos os nomes são mantidos para compatibilidade com versões anteriores.
used_copilot_code_review_active	boolean	Sim	Se o usuário se envolveu ativamente com Copilot code review esse dia. Um usuário é considerado ativo se solicitou manualmente uma Copilot revisão ou aplicou uma Copilot sugestão de revisão. Nulo quando não houver sinal Copilot code review para o usuário naquele dia.
used_copilot_code_review_passive	boolean	Sim	Se o usuário teve Copilot atribuído automaticamente para revisar uma solicitação de pull naquele dia, sem participar ativamente da revisão. Nulo quando não houver sinal Copilot code review para o usuário naquele dia.
ai_adoption_phase	object	Não	A fase de adoção da IA do usuário neste dia. Sempre presente; o padrão é a fase "Sem Coorte". Consulte os campos de fase de adoção de IA.
totals_by_cli	object	Sim	Métricas específicas da CLI para o usuário. Omitido quando o usuário não tinha uso Copilot CLI naquele dia. Consulte Copilot CLI os campos de métricas.
totals_by_copilot_app	object	Sim
Copilot app métricas para o usuário. Omitido quando o usuário não tinha uso Copilot app naquele dia. Consulte Copilot app os campos de métricas.
totals_by_3rd_party_agent	array	Sim	Métricas de uso por agente para agent apps reconhecidos. Omitido quando o usuário não tinha nenhuma atividade reconhecida agent app durante o período de relatório. Consulte Agent apps os campos de métricas.
totals_by_ide	array	Não	Detalhamento da atividade do usuário por IDE. Consulte objetos de divisão de atividade.
totals_by_feature	array	Não	Detalhamento por recurso da atividade do usuário. Consulte objetos de divisão de atividade.
totals_by_language_feature	array	Não	Detalhamento combinando dimensões de funcionalidades e linguagem. Consulte objetos de divisão de atividade.
totals_by_language_model	array	Não	Análise detalhada que combina as dimensões de idioma e modelo, para a atividade de chat. Consulte objetos de divisão de atividade.
totals_by_model_feature	array	Não	Detalhamento que combina dimensões de modelo e funcionalidades para a atividade de chat. Consulte objetos de divisão de atividade.

Campos de relatório corporativo e organizacional agregados

Os relatórios agregados contêm um registro por empresa ou organização, resumindo todos os usuários do dia. As contagens de usuário ativo incluem usuários identificados por meio da telemetria do lado do cliente e do servidor. Os usuários identificados exclusivamente por meio da telemetria do lado do servidor são contabilizados nos totais de usuários ativos, mas podem não aparecer nas matrizes de detalhamento dimensional (totals_by_ide, totals_by_feature, e similares). As tabelas a seguir listam as contagens de usuário ativo e, em seguida, os totais de atividade e os detalhamentos.

Contagens de usuário ativo:

Campo	Tipo	Anulável	Description
daily_active_users	integer	Não	Número de usuários exclusivos que usaram Copilot em um determinado dia.
weekly_active_users	integer	Não	Número de usuários únicos que utilizaram Copilot durante um período de sete dias consecutivos.
monthly_active_users	integer	Não	Número de usuários únicos que utilizaram Copilot durante um período de 28 dias consecutivos.
monthly_active_chat_users	integer	Não	Número de usuários únicos que utilizaram o chat durante um período de 28 dias consecutivos.
monthly_active_agent_users	integer	Não	Número de usuários únicos que utilizaram o modo de agente durante um período de 28 dias consecutivos.
daily_active_copilot_cloud_agent_users	integer	Não	Número de usuários exclusivos que usaram Copilot cloud agent em um determinado dia.
weekly_active_copilot_cloud_agent_users	integer	Não	Número de usuários únicos que utilizaram Copilot cloud agent durante um período de sete dias consecutivos.
monthly_active_copilot_cloud_agent_users	integer	Não	Número de usuários únicos que utilizaram Copilot cloud agent durante um período de 28 dias consecutivos.
daily_active_copilot_code_review_users	integer	Não	Número de usuários exclusivos que usaram Copilot code review ativamente em um determinado dia. Uso ativo significa solicitar manualmente uma revisão ou aplicar uma sugestão. Quando um usuário tem sinais ativos e passivos no mesmo período, ele é contado apenas como ativo.
weekly_active_copilot_code_review_users	integer	Não	Número de usuários exclusivos que usaram Copilot code review ativamente durante uma janela dos últimos sete dias. Quando um usuário tem sinais ativos e passivos no mesmo período, ele é contado apenas como ativo.
monthly_active_copilot_code_review_users	integer	Não	Número de usuários exclusivos que usaram Copilot code review ativamente durante uma janela móvel de 28 dias. Quando um usuário tem sinais ativos e passivos no mesmo período, ele é contado apenas como ativo.
daily_passive_copilot_code_review_users	integer	Não	Número de usuários exclusivos que foram Copilot code review automaticamente atribuídos para revisar sua solicitação de pull em um dia específico, sem participar ativamente.
weekly_passive_copilot_code_review_users	integer	Não	Número de usuários únicos que tiveram Copilot code review atribuído automaticamente para revisar sua solicitação de pull durante uma janela móvel de sete dias, sem participação ativa.
monthly_passive_copilot_code_review_users	integer	Não	Número de usuários únicos que tiveram Copilot code review automaticamente designados para revisar sua solicitação de pull durante um período de 28 dias, sem qualquer envolvimento ativo.
daily_active_cli_users	integer	Sim	Número de usuários exclusivos que usaram Copilot CLI em um determinado dia. Essa contagem é independente das contagens de usuário ativo do IDE e não está incluída em definições de usuário ativo baseadas em IDE. Omitido para empresas ou organizações sem uso da CLI naquele dia.
daily_active_copilot_app_users	integer	Sim	Número de usuários únicos que usaram o Copilot app em um dado dia. Nulo quando a empresa ou organização não tiver nenhuma Copilot app atividade naquele dia.

Totais de atividade e detalhamentos:

Campo	Tipo	Anulável	Description
user_initiated_interaction_count	integer	Não	Número total de prompts explícitos enviados para Copilot entre todos os usuários no dia.
code_generation_activity_count	integer	Não	Número total de eventos de saída distintos Copilot gerados entre todos os usuários no dia.
code_acceptance_activity_count	integer	Não	Número total de sugestões ou blocos de código aceitos por todos os usuários no dia.
loc_suggested_to_add_sum	integer	Não	Linhas de código agregadas sugeridas para adicionar para o dia. Mesma definição do campo por usuário.
loc_suggested_to_delete_sum	integer	Não	Linhas de código agregadas sugeridas para excluir para o dia. Mesma definição do campo por usuário.
loc_added_sum	integer	Não	Linhas agregadas de código adicionadas no dia. Mesma definição do campo por usuário.
loc_deleted_sum	integer	Não	Linhas agregadas de código removidas no dia. Mesma definição do campo por usuário.
totals_by_ide	array	Não	Divisão da atividade por IDE agregada. Consulte objetos de divisão de atividade.
totals_by_feature	array	Não	Divisão de atividade agregada por recurso. Consulte objetos de divisão de atividade.
totals_by_language_feature	array	Não	Detalhamento da atividade agregada por idioma e funcionalidade. Consulte objetos de divisão de atividade.
totals_by_language_model	array	Não	Detalhamento agregado das atividades por idioma e modelo. Consulte objetos de divisão de atividade.
totals_by_model_feature	array	Não	Detalhamento agregado da atividade por modelo e funcionalidade. Consulte objetos de divisão de atividade.
totals_by_cli	object	Sim	Métricas agregadas Copilot CLI para o dia. Omitido quando não há uso da CLI naquele dia. Ao contrário do formulário por usuário, ele não inclui last_known_cli_version. Consulte Copilot CLI os campos de métricas.
totals_by_copilot_app	object	Sim	Métricas agregadas Copilot app para o dia. Nulo quando a empresa ou organização não tiver nenhuma Copilot app atividade naquele dia. Consulte Copilot app os campos de métricas.
totals_by_3rd_party_agent	array	Sim	Métricas de uso agregadas por agente para agent apps reconhecidos. Omitido quando a empresa ou organização não tinha nenhuma atividade reconhecida agent app naquele dia. Consulte Agent apps os campos de métricas.
totals_by_ai_adoption_phase	array	Sim	Agregações por fase de usuários e sua atividade média. Omitido quando nenhum dado da fase de adoção está disponível. Consulte os campos de fase de adoção de IA.
pull_requests	object	Não	Atividade diária de solicitação de pull da empresa ou organização. Consulte os campos de atividade da pull request.

Campos de relatório de 28 dias

Os relatórios de 28 dias (enterprise-28-day e org-28-day) são wrappers: eles contêm a janela de relatório no nível superior e uma matriz de registros agregados diariamente.

Campo	Tipo	Anulável	Description
report_start_day	string	Não	Primeiro dia da janela de relatório de 28 dias, no formato YYYY-MM-DD.
report_end_day	string	Não	Último dia do calendário do período de relatório de 28 dias, no formato YYYY-MM-DD.
created_at	string	Não	Registro de data e hora (ISO 8601) quando o relatório foi gerado.
day_totals	array	Não	Matriz de registros agregados diários. Cada entrada tem os mesmos campos que um relatório agregado de 1 dia. Consulte os campos de relatório corporativo e organizacional agregados.

Campos de equipes de usuários

Esses campos aparecem no relatório diário do user-teams (disponível via API REST nos escopos da organização e da empresa) e são usados para construir métricas de nível de equipe unindo-se ao relatório de métricas de uso por usuário. Para obter as instruções completas para a junção e as URLs de endpoint, consulte Métricas de uso de Copilot no nível da equipe.

Equipes com menos de 5 usuários Copilot sentados em um determinado dia são excluídas do relatório do user-teams.

Campo	Tipo	Anulável	Description
user_id	integer	Não	Identificador exclusivo do usuário.
user_login	string	Não
GitHub nome de usuário para o usuário.
day	string	Não	Dia do calendário que este registro representa.
organization_id	string	Não	ID exclusiva da organização à qual a equipe pertence. Apenas no escopo da organização.
enterprise_id	string	Não	ID exclusiva da empresa à qual a equipe pertence. Disponível apenas para o plano Enterprise. O relatório com escopo empresarial inclui equipes empresariais e equipes de negócios.
team_id	integer	Não	ID exclusiva da equipe à qual o usuário pertence.
slug	string	Não	Identificador de URL fácil de lembrar para a equipe.

Campos no nível do repositório (somente API)

Os relatórios em nível de repositório mostram a atividade diária de criação, revisão, mesclagem e sugestões de pull requests para repositórios em uma organização ou empresa, incluindo pull requests criados por Copilot cloud agent e revisados por Copilot code review. Cada linha representa um repositório que tinha atividade de solicitação de pull no dia solicitado; repositórios sem atividade são omitidos. Esses relatórios se concentram na atividade do ciclo de vida da solicitação de pull e podem conter dados mesmo quando as métricas de uso do IDE estão ausentes.

Esses campos são retornados pelo relatório diário em nível de repositório (repos-1-day), disponível via API REST nos escopos da organização e da empresa. Para as URLs do endpoint, o envelope de resposta, as permissões e o fluxo de download, consulte Endpoints da API REST para métricas de uso do Copilot. Para obter linhas de exemplo, consulte Esquema de exemplo para métricas de uso de Copilot.

Campo	Tipo	Anulável	Description
day	string	Não	Dia do calendário que este registro representa, em YYYY-MM-DD formato.
enterprise_id	string	Não	ID exclusiva da empresa. Preenchidos em relatórios com escopo empresarial e em relatórios com escopo organizacional para organizações pertencentes a uma empresa. Vazio para organizações que não pertencem a uma empresa.
organization_id	string	Não	ID exclusiva da organização que possui o repositório. Incluído em relatórios de escopo corporativo e de organização.
repo_id	integer	Não	Identificador único do repositório.
repo_owner_name	string	Não	Logon do proprietário do repositório.
repo_name	string	Não	Nome do repositório.
repo_visibility	string	Não	Visibilidade do repositório. Os valores possíveis são PRIVATE, INTERNAL e PUBLIC.
pull_requests	object	Não	Atividade diária de pull request do repositório. Consulte os campos de atividade da pull request.

Objetos de detalhamento de atividades

Os campos totals_by_* são matrizes de objetos de detalhamento. A matriz está sempre presente, mas pode estar vazia. Dentro de cada objeto, os campos de métrica (*_count e loc_*_sum) seguem as mesmas definições dos campos de nível superior por usuário, e os campos de dimensão apresentam os valores documentados em Valores da dimensão de detalhamento.

Objeto	Campos de dimensão	Description
totals_by_ide[]	ide	Detalhamento por IDE. Em relatórios por usuário, cada entrada também inclui last_known_ide_version e last_known_plugin_version.
totals_by_feature[]	feature	Detalhamento por recurso Copilot (por exemplo, chat em linha ou painel de chat).
totals_by_language_feature[]
language, feature	Detalhamento por idioma e recurso. Não inclui user_initiated_interaction_count.
totals_by_language_model[]
language, model	Análise detalhada que combina idioma e modelo, para atividades de chat (não para sugestões de preenchimento).
totals_by_model_feature[]
model, feature	Análise detalhada combinando modelo e característica, para a atividade de chat (não para sugestões de preenchimento).

Em relatórios por usuário, cada entrada totals_by_ide[] também informa as versões da IDE e da extensão Copilot Chat detectadas mais recentemente para o usuário.

Campo	Tipo	Anulável	Description
last_known_ide_version	object	Sim	A versão mais recente do IDE detectada para o usuário é { ide_version, sampled_at }. Omitido para linhas de detalhamento agregado, como o bucket IDE “outros” com limite máximo.
last_known_ide_version.ide_version	string	Não	Sequência de caracteres da versão do IDE. Presente quando last_known_ide_version estiver presente.
last_known_ide_version.sampled_at	string	Sim	Carimbo de data e hora (ISO 8601) em que a versão foi coletada.
last_known_plugin_version	object	Sim	A extensão mais recente Copilot detectada para o usuário como { plugin, plugin_version, sampled_at }. Omitido para linhas de divisão agregadas.
last_known_plugin_version.plugin	string	Não	Nome da extensão (por exemplo, copilot ou copilot-chat). Presente quando last_known_plugin_version estiver presente.
last_known_plugin_version.plugin_version	string	Não	Cadeia de caracteres de versão de extensão. Presente quando last_known_plugin_version estiver presente.
last_known_plugin_version.sampled_at	string	Sim	Carimbo de data e hora (ISO 8601) em que a versão foi coletada.

Copilot CLI campos de métricas

O objeto totals_by_cli contém os seguintes campos aninhados quando houver uso da CLI Copilot CLI; o objeto é omitido quando não houver uso da CLI. O uso da CLI é independente das métricas do IDE — isso não se reflete em campos como totals_by_ide ou totals_by_feature. O last_known_cli_version objeto aparece somente em relatórios por usuário.

Campo	Tipo	Anulável	Description
totals_by_cli.session_count	integer	Não	Número de sessões distintas da CLI iniciadas neste dia.
totals_by_cli.request_count	integer	Não	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.prompt_count	integer	Não	Número total de prompts, comandos ou consultas do usuário executados em uma sessão.
totals_by_cli.token_usage.output_tokens_sum	integer	Não	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	integer	Não	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	number	Sim	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. Nulo quando não havia solicitações naquele dia.
totals_by_cli.last_known_cli_version	object	Não	Versão mais recente Copilot CLI detectada para o usuário naquele dia, como { cli_version, sampled_at }. Somente relatórios por usuário.
totals_by_cli.last_known_cli_version.cli_version	string	Não
Copilot CLI string de versão. O padrão será unknown se nenhuma versão for detectada.
totals_by_cli.last_known_cli_version.sampled_at	string	Sim	Carimbo de data e hora (ISO 8601) em que a versão foi coletada.

Copilot app campos de métricas

O objeto totals_by_copilot_app contém os seguintes campos aninhados quando houver uso de Copilot app. Ele aparece em relatórios por usuário e em relatórios corporativos agregados; ele é omitido ou nulo quando o usuário ou a empresa não tinha nenhuma Copilot app atividade naquele dia. Ao contrário de totals_by_cli, a atividade de codificação de Copilot app também se reflete em totals_by_feature, totals_by_model_feature, totals_by_language_feature e totals_by_language_model no valor do recurso copilot_app, bem como nas métricas de atividade de código de nível superior e de linhas de código. Não há campo last_known_app_version .

Campo	Tipo	Anulável	Description
totals_by_copilot_app.session_count	integer	Não	Número de sessões distintas Copilot app iniciadas neste dia.
totals_by_copilot_app.request_count	integer	Não	Número total de solicitações feitas ao Copilot por meio do Copilot app neste dia, incluindo tanto solicitações iniciadas pelo usuário quanto chamadas automatizadas de acompanhamento do agente.
totals_by_copilot_app.prompt_count	integer	Não	Número total de prompts, comandos ou consultas do usuário executados em uma sessão.
totals_by_copilot_app.token_usage.output_tokens_sum	integer	Não	Total de tokens de saída gerados em todas as Copilot app solicitações neste dia.
totals_by_copilot_app.token_usage.prompt_tokens_sum	integer	Não	Total de tokens de prompt enviados em todas as solicitações do Copilot app neste dia.
totals_by_copilot_app.token_usage.avg_tokens_per_request	number	Sim	Média de tokens de saída e de prompt por solicitação do Copilot app, calculada como (output_tokens_sum + prompt_tokens_sum) ÷ request_count. Nulo quando não havia solicitações naquele dia.

Agent apps campos de métricas

O totals_by_3rd_party_agent array contém uma entrada para cada agent app reconhecido usado durante o período do relatório. As entradas são agrupadas por agent_id, e as integrações mapeadas para o mesmo agente são combinadas. Use agent_id como a chave de agrupamento estável e agent_name para exibição. A matriz é omitida quando nenhuma atividade reconhecida agent app está disponível durante o período de relatório.

Essas métricas vêm da atividade de trabalho do lado do servidor. O user_initiated_interaction_count aninhado contabiliza o início dos trabalhos do agent app e é diferente do campo de nível superior com o mesmo nome, que contabiliza prompts explícitos provenientes de outra telemetria compatível.

Campo	Tipo	Anulável	Description
totals_by_3rd_party_agent[].agent_name	string	Não	Nome de exibição do agent app. O nome pode ser alterado, portanto, use agent_id para agrupamento.
totals_by_3rd_party_agent[].agent_id	string	Não	Identificador estável para o agent app.
totals_by_3rd_party_agent[].user_initiated_interaction_count	integer	Não	Número de tarefas iniciadas pelo usuário para o agent app durante o período do relatório. Cada início de trabalho incrementa a contagem uma vez.
totals_by_3rd_party_agent[].session_count	integer	Não	Soma de contagens de sessão distintas e não vazias para integrações mapeadas para o agente durante o período do relatório. Incluído somente em relatórios corporativos e de organização agregados; omitido de relatórios por usuário.

Campos de atividade da pull request

O pull_requests objeto aparece em relatórios corporativos e organizacionais agregados e em relatórios no nível do repositório. Ele registra a atividade diária de criação, revisão, mesclagem e sugestão de pull requests, incluindo as atividades realizadas por Copilot cloud agent e Copilot code review.

Campo	Tipo	Anulável	Description
pull_requests.total_created	integer	Não	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	integer	Não	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	integer	Não	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	number	Sim	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. Nulo quando nenhuma solicitação de pull foi mesclada naquele dia.
pull_requests.total_suggestions	integer	Não	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	integer	Não	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	integer	Não	Número de pull requests criados por Copilot cloud agent neste dia específico.
pull_requests.total_reviewed_by_copilot	integer	Não	Número de solicitações de pull revisadas por Copilot code review neste dia específico. Uma solicitação de pull poderá ser contada em vários dias se Copilot code review revisá-la em vários dias.
pull_requests.total_merged_created_by_copilot	integer	Não	Número de pull requests criados por Copilot cloud agent que foram mesclados neste dia específico. Cada solicitação de pull é contada somente no dia em que é mesclada.
pull_requests.total_merged_reviewed_by_copilot	integer	Não	Número de solicitações de pull que foram mesclados e revisados por Copilot code review durante o período de análise.
pull_requests.median_minutes_to_merge_copilot_authored	number	Sim	Tempo médio, em minutos, entre a criação e a mesclagem das solicitações de pull, criadas por Copilot cloud agent e mescladas neste dia específico. Nulo quando nenhuma solicitação de pull desse tipo foi mesclada naquele dia.
pull_requests.median_minutes_to_merge_copilot_reviewed	number	Sim	Tempo médio, em minutos, entre a criação e a mesclagem da solicitação de pull, calculado apenas para solicitações de pull revisadas por Copilot code review. Nulo quando nenhuma solicitação de pull desse tipo foi mesclada naquele dia.
pull_requests.total_copilot_suggestions	integer	Não	Número de sugestões de revisão de pull requests geradas por Copilot code review neste dia específico.
pull_requests.total_copilot_applied_suggestions	integer	Não	Número de sugestões de revisão de pull request geradas por Copilot code review que foram aplicadas neste dia específico.
pull_requests.copilot_suggestions_by_comment_type	array	Não	Contagens agregadas de Copilot code review sugestões, divididas pelo tipo de comentário atribuído (por exemplo, security ou bug_risk). Cada entrada inclui comment_type, total_copilot_suggestionse total_copilot_applied_suggestions. Sempre presente, mas pode estar vazio.

Campos de fase de adoção de IA

Copilot agrupa usuários em fases de adoção de IA com base em suas atividades. As informações de fase são exibidas em dois locais: o objeto por usuário ai_adoption_phase e a matriz agregada totals_by_ai_adoption_phase . Para obter os valores de fase, consulte Valores de dimensão de detalhamento.

Lógica de classificação

Um usuário é classificado em uma fase com base nas Copilot funcionalidades com as quais ele interage. Um usuário interage com um recurso quando o utiliza em pelo menos dois dias distintos nos últimos 28 dias. O Engajamento é avaliado com base nos sinais de atividade no nível da funcionalidade na tabela abaixo, não diretamente dos campos used_*por usuário de um único dia nem de code_acceptance_activity_count. As fases são avaliadas de cima para baixo e um usuário recebe a fase mais alta para a qual se qualifica.

Phase	Critérios de participação
Sem coorte (exibido como "Usuários passivos" no painel de impacto)	O usuário não está interagindo com nenhuma funcionalidade elegível para uma fase. Isso não significa que o usuário esteja inativo. Um usuário neste grupo ainda pode estar usando o Copilot regularmente e consumindo solicitações premium, mas não usou um recurso qualificado em pelo menos dois dias distintos dentro da janela móvel dos últimos 28 dias. O caso mais comum é o uso conversacional de Copilot Chat ou do modo de agente, registrado como chat_panel_agent_mode, que nunca produz atividade de code_completion ou de agent_edit. Copiar código de uma resposta de chat também não produz nenhum sinal.
Fase 1: código primeiro	Interagiu com complementações de código em linha (o valor code_completion da dimensão feature) ou com edições do agente gravadas diretamente nos arquivos (o valor agent_edit da dimensão feature).
Fase 2: Agente primeiro	Interagiu com exatamente uma superfície de agente baseada no GitHub: Copilot CLI (o valor copilot_cli da dimensão feature), Copilot cloud agent (used_copilot_cloud_agent) ou Copilot code review (used_copilot_code_review_active ou used_copilot_code_review_passive). As superfícies ativa e passiva Copilot code review contam juntas como uma única superfície.
Fase 3: Vários agentes	Interagiu com o Copilot app (o valor copilot_app da dimensão feature) ou com duas ou mais superfícies do agente listadas para a Fase 2.

Um usuário só precisa interagir com os sinais da própria fase para alcançar essa fase. Um usuário não precisa cumprir por conta própria os critérios da Fase 1 para chegar à Fase 2 ou à Fase 3, embora, na prática, o uso da interface do agente frequentemente ocorra junto com complementações ou edições feitas pelo agente.

Das superfícies do agente, apenas as superfícies de primeira parte listadas na tabela afetam a fase de adoção de IA de um usuário. A atividade do partner-built agent apps não afeta a fase. A mesma lógica de classificação se aplica a relatórios corporativos e de organização, incluindo relatórios de 1 dia e 28 dias.

A atribuição de fase é recalculada diariamente usando a janela de 28 dias anteriores, portanto, a fase de um usuário pode mudar de um dia para o outro conforme sua atividade dentro da janela se altera. Esse é o comportamento esperado e não indica um erro de dados.

O objeto por usuário ai_adoption_phase contém:

Campo	Tipo	Anulável	Description
ai_adoption_phase.phase_number	integer	Não	Identificador numérico da fase (por exemplo, 0 para "Sem coorte").
ai_adoption_phase.phase	string	Não	Nome da fase legível por pessoas.
ai_adoption_phase.version	string	Não	Versão do modelo de fase de adoção usado (por exemplo, v1).

Cada entrada na matriz agregada totals_by_ai_adoption_phase contém:

Campo	Tipo	Anulável	Description
phase	string	Não	Nome da fase legível por pessoas.
phase_number	integer	Não	Identificador de fase numérica.
total_engaged_users	integer	Não	Número de usuários agrupados nessa fase para o período.
avg_user_initiated_interactions	number	Não	Média de interações iniciadas pelo usuário por usuário nesta fase.
avg_code_generation_activities	number	Não	Atividades médias de geração de código por usuário nesta fase.
avg_code_acceptance_activities	number	Não	Média de atividades de aceitação de código por usuário nesta fase.
avg_loc_added	number	Não	Linhas médias de código adicionadas por usuário nesta fase.
avg_loc_deleted	number	Não	Linhas médias de código excluídas por usuário nesta fase.
avg_pull_requests_reviewed	number	Não	Média de solicitações de pull revisadas por usuário nesta fase.
avg_pull_requests_created	number	Não	Média de solicitações de pull criadas por usuário nesta fase.
avg_pull_requests_merged	number	Não	Média de solicitações de pull mescladas por usuário nesta fase.
total_pull_requests_merged	integer	Não	Total de solicitações de pull mescladas pelos usuários nesta fase. Aplica-se aos relatórios agregados diários da organização e da empresa.
avg_pull_requests_median_minutes_to_merge	number	Não	Média da mediana, em minutos, do tempo de fusão por usuário para os usuários nesta fase.
avg_pull_requests_minutes_to_review	number	Não	Tempo mediano, em minutos, entre a criação do pull request e a primeira revisão, considerando apenas pull requests mesclados e atribuído ao dia da mesclagem do pull request.
avg_pull_requests_review_cycles	number	Não	Número mediano de envios de revisão (ciclos de revisão) por pull request, considerando apenas pull requests mescladas e atribuindo o valor ao dia em que a pull request foi mesclada.

Valores da dimensão de detalhamento

Os objetos de divisão acima usam campos de dimensão cujos valores vêm de conjuntos fixos. Estes são valores de campo, não campos separados. Por exemplo, agent_edit e os chat_panel_*_mode valores são valores do feature campo, não campos de nível superior.

A feature dimensão identifica o recurso ou o Copilot modo ao qual uma atividade é atribuída:

Valor	Description
code_completion	Sugestões de preenchimento de código em linha.
chat_inline	Chat integrado ao editor.
chat_panel_ask_mode	Interações do painel de chat com o modo de solicitação selecionado.
chat_panel_edit_mode	Interações do painel de chat com o modo de edição selecionado.
chat_panel_agent_mode	Interações do painel de chat com o modo de agente selecionado.
chat_panel_plan_mode	Interações do painel de chat com o modo Planejar selecionado.
chat_panel_custom_mode	Interações do painel de chat com um agente personalizado selecionado.
chat_panel_unknown_mode	Interações do painel de chat em que o modo é desconhecido.
agent_edit	Linhas adicionadas e removidas quando Copilot (nos modos de agente e de edição) grava alterações diretamente em seus arquivos no IDE. Conta edições de agentes personalizados também.
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, como user_initiated_interaction_count.
copilot_cli	Atividade atribuída a Copilot CLI.
copilot_app	Atividade atribuída ao Copilot aplicativo.
others	Qualquer recurso não coberto pelos valores acima.

A ide dimensão identifica o IDE em que ocorreu uma atividade. Esta não é uma lista completa, mas exemplos de valores observados incluemvscode, , visualstudio, intellij, eclipse, , xcode, neovim, vim, e emacs``zed.

A model dimensão identifica o modelo de IA usado para a atividade de chat. Os valores incluem identificadores de modelo específicos (por exemplo, gpt-5.4 ou claude-sonnet-4.6), autoe unknown``others. O auto valor representa a atividade em que auto model selection foi usada e a solicitação não foi atribuída a um modelo específico.

A phase dimensão identifica a fase de adoção de IA em que um usuário é agrupado em: No Cohort, , Phase 1, Phase 2ou Phase 3.