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 Métricas de uso do GitHub Copilot.

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 Métricas de uso do GitHub Copilot.

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.
Engajamento com funcionalidades	Número de usuários ativos que se envolveram com cada recurso incluído Copilot em pelo menos dois dias distintos durante a janela inclusiva de 28 dias.
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 organization-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 agregados de 28 dias (enterprise-28-day e organization-28-day) encapsulam uma matriz de registros agregados diários em um day_totals campo, com a janela de relatório e o objeto opcional copilot_feature_engagement no nível superior. O objeto não está incluído em relatórios por usuário.
• 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 do relatório

Esses campos identificam o escopo e a data 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.

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.
used_vscode_agent	boolean	Sim	Se o usuário usou a janela dedicada de Agentes VS Code durante o período do relatório. Omitido caso não haja dados dedicados disponíveis para o usuário na janela Agentes.
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.
distinct_skill_use_count	integer	Sim	Número de diferentes identificadores de habilidade com atividade registrada para o usuário. Consulte campos de personalização.
distinct_custom_agent_use_count	integer	Sim	Número de diferentes identificadores de agente personalizados com atividade registrada para o usuário. Consulte campos de personalização.
distinct_mcp_use_count	integer	Sim	Número de identificadores diferentes de servidor MCP (Protocolo de Contexto do Modelo) com atividade de conexão registrada para o usuário. Consulte campos de personalização.
distinct_slash_cmd_use_count	integer	Sim	Número de identificadores de comando de barra diferentes com atividade registrada para o usuário. Consulte campos de personalização.
distinct_plugin_use_count	integer	Sim	Número de diferentes identificadores de plug-in com atividade registrada para o usuário. Consulte campos de personalização.
totals_by_skill	array	Sim	Principais habilidades por contagem de interação registrada entre clientes compatíveis. Consulte campos de personalização.
totals_by_custom_agent	array	Sim	Principais agentes personalizados por contagem de interação registrada entre clientes compatíveis. Consulte campos de personalização.
totals_by_mcp	array	Sim	Servidores MCP com as tentativas de conexão e reconexão mais registradas entre clientes compatíveis. Consulte campos de personalização.
totals_by_slash_cmd	array	Sim	Principais comandos de barra por contagem de interação registrada entre clientes compatíveis. Consulte campos de personalização.
totals_by_plugin	array	Sim	Plug-ins principais por contagem de interação registrada nos clientes compatíveis. Consulte campos de personalização.
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	As métricas do usuário Copilot app. Omitido quando o usuário não usou o Copilot app naquele dia. Consulte os campos de métricas para Copilot app.
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_client	array	Não	Detalhamento por cliente das solicitações de modelo bem-sucedidas do usuário e do uso de token, contado no lado do servidor. O array está sempre presente e está vazio quando não há uso para relatar. Consulte os campos de métricas do cliente.
totals_by_vscode_agent	object	Sim	Métricas dedicadas da janela VS Code Agents para o usuário. Omitido quando ambas as contagens necessárias não estiverem disponíveis. Consulte VS Code os campos de métricas da janela Agentes.
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.
weekly_active_vscode_agent_users	integer	Sim	Número de usuários únicos que utilizaram a janela dedicada de VS Code Agentes de domingo até o dia do relatório, inclusive. Essa contagem acumulada até a data no calendário não é uma janela móvel dos últimos sete dias.
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_vscode_agent_users	integer	Sim	Número de usuários únicos que usaram a janela dedicada de Agentes VS Code do primeiro dia do mês-calendário ao dia do relatório, inclusive. Essa contagem acumulada no período do calendário não é uma janela móvel de 28 dias.
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 atividade no Copilot app naquele dia.
daily_active_vscode_agent_users	integer	Sim	Número de usuários únicos que usaram a janela dedicada de Agentes VS Code em um determinado dia. Omitido quando não há dados dedicados da janela de Agentes disponíveis para a empresa ou organização.

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.
distinct_skill_use_count	integer	Sim	Número de diferentes identificadores de habilidade com atividade registrada em toda a empresa ou organização. Consulte campos de personalização.
distinct_custom_agent_use_count	integer	Sim	Número de diferentes identificadores de agente personalizados com atividade registrada em toda a empresa ou organização. Consulte campos de personalização.
distinct_mcp_use_count	integer	Sim	Número de diferentes identificadores de servidor MCP com atividade de conexão registrada em toda a empresa ou organização. Consulte campos de personalização.
distinct_slash_cmd_use_count	integer	Sim	Número de diferentes identificadores de comando de barra com atividade registrada em toda a empresa ou organização. Consulte campos de personalização.
distinct_plugin_use_count	integer	Sim	Número de diferentes identificadores de plug-in com atividade registrada em toda a empresa ou organização. Consulte campos de personalização.
totals_by_skill	array	Sim	Principais habilidades por contagem de interação registrada entre clientes compatíveis na empresa ou organização. Consulte campos de personalização.
totals_by_custom_agent	array	Sim	Principais agentes personalizados por contagem de interação registrada entre clientes compatíveis na empresa ou organização. Consulte campos de personalização.
totals_by_mcp	array	Sim	Servidores MCP com as tentativas de conexão e reconexão mais registradas entre clientes compatíveis na empresa ou organização. Consulte campos de personalização.
totals_by_slash_cmd	array	Sim	Principais comandos de barra por contagem de interação registrada entre aplicativos cliente compatíveis na empresa ou organização. Consulte campos de personalização.
totals_by_plugin	array	Sim	Principais plug-ins por contagem de interação registrada entre clientes compatíveis na empresa ou organização. Consulte campos de personalização.
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 diárias agregadas para o Copilot app. Nulo quando a empresa ou organização não tiver nenhuma atividade no Copilot app naquele dia. Consulte os campos de métricas para Copilot app.
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_client	array	Não	Divisão agregada por cliente de solicitações de modelo bem-sucedidas e uso de token do dia, contados no servidor. O array está sempre presente e está vazio quando não há uso para relatar. Em relatórios de 28 dias, esse campo aparece em cada day_totals entrada. Consulte os campos de métricas do cliente.
totals_by_vscode_agent	object	Sim	Métricas de janela de agentes dedicados VS Code agregados para o dia. Omitido quando ambas as contagens necessárias não estiverem disponíveis. Consulte VS Code os campos de métricas da janela Agentes.
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 agregados de 28 dias (enterprise-28-day e organization-28-day) são contêineres: eles incluem, no nível superior, a janela de geração de relatórios e um array de registros diários agregados.

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.
copilot_feature_engagement	object	Sim	Engajamento contínuo com recursos durante o período de 28 dias. Incluído somente em relatórios de agregação empresarial e de organização. Nulo ou ausente quando o cálculo opcional está indisponível ou o relatório antecede esse campo. Consulte Copilot os campos de engajamento de funcionalidade.
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.

