GitHub Copilot contabiliza o uso por meio do OpenCode e de outras ferramentas

Quando um desenvolvedor acessa o Copilot por meio de uma ferramenta de terceiros, as estatísticas habituais por IDE podem não mostrar de onde vieram as solicitações. Em 23 de outubro de 2026, o GitHub adicionou o campo totals_by_client à API de métricas de uso do Copilot. O campo agrupa o uso de modelos por cliente, incluindo OpenCode, Claude Code, Codex e Zed. Para administradores, é uma forma de enxergar parte da atividade fora do editor e discutir com mais precisão as regras internas de uso de IA.

O que aparece no novo detalhamento

Cada item de totals_by_client informa o cliente, o número de chamadas de modelo bem-sucedidas, a quantidade de sessões e o volume de tokens de prompt e de saída, além da média por chamada. O campo aninhado totals_by_model detalha essas métricas por modelo e indica o modo de seleção: o usuário escolheu o modelo diretamente, houve seleção automática ou o produto definiu o modelo.

O campo foi incluído em relatórios de um e de 28 dias, nos níveis de empresa, organização e usuário. No relatório agregado de 28 dias, o detalhamento por cliente está disponível para cada dia. A mudança é aditiva: os campos anteriores permanecem, e, quando não há dados, o array fica vazio. O GitHub descreveu os detalhes no anúncio do novo detalhamento de métricas de uso.

Que perguntas os dados ajudam a responder

A equipe pode comparar o volume de solicitações e de tokens gerados por diferentes ferramentas e decidir quais integrações deve oferecer ou incluir nas regras corporativas. Por exemplo, um aumento da participação do OpenCode no relatório pode indicar que os desenvolvedores estão usando o Copilot como provedor de modelos fora da IDE. Comparar clientes e modelos também ajuda a verificar quais modelos geram a maior parte da carga.

Para analisar custos, vale começar pelos tokens e pelo número de chamadas e, em seguida, confrontar os dados com as condições de cobrança vigentes. request_count contabiliza chamadas de modelo, não prompts dos usuários: um único prompt pode gerar várias chamadas. Portanto, esse campo é útil para analisar a carga do serviço de modelos, mas não para contar diretamente as interações dos desenvolvedores.

Como incorporar a métrica ao fluxo de trabalho

1. Verifique o acesso. A política de métricas de uso do Copilot precisa estar ativada. Podem obter os relatórios os proprietários autorizados da empresa ou da organização, os gerentes de cobrança e as funções com permissão para visualizar as métricas correspondentes.
2. Compare períodos equivalentes. Use o relatório de um dia para verificar mudanças após ativar uma ferramenta e o de 28 dias para avaliar a distribuição persistente da atividade. Em cada relatório, analise separadamente chamadas, tokens e sessões: são dimensões diferentes da carga.
3. Defina limites para investigação. Por exemplo, sinalize um cliente cuja participação em tokens ou chamadas tenha aumentado significativamente em relação ao período anterior. Escolha o limite de acordo com seus requisitos e com a carga de referência; o GitHub não define um limite universal.
4. Compare o relatório com as configurações de acesso. O novo detalhamento pode servir de base para discutir o suporte e a gestão de ferramentas. Os relatórios descrevem o uso registrado, mas não substituem a verificação de permissões nem o inventário de integrações.

A documentação oficial da API de métricas de uso do Copilot descreve os relatórios, os requisitos de permissão e os detalhamentos disponíveis. Antes de automatizar o processo, consulte a documentação para confirmar o esquema atualizado do relatório desejado e use as permissões adequadas.

O que significa o rótulo do cliente

O GitHub identifica o cliente pelo ID de integração que a ferramenta envia com a solicitação. A empresa descreve expressamente esse agrupamento como uma identificação aproximada: o valor ajuda a agregar o tráfego, mas, por si só, não confirma a identidade do usuário nem a autenticidade do aplicativo. Clientes desconhecidos são agrupados em other, e valores que não podem ser normalizados podem aparecer como unknown.

Há também casos especiais: chamadas do Copilot code review e do Copilot cloud agent recebem o modo de seleção product_selected, pois é o produto que escolhe o modelo; no caso do code review, o modelo pode aparecer como unknown. Isso deve ser levado em conta ao comparar os detalhamentos por modelo entre ferramentas.

A conclusão é prática: totals_by_client preenche uma lacuna no controle de chamadas do Copilot feitas no servidor por ferramentas externas e oferece aos administradores novos dados para analisar a carga e decidir quais ferramentas oferecer. Para obter um quadro confiável do uso, compare esse detalhamento com as permissões e outras fontes internas, tratando os nomes dos clientes como categorias de tráfego, não como comprovação de identidade.