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

Skip to content
Menu da documentação

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.

FuncionalidadeO que fazNa área logada
AI CostsConsumo 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
BillingSaldo pré-pago, recargas, faturas e consumo de IA em reais./plataforma/models
Compute CostsUso medido do Compute por implantação, com teto mensal./plataforma/compute
AI Tool SeatsCusto 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 CostsFaturamento 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
OptimizationRecomendaçõ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 allocationCusto 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
AutoStoppingDesliga 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

  1. Defina o orçamento

    Em Consumo, ponha o orçamento e o alerta do workspace. Veja também Orçamento e modelos liberados.
  2. Conecte as fontes de nuvem

    Na tela de Consumo.
  3. 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": "…" } }.

bash
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.