Copilot campos de engajamento da funcionalidade

O objeto opcional copilot_feature_engagement resume a população de usuários ativos do relatório e o engajamento com sete recursos. Para a entrada day_totals cujo day corresponde a report_end_day, copilot_feature_engagement.active_user_count é igual à soma dos valores de totals_by_ai_adoption_phase[].users_in_phase_28d mutuamente exclusivos.

As contagens de recursos individuais se sobrepõem porque um usuário pode se envolver com mais de um recurso. Não adicione os engaged_user_count valores juntos. O conjunto inicial de funcionalidades apresenta Copilot code review ativo e passivo como funcionalidades separadas. Não inclui o Agente Copilot Chat ou VS Code.

Copilot Chat está planejado para uma versão posterior, após 28 dias consecutivos de coleta de dados e com suporte dos usuários do relatório para a entrada adicional.

Campo	Tipo	Anulável	Description
copilot_feature_engagement.active_user_count	integer	Não	Número nãonegativo de usuários ativos distintos na janela de relatório de 28 dias inclusiva. Um relatório válido de usuário zero define esse campo como 0.
copilot_feature_engagement.totals_by_feature	array	Não	Contagens de engajamento com recursos. A matriz inicial contém exatamente uma entrada para cada um desses valores: code_completion, , agent_edit, code_review_passive, , code_review_active, cloud_agent, e copilot_cli``github_app. Um relatório válido com zero usuários inclui todas as sete entradas com engaged_user_count definido como 0.
copilot_feature_engagement.totals_by_feature[].feature	string	Não	Identificador da funcionalidade. Neste objeto, github_app representa o Copilot app. Isso difere do valor copilot_app usado em arrays de detalhamento da atividade, como totals_by_feature.
copilot_feature_engagement.totals_by_feature[].engaged_user_count	integer	Não	Número não negativo de usuários ativos distintos que se envolveram com o recurso em pelo menos dois dias distintos durante a janela de relatório de 28 dias inclusiva.

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, além das durações das etapas de revisão de pull requests, dos repositórios de 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.
pull_request_review_times	array	Não	Examine as durações do estágio para qualificar solicitações de pull mescladas no repositório neste dia, com uma entrada por autor e tipo de revisor. Vazio quando nenhum pull request elegível foi mesclado. Consulte os campos de tempo de revisão de 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.

