This page is not yet available in English. Read it in Portuguese

Skip to content
Menu da documentação

Inteligência

Engineering Intelligence

DORA com fórmula e amostra, fluxo de PRs, revisão de código por IA com portão no CI, times, itens de trabalho e eficiência do uso de IA.

#O que faz

Fluxo de PRs, risco de mudança, métricas de entrega e eficiência do uso de IA.

FuncionalidadeO que fazNa área logada
PR flowPRs por semana, tempo até o merge e PRs abertos, sincronizados do GitHub./plataforma/cortex
PR reviewLeitura do PR por IA, com custo medido e auditoria./plataforma/cortex
Code ReviewRevisão estruturada de PR por IA com regras do time por repositório: achados por arquivo e linha com sugestão, nota de risco por fórmula fixa, revisores sugeridos pelo CODEOWNERS e pelo grafo, portão consultável pelo CI e conferência da política de branch no GitHub. A publicação no PR e a revisão automática são opções à parte./plataforma/engenharia/revisao-codigo
Delivery metricsFrequência de implantação e taxa de falha com fórmula e janela, lead time do CI à implantação do mesmo commit, MTTR quando houver dado e achados de segurança abertos por time, com tendência semanal./plataforma/engenharia/entrega
DORA metricsFrequência de implantação, taxa de falha de mudança (falha, rollout abortado, volta ou incidente no serviço numa janela configurável), lead time pelo vínculo commit→PR e tempo para restaurar, por serviço, time e workspace, com tendência semanal, retrabalho de PR e gasto de IA lado a lado (correlação, não causa). Fontes: Compute, rollouts do Kubernetes, Cortex e Incidentes da AIUBY, com perfil por workspace do que conta como produção e como falha; implantações de fora da AIUBY não entram. Lead time só quando a revisão ou o rollout informa o commit./plataforma/engenharia/dora
Teams and goalsTimes em árvore com identidade unificada do desenvolvedor (Git, tickets, chat), perfil DORA configurável, itens de trabalho enviados pela API, sprints, esforço por categoria, higiene do backlog, adoção de IA com pesquisa (só em grupo), metas com alerta, painéis, exportação CSV e relatório pela API v1./plataforma/engenharia/inteligencia
Graph questionsPerguntas em linguagem natural ao grafo de entrega, respondidas só com evidência citada./plataforma/engenharia/perguntas
AI efficiencyAdoção e gasto de GitHub Copilot, Claude Code (Admin API da Anthropic) e Cursor por time, pelas APIs administrativas oficiais: assentos ociosos com custo desperdiçado e PRs mesclados lado a lado, como correlação, não causa. Visão por pessoa só para owner/admin; sem prompts nem código. O que cada API não entrega aparece como não coletado./plataforma/engenharia/adocao-ia

#Como ativar

  • Na área logada: o dono adiciona o Cortex em Produtos (veja Produtos e conta pré-paga). As telas ficam no menu do produto.
  • Pela API v1 e pela CLI: a organização precisa do Cortex ativo, de conta de faturamento válida e de uma chave de API ligada ao workspace, com o escopo da rota.
  • Adoção e gasto de ferramentas de IA pedem as credenciais administrativas de cada ferramenta (GitHub Copilot, Anthropic, Cursor), na tela.

Nota

Produto da plataforma não ativo ou módulo não liberado para a organização: a API v1 responde 404 not_found, como se a rota não existisse. Sem conta de faturamento válida: 402. Veja API v1.

#Primeiro uso

bash
curl "https://aiuby.com/api/v1/engineering/dora?days=30" -H "Authorization: Bearer $AIUBY_TOKEN"

aiuby dora --days 30
aiuby insights delivery --days 30
aiuby intel --team plataforma
aiuby ai-efficiency

Indicador sem dado suficiente vem com value: null e o motivo em missing: a API nunca estima.

#Itens de trabalho pela API

Chave com Enviar itens de trabalho (tickets) engineering:ingest. Até 500 itens por envio, de qualquer ferramenta (Jira, Linear ou outra).

bash
curl -X POST https://aiuby.com/api/v1/engineering/work-items \
  -H "Authorization: Bearer $AIUBY_TOKEN" -H "Content-Type: application/json" \
  -d '{"items":[{"source":"jira","key":"LOJA-42","title":"Novo checkout","type":"feature","status":"in_progress","team":"pagamentos","points":5}]}'
  • type: feature, bug, task, chore, debt, incident ou other. status: open, in_progress, done ou canceled.

#Portão de revisão no CI

bash
curl "https://aiuby.com/api/v1/code-review/check?repo=empresa/api&pr=128&sha=$GITHUB_SHA" -H "Authorization: Bearer $AIUBY_TOKEN"

aiuby code-review check --repo empresa/api --pr 128 --sha "$GITHUB_SHA"   # 0 passou; 6 reprovou, incompleta ou sem revisão

status volta pass, fail, incomplete ou missing (ainda não há revisão desta versão). O sha tem de ser o commit da ponta do PR, com 40 caracteres.

Limite

O portão é auxiliar: não substitui revisão humana nem a proteção de branch do GitHub.

#Rotas da API

RotaEscopoPara quêCLI
GET /api/v1/engineering/insights/deliveryLer a engenharia (API v1) engineering:readIndicadores de entregaaiuby insights delivery
GET /api/v1/engineering/doraLer a engenharia (API v1) engineering:readIndicadores DORAaiuby dora
GET /api/v1/engineering/ai-efficiencyLer a engenharia (API v1) engineering:readAdoção e gasto de ferramentas de IAaiuby ai-efficiency
GET /api/v1/engineering/intelLer a engenharia (API v1) engineering:readInteligência de engenharia por timeaiuby intel
POST /api/v1/engineering/work-itemsEnviar itens de trabalho (tickets) engineering:ingestEnviar itens de trabalho (tickets)aiuby work-items push
GET /api/v1/code-review/reviewsLer a engenharia (API v1) engineering:readRevisões de PR por IAaiuby code-review list
GET /api/v1/code-review/reviews/{id}Ler a engenharia (API v1) engineering:readUma revisão de PRaiuby code-review get <id>
GET /api/v1/code-review/checkLer a engenharia (API v1) engineering:readPortão de revisão de um PR (para o CI)aiuby code-review check
GET /api/v1/code-review/branch-policyLer a engenharia (API v1) engineering:readPolítica de branch conferida no GitHubaiuby code-review branch-policy
GET /api/v1/code-review/metricsLer a engenharia (API v1) engineering:readMétricas da revisão por IAaiuby code-review metrics

#O que ainda não existe

  • Pergunta em linguagem natural pela API: POST /api/v1/engineering/query só aceita intenção do catálogo fechado e responde 400 question_not_supported para question. A pergunta livre fica na tela.
  • Número por pessoa pela API: os relatórios são por time e workspace.
  • Implantação feita fora da AIUBY no DORA.