Operação
Cost Management
Custo de IA, de nuvem e de Kubernetes com orçamento, alerta e recomendações; o que entra por chave de API e o que só existe na tela.
#O que faz
Custos de IA e de nuvem com orçamento, alertas, atribuição e recomendações.
| Funcionalidade | O que faz | Na área logada |
|---|---|---|
| AI Costs | Consumo de IA por modelo, chave e projeto, em dólar e em reais, com orçamento, alerta e perspectivas salvas com dono que agrupam o custo pelas regras do negócio. | /plataforma/consumo |
| Billing | Saldo pré-pago, recargas, faturas e consumo de IA em reais. | /plataforma/models |
| Compute Costs | Uso medido do Compute por implantação, com teto mensal. | /plataforma/compute |
| AI Tool Seats | Custo mensal dos assentos de Copilot, Cursor e Claude Code, assentos ociosos (sem uso em 30 dias) com desperdício em dólar e em reais e gasto on-demand do Cursor; a tela fica em Engineering Intelligence. | /plataforma/engenharia/adocao-ia |
| Cloud Costs | Faturamento de AWS e GCP, custo da OpenAI e da Anthropic pela API de custos de cada uma, ou CSV no formato FOCUS, normalizado por serviço, time e serviço do catálogo, com categorias e rateio, orçamento, anomalias, sugestão de dimensionamento e perguntas de custo por time e período. | /plataforma/consumo |
| Optimization | Recomendações de economia em IA (modelo maior que o necessário, prompt inchado) com evidência, estimativa, aceite humano e economia realizada depois do aceite. Não mede cache; a economia de nuvem fica com o custo de nuvem e a alocação. | /plataforma/consumo/otimizacao |
| Cost allocation | Custo de Kubernetes por cluster e namespace com ocioso, custo por unidade de negócio, regras de ativos como código com correção recomendada, recomendação de compromissos e de escala de cluster. Só recomenda: nada é comprado nem alterado na nuvem. | /plataforma/consumo/alocacao |
| AutoStopping | Desliga o Deployment ocioso e religa sob demanda pelo agente de entrega instalado no cluster do cliente: a regra (minutos ociosos e limite de CPU) só vale depois que outra pessoa aprova pelo hash, congelamento e política que nega vencem a aprovação, e a AIUBY não guarda credencial do cluster. Religar é um pedido na tela, não o primeiro acesso; só Deployments da entrega em Kubernetes. | /plataforma/entrega/kubernetes |
#Como ativar
- Custo de IA, otimização e alocação ficam no Guard; saldo e consumo de IA, no Models; custo do Compute, no Compute; assentos de ferramentas de IA, no Cortex (tela de Engineering Intelligence). O dono adiciona o produto em Produtos.
- Custo de nuvem: conecte o faturamento da AWS ou do GCP, as APIs de custo da OpenAI e da Anthropic, ou envie um CSV no formato FOCUS, na tela.
- O envio por chave (abaixo) pede o Guard ativo e uma chave de API com Enviar uso de Kubernetes e métricas de negócio
costs:ingest.
#Primeiro uso
Defina o orçamento
Em Consumo, ponha o orçamento e o alerta do workspace. Veja também Orçamento e modelos liberados.Conecte as fontes de nuvem
Na tela de Consumo.Mande o uso do cluster pelo CI ou por um job
Veja o exemplo abaixo.
#Envio de uso e métricas
Rotas da plataforma (fora da v1): respondem JSON direto e erro como { "error": { "message": "…" } }.
curl -X POST https://aiuby.com/api/platform/finops-allocation/k8s \
-H "Authorization: Bearer $AIUBY_TOKEN" -H "Content-Type: application/json" \
-d '{"cluster":"prod-sp","day":"2026-11-17","costBrl":1200,"cpuCapacity":64,"memoryCapacity":256,"nodes":8,
"namespaces":[{"name":"checkout","cpuUsed":12.5,"memoryUsed":40}]}'
curl -X POST https://aiuby.com/api/platform/finops-allocation/units \
-H "Authorization: Bearer $AIUBY_TOKEN" -H "Content-Type: application/json" \
-d '{"points":[{"metric":"pedidos","day":"2026-11-17","value":5300}]}'k8s: um dia de um cluster, com custo, capacidade, nós (e quantos são spot) e o uso por namespace (até 500). Até 256 KB.units: volume diário das métricas de negócio, para o custo por unidade. O nome da métrica usa minúsculas, dígitos e sublinhado.- A leitura dos relatórios (as mesmas rotas com GET) é só pela sessão, na tela.
#Rotas da API
O Cost Management ainda não tem rota na API v1. O gasto de assentos de IA sai em GET /api/v1/engineering/ai-efficiency (veja Engineering Intelligence) e o custo de IA também pelo servidor MCP da AIUBY (configuração em aiuby mcp config).
#O que ainda não existe
- Ler custo, orçamento ou recomendação por chave de API.
- Comprar compromisso ou mudar a nuvem: a alocação só recomenda.
- Medir economia de cache de prompt.