Campos de personalização (somente API)

Essas métricas dão aos administradores corporativos e da organização visibilidade sobre quais personalizações os desenvolvedores usam em Copilot CLI, VS Code e em outros clientes compatíveis. Use-os para entender a adoção, identificar lacunas de habilitação e priorizar as habilidades, servidores MCP (Model Context Protocol), agentes personalizados, comandos de barra e plug-ins que os desenvolvedores acham valiosos.

Para acessar os relatórios, a Copilot política de métricas de uso deve ser habilitada. Para obter instruções de configuração de política, consulte:

• Gerenciando políticas e recursos para GitHub Copilot em sua empresa
• Gerenciando políticas e recursos para GitHub Copilot em sua organização

Esses campos aparecem nos seguintes relatórios corporativos e de organização:

• Relatórios de 1 dia e 28 dias por usuário
• Relatórios agregados de 1 dia
• Cada registro day_totals em relatórios agregados de 28 dias

Em relatórios de 1 dia por usuário e relatórios agregados de 1 dia, cada um dos cinco arrays de personalização listados abaixo retém até 25 entradas nomeadas por registro, ordenadas do mais alto para o mais baixo interaction_count. Esse limite e ordenação também se aplicam a cada day_totals registro em relatórios agregados de 28 dias.

As entradas fora dos 25 primeiros são combinadas em uma entrada final other, inclusive para comandos de barra. Essa entrada pode aparecer além das 25 entradas nomeadas. Ele é separado de custom, que representa comandos de barra cujos nomes configurados não estão disponíveis.

Entre os tipos de relatório, os valores são contagens de eventos, não contagens de usuários. A ausência de uma entrada de uma matriz limitada não significa que ela tenha tido uso zero. Não use essas matrizes para calcular a adoção exata.

Em relatórios corporativos e de organização, incluindo relatórios de 1 dia e 28 dias por usuário, relatórios agregados de 1 dia e day_totals relatórios agregados de 28 dias, esses arrays incluem os nomes configurados de personalizações que sua organização cria. Nomes configurados também são incluídos nas exportações NDJSON por usuário correspondentes.

Os nomes são relatados por esses clientes quando a política de métricas de uso da Copilot empresa está habilitada:

• Copilot CLI sessões interativas e modo de prompt (-p).
• O Copilot app.
• Clientes desenvolvidos sobre a Copilot SDK, como VS Code e JetBrains IDEs.
• Integrações ACP (Agent Client Protocol).

Para relatar nomes de personalização:

• O modo de prompt, o aplicativo e as integrações ACP exigem Copilot CLI 1.0.97 ou posterior.
• Clientes baseados no Copilot SDK exigem a versão 1.0.21 do SDK ou posterior. Se um aplicativo substituir a CLI agrupada com o SDK, essa CLI deverá ser a versão 1.0.97 ou posterior.

Integrações de IDE que não são baseadas no Copilot SDK não relatam nomes de personalização.

Os nomes configurados são cortados e limitados a 128 caracteres. Os nomes que se parecem com caminhos de arquivo permanecem agrupados em other ou custom, assim como personalizações para as quais os nomes não estão disponíveis. Examine os nomes configurados antes de compartilhar relatórios fora da sua organização.

