Uso de IA
A tela Uso de IA mede como o time usa ferramentas de IA de codificação (GitHub Copilot, Claude, Cursor e outras) e relaciona esse uso com produtividade e custo. Tudo é recortado pelos filtros globais de período e time do topo, além de um filtro por ferramenta na própria tela.
Visão geral#
A ideia é responder três perguntas:
- Quem está usando IA (adoção)?
- Quanto valor isso gera (aceitação, linhas, produtividade)?
- Quanto custa (custo em US$ e ROI)?
Os dados chegam por dois caminhos complementares, detalhados adiante: o import de CSV (volume por pessoa) e o Copilot Connector (adoção via API).
O que você verá: métricas#
| Métrica | O que é |
|---|---|
| Adoção | Desenvolvedores que usaram IA ÷ desenvolvedores ativos no período |
| Sugestões | Sugestões oferecidas pela ferramenta |
| Aceitas | Sugestões aceitas pelo dev |
| Taxa de aceitação | Aceitas ÷ sugeridas |
| Linhas aceitas | Linhas de código aceitas |
| Chats | Interações de chat com a ferramenta |
| Custo (US$) | Gasto estimado |
| ROI | Retorno relativo ao custo |
As abas#
Geral#
A visão consolidada da organização (respeitando os filtros):
- Faixa "Precisa de atenção" (topo): destila os sinais que pedem ação primeiro: cota perto/estourando o limite, adoção baixa, devs elegíveis que ainda não usam IA, ganho de produtividade dos adotantes e salto de custo vs. o período anterior. Quando há um link, o item leva direto à aba correspondente. Sem nada relevante, mostra o estado "saudável".
- Adoção: desenvolvedores que usaram IA no período ÷ desenvolvedores ativos (que autoraram PR).
- Usuários ativos, taxa de aceitação (aceitas ÷ sugeridas) e linhas aceitas.
- Tendência diária com alternância Aceitas / Custo: em "Aceitas" plota sugeridas × aceitas; em "Custo" mostra a trajetória de gasto dia a dia (não só o total do período). Clique num dia para detalhar por pessoa.
- Breakdown por ferramenta (com alternância Aceitas / Custo).
- Quota & custo: consumo vs. limite por ferramenta (com gauge e projeção), custo total e ROI.
Equipes#
Comparação por equipe: usuários ativos, sugestões, aceitas, taxa de aceitação, linhas e custo (US$ por aceita). Útil para ver onde a adoção pegou e onde ainda há espaço.
Pessoas#
Ranking por pessoa, ordenável (mais aceitas, maior custo, dias ativos, nome). Inclui a seção "Não usam IA": desenvolvedores elegíveis que não usaram IA no período, distinguindo quem nunca usou de quem parou em determinado momento.
Produtividade#
Correlaciona o uso de IA com PRs mergeados e cycle time por desenvolvedor: uma comparação de coorte (adotantes × não-adotantes) e um gráfico de dispersão com coeficiente de correlação.
Atenção: correlação não implica causa. Trate como sinal, não como prova.
Quota e reset#
Owner/Admin definem, por ferramenta, um limite sobre uma métrica (sugestões, aceitas, linhas, chats, usuários ativos ou custo) e a data de reset do ciclo. A tela mostra o consumo, a projeção ("estoura em ~N dias") e quando o ciclo reseta.
Como as ferramentas geralmente não expõem limites por API, o limite e a data de reset são configurados manualmente.
Importar uso (CSV)#
O caminho recomendado para popular dados reais por pessoa é o import CSV (botão Importar uso, Owner/Admin). Cole o conteúdo ou anexe um arquivo; baixe o modelo pelo botão Baixar modelo .csv.
Colunas reconhecidas (cabeçalho na 1ª linha):
| Coluna | Descrição |
|---|---|
email | E-mail do dev (casado com o autor de commits/PRs) |
login | Login do GitHub (fallback de casamento) |
date | Dia da métrica, no formato YYYY-MM-DD |
suggestions | Sugestões oferecidas |
acceptances | Sugestões aceitas |
linesAccepted | Linhas aceitas |
chats | Interações de chat |
costUsd | Gasto estimado em US$ |
Linhas cujo e-mail/login não casa com um desenvolvedor da organização são ignoradas e reportadas. Confira o relatório do import para corrigir o casamento.
Conector do GitHub Copilot#
Há um botão Sincronizar Copilot (Owner/Admin) que puxa a adoção real via API do Copilot (assentos ativos por pessoa). Requisitos:
- O GitHub App instalado na organização (a permissão de leitura do Copilot já vem com a instalação);
- A organização precisa ter Copilot Business ou Enterprise.
A Copilot Metrics API é agregada (org/equipe) e não expõe volume por desenvolvedor. Por isso o conector traz adoção (quem usa), enquanto sugestões/aceitas/linhas por pessoa continuam vindo do import CSV. Um sync diário automático pode ser ligado no servidor.
Alertas#
Em Metas → Alertas é possível criar regras relacionadas a IA, que notificam no Slack:
| Alerta | Dispara quando |
|---|---|
AI_ADOPTION_LOW | A adoção cai abaixo do esperado |
AI_QUOTA_NEAR_LIMIT | A quota se aproxima do limite configurado |
Boas práticas de leitura#
- Não use como vigilância individual. O objetivo é entender adoção, valor e custo no agregado, não ranquear pessoas para cobrança. A aba Pessoas existe para enablement (quem precisa de ajuda para adotar), não para punição.
- Leia adoção + aceitação + produtividade juntas: alta adoção com baixa aceitação pode indicar atrito com a ferramenta; lembre que produtividade aqui é correlação, não causa.
- Cruze custo com ROI antes de concluir que algo está caro: volume alto pode justificar o gasto.
Perguntas frequentes#
Por que minha tela mostra adoção mas nenhuma sugestão por pessoa? A adoção pode vir do Copilot Connector (agregado), enquanto o volume por pessoa (sugestões/aceitas/linhas) depende do import CSV. Importe um CSV para preencher o detalhe.
Importei o CSV e algumas linhas não apareceram.
Linhas cujo email/login não casa com um desenvolvedor da organização são ignoradas. Veja o relatório do
import e ajuste a coluna de casamento.
A ferramenta tem um limite real de uso?
A plataforma não lê limites por API. O limite e o reset são definidos manualmente por Owner/Admin para
alimentar o gauge, a projeção e o alerta AI_QUOTA_NEAR_LIMIT.
Próximos passos#
- Dashboards e telas: como os filtros de período e time recortam esta tela.
- Times e contribuidores: base para a aba Equipes e para a correlação por pessoa.
- Assistente de IA: pergunte sobre adoção e custo em linguagem natural.