API de métricas do Copilot agora separa o uso de BYOK local e de modelos customizados da empresa: o que muda para admins

Fala aí, beleza? O GitHub publicou no changelog de 3 de novembro de 2026 que a API de métricas de uso do Copilot agora mostra o uso de BYOK (bring your own key) separado do uso de modelos hospedados pelo Copilot

A medição cobre dois tipos de uso: o BYOK local, que o dev configura no próprio cliente, e os modelos customizados da empresa, que os admins configuram nas configurações do GitHub

Os dois aparecem nos relatórios de enterprise e de organização, por usuário e agregados, nas janelas de 1 dia e de 28 dias 🙂

Por que o uso de BYOK se misturava aos totais do Copilot?

Segundo o GitHub, modelos locais e customizados costumam ter o MESMO nome de modelos do Copilot

Aí, olhando o relatório, o uso de BYOK se confundia com o uso hospedado, e não dava pra saber o que o Copilot realmente tinha servido

Os dois tipos também seguem caminhos diferentes, se liga:

• BYOK local: a requisição sai do Copilot CLI ou do app GitHub Copilot direto pra chave do provedor do dev ou pro modelo local. Os exemplos citados são Ollama, Foundry Local, LM Studio e llama-server
• Modelos customizados da empresa: a requisição passa pelo GitHub até o provedor da empresa

Essa diferença de rota explica muita coisa sobre o que a API consegue ou não enxergar (já já chego lá)

Como contexto, o GitHub já tinha anunciado em junho que o Copilot CLI passou a suportar modelos BYOK da empresa, então era questão de tempo pra esse uso aparecer separado nas métricas

E pra quem curte acompanhar o canal, fica aqui um conteúdo do Hora de Codar sobre a Decisions API da OpenAI 🙂

Quais campos novos medem o BYOK local na API de métricas do Copilot?

São três grupos de campos novos pro BYOK local:

• used_local_byok: indica se o usuário fez pelo menos uma requisição de BYOK local no Copilot CLI ou no app Copilot naquele dia. Aparece nos relatórios por usuário
• totals_by_local_byok: contagens de sessões, requisições, prompts e tokens, divididas por byok_kind (local_managed, local_user, local_auto ou remote_user) e por superfície (copilot_cli ou copilot_app). Aparece nos relatórios por usuário e nos agregados
• daily_active_local_byok_users, weekly_active_local_byok_users e monthly_active_local_byok_users: usuários distintos com atividade de BYOK local no dia, na semana do calendário e no mês do calendário. Aparecem nos relatórios agregados

Um detalhe importante: o BYOK local NÃO é dividido por nome de modelo

Ou seja, tu sabe quanto foi usado e por qual superfície, mas não qual modelo local o dev estava rodando

E o que significa cada valor de byok_kind? O changelog lista os quatro valores, mas não define cada um, então vale acompanhar a documentação antes de tirar conclusão em cima dessa quebra

Como identificar o uso de modelos customizados da empresa?

Pelo campo is_custom_enterprise_model, um booleano em cada entrada de totals_by_client[].totals_by_model[]

Ele fica true quando a requisição usou um modelo customizado configurado para a enterprise ou para a organização

Aqui tem uma vantagem grande: o GitHub observa essas requisições no servidor, então o campo cobre todos os clientes, inclusive IDEs, sem depender da telemetria do cliente

E se o mesmo modelo for usado como hospedado pelo Copilot e como customizado? Ele aparece em duas entradas separadas, cada uma com contagens reais de requisições e tokens, então os números não se misturam

Tome cuidado só com os nomes: modelos customizados passam pela normalização de nomes que já existia, e nome não reconhecido aparece como unknown

Limitações: limite inferior, totais inalterados e sem backfill

Antes de montar qualquer dashboard, vale conhecer as ressalvas que o próprio GitHub aponta

Os totais existentes não mudam. O uso de BYOK já era contado: o BYOK local é um subconjunto de totals_by_cli e totals_by_copilot_app, e os modelos customizados já estavam em totals_by_client

Traduzindo: não some os campos novos aos totais antigos, senão tu conta o mesmo uso duas vezes

O BYOK local é um piso. Esses campos dependem da telemetria do cliente e subcontam quando ela está desativada

Os tokens também podem vir abaixo do real, porque alguns provedores locais não reportam uso de tokens

Já as contagens de modelos customizados da empresa, como são observadas no servidor, não têm essa limitação

Não há backfill. Os dias de relatório anteriores ao lançamento não trazem is_custom_enterprise_model, então comparação histórica só faz sentido a partir dessa data

Para que admins podem usar os novos dados de BYOK?

O GitHub aponta quatro usos, e todos são bem práticos:

• Governar o BYOK: ver quem manda requisições pra chaves próprias, modelos locais ou modelos customizados da empresa e conferir isso com a política de BYOK
• Entender o gasto: separar o uso hospedado pelo Copilot do uso cobrado pelo próprio provedor ou rodado em modelos locais gratuitos, pra que o custo por usuário reflita o que o Copilot realmente serve
• Ter uma visão única: enxergar o uso de IA na empresa num lugar só, seja qual for o modelo ou o provedor escolhido pelos devs
• Comparar eficiência: agrupar usuários por uso de BYOK ou de modelo customizado e comparar com as métricas do Copilot que tu já acompanha

Se a ideia é automatizar a leitura desses relatórios com um agente, vale ver como pedir ao Claude Code para integrar uma API externa que você ainda não conhece

Quem pode acessar as métricas de BYOK do Copilot?

Têm acesso:

• Enterprise owners
• Enterprise billing managers
• Organization owners
• Quem tiver um papel customizado de organização ou de enterprise que conceda a permissão View Copilot Metrics

Além disso, a política de métricas de uso do Copilot precisa estar habilitada

A documentação de referência das métricas de uso do Copilot cobre o dashboard, as APIs e a exportação em NDJSON, e já documenta campos como totals_by_ide, totals_by_feature e totals_by_cli

Se tu já usa essa API pra outras análises, como medir a adoção dos Agents no VS Code, os campos de BYOK entram na mesma rotina de relatório

Próximo passo para quem administra o Copilot

Primeiro, confirme que a política de métricas de uso está ativa e revise quem tem a permissão View Copilot Metrics

Nos próximos relatórios, cruze used_local_byok e is_custom_enterprise_model com a política de BYOK da empresa pra ver se o uso real bate com o que foi liberado

E trate os números de BYOK local como piso, começando a série histórica a partir do dia do lançamento, já que não tem dado retroativo

Até o próximo post! 😀

Quer aprender mais sobre inteligência artificial e programação na prática? Conheça o canal Hora de Codar no YouTube e acompanhe os próximos vídeos.