Os nomes estão disponíveis para os dias de relatório processados depois que o suporte para nomes personalizados foi implantado. Os dias anteriores não são preenchidos retroativamente automaticamente e continuam a mostrar other ou custom. Os nomes de relatório não alteram como os campos interaction_count e distinct_*_use_count são calculados.

Essas métricas dependem da telemetria do cliente e podem subcontar a atividade, por exemplo, quando os clientes estão desatualizados ou a telemetria é bloqueada. Use esses dados para entender as tendências e a adoção, não para a contabilidade exata nem como uma auditoria completa do uso da personalização.

Cada entrada de matriz contém o campo de nome listado na tabela e um campo inteiro interaction_count .

Array	Campo Nome	Quais interaction_count medidas	Campo de contagem distinta
totals_by_skill[]	skill	Invocações de habilidades.	distinct_skill_use_count
totals_by_custom_agent[]	custom_agent	Iniciais de agentes personalizados.	distinct_custom_agent_use_count
totals_by_mcp[]	mcp	Tentativas de conexão e reconexão de servidor MCP bem-sucedidas ou com falha. As chamadas de ferramenta por meio de um servidor já conectado não aumentam essa contagem.	distinct_mcp_use_count
totals_by_slash_cmd[]	slash_cmd	Invocações de comando de barra.	distinct_slash_cmd_use_count
totals_by_plugin[]	plugin	Invocações de habilidade associadas a um plug-in. As interações de plugin são um subconjunto das interações de skill.	distinct_plugin_use_count

Cada interação de plugin já está incluída em totals_by_skill, enquanto as interações de habilidade que não estão associadas a um plugin aparecem apenas nos totais de habilidades. Não some as contagens de interação de plug-ins e habilidades.

Os campos de contagem distinta contabilizam diferentes identificadores de itens com atividade, não usuários ou usos. Em um registro por usuário, cada identificador diferente que o usuário usou conta uma vez. Em um registro corporativo ou de organização agregado, cada identificador diferente usado por qualquer pessoa no escopo conta uma vez, independentemente de quantos usuários o usaram. Contagens distintas agregadas não são somas de contagens distintas por usuário.

Contagens distintas incluem todos os diferentes identificadores com atividade registrada, mesmo aqueles fora das entradas nomeadas retidas de um array. Quando as personalizações são agrupadas em other ou custom, cada identificador oculto ainda contribui separadamente para a contagem distinta correspondente.

Quando esses campos estão presentes, arrays vazios e contagens distintas de 0 significam que nenhuma atividade correspondente foi registrada. Os campos podem ser nulos ou ausentes quando os dados de personalização não estiverem disponíveis durante a implantação.

Campos de métricas para o Copilot app

O objeto totals_by_copilot_app contém os seguintes campos aninhados quando o uso do Copilot app está presente. 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 atividade no Copilot app naquele dia. Ao contrário de totals_by_cli, a atividade de codificação no Copilot app também é refletida em totals_by_feature, totals_by_model_feature, totals_by_language_feature e totals_by_language_model sob o valor do recurso copilot_app, e nas métricas de atividade de código de nível superior e 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 iniciadas no Copilot app 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 solicitações no Copilot app 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 na 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 na Copilot app, computado como (output_tokens_sum + prompt_tokens_sum) ÷ request_count. Nulo quando não havia solicitações naquele dia.

VS Code Campos de métricas da janela Agentes

Os campos dedicados da janela Agentes VS Code aparecem em relatórios de 1 dia e de 28 dias de empresa, organização, usuário da empresa e usuário da organização. Em relatórios agregados de 28 dias, eles aparecem em cada entrada day_totals aplicável, e as contagens semanais e mensais são calculadas em relação ao day de cada entrada. Em relatórios de 28 dias por usuário, eles aparecem no nível superior de cada registro de usuário.

Esses campos são distintos do modo de agente da janela do editor, incluindo used_agent, monthly_active_agent_users e os valores de recurso chat_panel_agent_mode e agent_edit. A atividade na janela Agentes dedicados não está incluída nos totais genéricos de atividade de nível mais alto nem em detalhamentos dimensionais, como totals_by_feature, totals_by_model_feature ou totals_by_ai_adoption_phase.

A contagem diária e os campos por usuário podem ser omitidos caso não haja dados específicos da janela Agents. Os campos semanais e mensais são omitidos quando não há atividade de qualificação em nenhum dos dois períodos. Se um período tiver atividade de qualificação e o outro não, o período inativo terá um valor igual 0a . O objeto totals_by_vscode_agent aparece somente quando ambas as contagens aninhadas estão disponíveis, inclusive quando as duas contagens são zero.

Campo	Tipo	Anulável	Description
daily_active_vscode_agent_users	integer	Sim	Número de usuários únicos que usaram a janela dedicada de Agentes VS Code nesse dia. Somente relatórios corporativos e de organização agregados.
weekly_active_vscode_agent_users	integer	Sim	Número de usuários únicos que usaram a janela dedicada de Agentes de domingo ao dia do relatório, inclusive. Somente relatórios corporativos e de organização agregados.
monthly_active_vscode_agent_users	integer	Sim	Número de usuários únicos que utilizaram a janela dedicada de Agentes desde o primeiro dia do mês-calendário até o dia do relatório, inclusive. Somente relatórios corporativos e de organização agregados.
used_vscode_agent	boolean	Sim	Se o usuário usou a janela dedicada de Agentes VS Code durante o período do relatório. Somente relatórios de usuário corporativo e de organização.
totals_by_vscode_agent	object	Sim	Totais de sessão e de mensagens do usuário para a janela dedicada VS Code de Agentes.
totals_by_vscode_agent.session_count	integer	Não	Número de sessões distintas da janela de Agentes representadas no registro. Necessário quando totals_by_vscode_agent estiver presente.
totals_by_vscode_agent.total_user_messages	integer	Não	Número de mensagens de usuário enviadas na janela Agentes representadas no registro. Necessário quando totals_by_vscode_agent estiver presente.

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 métricas do cliente

A matriz totals_by_client divide as solicitações de modelo bem-sucedidas que passaram pela Copilot API, por cliente que as enviou. Essas métricas são contadas no lado do servidor, portanto, incluem ferramentas que usam Copilot como um provedor de modelos mesmo quando essas ferramentas não enviam telemetria do editor, como OpenCode. A atividade dessas ferramentas não aparece em totals_by_ide, que depende da telemetria do editor.

totals_by_client é diferente de totals_by_3rd_party_agent. A matriz totals_by_3rd_party_agent conta os inícios de trabalho para agent apps reconhecidos e não inclui dados de token nem de modelo.

Os clientes são identificados a partir da ID de integração que cada cliente envia com suas solicitações. Trate client como um agrupamento de melhor esforço, não uma identidade verificada.

Dentro totals_by_client, os request_count campos contam chamadas de modelo bem-sucedidas, não prompts. Um único prompt pode disparar várias chamadas de modelo. Não compare essas contagens de solicitação com contagens de prompt ou interação, como user_initiated_interaction_count ou totals_by_cli.prompt_count.

A totals_by_client array aparece no nível superior de cada registro em relatórios de 1 dia e 28 dias por usuário e em relatórios agregados de 1 dia. Em relatórios agregados de 28 dias, ele aparece em cada day_totals entrada. O array está sempre presente e está vazio quando não há uso para relatar.

Campo	Tipo	Anulável	Description
totals_by_client[].client	string	Não	Nome do cliente normalizado. Os valores conhecidos incluem vscode, visualstudio, jetbrains, eclipse, xcode, zed, copilot_cli, github_app, copilot_sdk, cloud_agent, code_review, github_web, github_mobile, github_desktop, agentic_workflows, claude_code, codex, opencode, slack e azure_devops. As solicitações com uma ID de integração não reconhecida ou ausente são agrupadas na categoria other. Os valores podem ser adicionados ao longo do tempo.
totals_by_client[].request_count	integer	Não	Número de solicitações de modelo bem-sucedidas do cliente. Conta chamadas de modelo, não prompts.
totals_by_client[].session_count	integer	Não	Número de sessões distintas para o cliente. Em relatórios corporativos e de organização agregados, as sessões são desduplicadas em todos os usuários, portanto, esse valor não é a soma das contagens por usuário. Ao contrário de totals_by_3rd_party_agent[].session_count, esse campo também está incluído em relatórios por usuário.
totals_by_client[].token_usage.prompt_tokens_sum	integer	Não	Número total de tokens de prompt enviados em todas as solicitações do cliente.
totals_by_client[].token_usage.output_tokens_sum	integer	Não	Número total de tokens de saída gerados nas solicitações do cliente.
totals_by_client[].token_usage.avg_tokens_per_request	number	Não	Número médio de tokens de saída e prompt por solicitação, computados como (output_tokens_sum + prompt_tokens_sum) ÷ request_count.
totals_by_client[].totals_by_model	array	Não	Detalhamento por modelo das solicitações do cliente e do uso de token. As entradas são indexadas por model e model_selection_mode, portanto, o mesmo modelo pode aparecer mais de uma vez com modos de seleção diferentes.
totals_by_client[].totals_by_model[].model	string	Não	Modelo usado para as solicitações. Para code_review, o modelo é sempre informado como unknown.
totals_by_client[].totals_by_model[].model_selection_mode	string	Não	Como o modelo foi selecionado. Os valores possíveis são user_selected (um modelo específico foi solicitado em vez de Auto), product_selected (o produto escolheu o modelo, usado para todos Copilot code review e Copilot cloud agent solicitações), auto (Escolheu automaticamente o modelo), other (modos de seleção agrupados e ainda não relatados individualmente) e unknown (um modo de seleção enviado pelo cliente que não pôde ser normalizado).
totals_by_client[].totals_by_model[].request_count	integer	Não	Número de solicitações de modelo bem-sucedidas do cliente que usaram esse modelo e modo de seleção.
totals_by_client[].totals_by_model[].token_usage.prompt_tokens_sum	integer	Não	Número total de tokens de prompt enviados entre essas solicitações.
totals_by_client[].totals_by_model[].token_usage.output_tokens_sum	integer	Não	Número total de tokens de saída gerados nessas solicitações.
totals_by_client[].totals_by_model[].token_usage.avg_tokens_per_request	number	Não	Número médio de tokens de saída e prompt por solicitação, computados como (output_tokens_sum + prompt_tokens_sum) ÷ request_count.

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 tempo de revisão de solicitação de pull

A pull_request_review_times matriz aparece somente em relatórios no nível do repositório. Ele detalha quanto tempo as solicitações de pull mescladas foram gastas em três estágios de revisão, para que você possa ver se as solicitações de pull estão aguardando uma primeira revisão, aguardando o vai-e-vem entre revisores ou aguardando para serem mescladas após a revisão final.

Cada entrada aborda solicitações de pull mescladas no repositório neste dia específico. Todas as durações são atribuídas ao dia em que ocorreu a mesclagem, mesmo quando as revisões aconteceram em dias anteriores.

Quais solicitações de pull são contadas

Um pull request é incluído quando uma pessoa o abriu, ele ficou pronto para revisão e pelo menos outra pessoa o revisou. Somente as revisões feitas por humanos são cronometradas. As revisões feitas por Copilot code review, por outros bots e pelo autor do pull request são ignoradas, portanto, um pull request revisado por uma pessoa e por Copilot code review ainda é incluído, com suas etapas cronometradas com base nas revisões humanas. O tempo gasto em rascunho antes da primeira revisão não é contabilizado.

Uma solicitação de pull mesclada é excluída de pull_request_review_times quando qualquer uma das seguintes opções é verdadeira:

• Ele foi criado por um bot, incluindo Copilot cloud agent.
• Ele nunca recebeu uma revisão humana qualificada, incluindo solicitações de pull mescladas sem qualquer revisão.
• A hora em que ficou pronta para revisão é desconhecida.
• Seus carimbos de data/hora estão fora de ordem. Por exemplo, sua revisão final é registrada após sua mesclagem.

As exclusões não são relatadas para solicitações de pull individuais. Como pull_requests.total_merged conta cada solicitação de pull mesclada naquele dia, pull_request_review_times[].total_merged geralmente é menor. Compare os dois valores para ver quantos pull requests mesclados essas durações cobrem.

Disponibilidade de dados

• Os dados são compilados com base na versão desses campos e não são preenchidos novamente.
• As solicitações de pull que ficaram prontas para revisão antes de 21 de setembro de 2026 são excluídas dessa matriz, mas ainda contam para pull_requests.total_merged.
• A matriz está vazia ([]) em dias em que o repositório não mescla nenhuma solicitação de pull de qualificação. Uma matriz vazia significa nenhum dado para esse dia, não zero minutos.

Campo	Tipo	Anulável	Description
pull_request_review_times[].authored_by	string	Não	Quem abriu as solicitações de pull nesta entrada. Atualmente, sempre human.
pull_request_review_times[].reviewed_by	string	Não	Quem analisou os pull requests neste registro. Atualmente, sempre human.
pull_request_review_times[].total_merged	integer	Não	Número de solicitações de pull qualificadas mescladas no repositório neste dia específico. Isso conta apenas as solicitações de pull descritas acima, nem todas as solicitações de pull mescladas.
pull_request_review_times[].median_minutes_ready_to_first_review	number	Não	Tempo mediano, em minutos, entre o momento em que o pull request fica pronto para revisão e sua primeira revisão qualificada.
pull_request_review_times[].p90_minutes_ready_to_first_review	number	Não	Tempo no 90º percentil, em minutos, desde que o pull request é marcado como pronto para revisão até sua primeira revisão qualificada.
pull_request_review_times[].median_minutes_first_to_final_review	number	Não	Tempo médio, em minutos, desde a primeira revisão de qualificação até a revisão final da qualificação. Um pull request com uma única revisão qualificadora resulta em uma duração de 0, pois sua primeira e sua revisão final são o mesmo evento.
pull_request_review_times[].p90_minutes_first_to_final_review	number	Não	Tempo no 90º percentil, em minutos, desde a primeira revisão qualificadora até a revisão qualificadora final. Um pull request com uma única revisão qualificadora resulta em uma duração de 0, pois sua primeira e sua revisão final são o mesmo evento.
pull_request_review_times[].median_minutes_final_review_to_merge	number	Não	Tempo mediano, em minutos, da revisão final de qualificação até a mesclagem.
pull_request_review_times[].p90_minutes_final_review_to_merge	number	Não	Tempo no percentil 90, em minutos, desde a revisão final de qualificação até a fusão.

As medianas e os percentis 90 são valores exatos calculados com interpolação linear e arredondados para duas casas decimais.

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 de agentes, apenas as superfícies próprias listadas na tabela afetam a fase de adoção de IA de um usuário. A atividade de agent apps desenvolvido por parceiros 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 duas contagens de usuário separadas:

• total_engaged_users é o número de usuários classificados na fase que estavam ativos naquele dia individual.
• users_in_phase_28d é a população total classificada na fase usando a janela móvel de 28 dias, naquele dia.

Use users_in_phase_28d como o denominador de população para cálculos de nível de fase sem interrupção. Por exemplo, para calcular solicitações de pull mescladas por usuário durante um período de 28 dias:

1. Adicione os valores diários total_pull_requests_merged .
2. Adicione os valores diários users_in_phase_28d correspondentes.
3. Divida o primeiro total pelo segundo e, em seguida, multiplique o resultado por 28.

Não use total_engaged_users como denominador porque ele inclui apenas usuários ativos em um dia individual.

O campo não altera os campos existentes avg_* ou seus cálculos, as regras de classificação de fase ou a fase atribuída de um usuário. Nenhum campo de contagem de usuários identifica indivíduos.

Quando uma fase está presente no instantâneo móvel, mas não tem atividade naquele dia, o relatório pode incluir uma entrada sintetizada com total_engaged_users definido como 0, um users_in_phase_28d positivo e todas as métricas de atividade definidas como zero.

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 classificados nessa fase que estavam ativos no dia.
users_in_phase_28d	integer	Sim	População total móvel de 28 dias classificada nesta fase naquele dia. Um valor positivo é a população de fase medida e 0 significa que a fase foi medida e não teve usuários. O campo é omitido quando o dia é anterior à data deste campo ou quando a empresa ou organização não estava presente na captura instantânea da fase.
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.