Saltar para o conteúdo

Receitas

Cookbook: aplicação de orçamentos

Configure e opere orçamentos de gastos com IA — portões de limitação e bloqueio, o modelo de aplicação deny-closed.

Atualizado:

O Módulo XI (Custos e AI FinOps) contabiliza gastos de IA a partir do fluxo de custos do fornecedor e aplica orçamentos. No limite, um portão de orçamento nega o gasto. Isto é aplicação ao vivo, sempre ligada no binário predefinido — não uma funcionalidade on-demand que provisiona mais tarde. Se um orçamento esta configurado, o portão esta ativo.

Portões de orçamento

Um portão de orçamento tem dois modos de aplicação:

  • Throttle — limita a taxa de gasto, degradando graciosamente. O agente e abrandado, não parado completamente, até que o orçamento recupere ou um operador o aumente.
  • Block — negação rígida no limite. O agente recebe um sinal claro de que o seu orçamento esta esgotado e nenhum gasto adicional esta autorizado.

Ambos os modos são deny-closed: se o estado do orçamento e ilegível — um erro de armazém, uma linha corrompida, um registo em falta — o portão nega, nunca permite. Um estado de orçamento desconhecido e tratado como esgotado, não como ilimitado. Esta e a mesma postura que o resto da plataforma mantém para portões de aplicação (veja governança).

Contabilidade de custos

O gasto e derivado do fluxo de custos do fornecedor e de preços de referência verificados pelo operador geridos pelo Módulo X (Gestão de modelos e fornecedores). As amostras de custo vem de telemetria observada — os tokens, o modelo, o fornecedor — não da interceção de chamadas API. A plataforma não se coloca no caminho de inferência; le o sinal de custo fora de banda, da mesma forma que le todas as outras observações.

Os preços de referência são verificados pelo operador, não fabricados. O Módulo X permite declarar o preço por token ou por pedido para cada modelo e fornecedor, e a aplicação de orçamentos usa esse preço como base contabilistica. Se o preço declarado diverge do que o fornecedor realmente cobra, o portão de orçamento aplica contra o preço declarado — a plataforma não pode conhecer a fatura do fornecedor até que o fornecedor a reporte.

Configurar um orçamento

Os orçamentos tem escopo em três níveis:

  • Por inquilino — um teto para todos os gastos de IA dentro de um inquilino.
  • Por agente — um teto para os gastos de um único agente, dentro do seu inquilino.
  • Por modelo — um teto para gastos num modelo específico, dentro de um inquilino ou agente.

A aplicação e imediata. Assim que um orçamento e configurado com um limite e um modo de portão (throttle ou block), o portão esta ativo. Não há aquecimento, sem atraso, sem “a aplicação começará após o próximo ciclo de faturação.” O portão verifica o gasto acumulado contra o limite em cada evento de custo governado.

Os escopos de orçamento compoem-se por intersecao: um orçamento por agente e um orçamento por inquilino ambos se aplicam, e o primeiro limite alcancado aciona o seu portão. Um orçamento por modelo dentro de um agente e ainda mais restrito por quaisquer orçamentos por agente e por inquilino acima dele.

O que acontece no limite

Quando o gasto acumulado atinge ou excede o limite configurado:

  1. O portão de orçamento nega o gasto — throttle ou block, dependendo do modo.
  2. A negação e registada como um achado na superficie de achados da plataforma, com o escopo do orçamento, o limite e o gasto acumulado no momento da negação.
  3. O agente recebe um sinal claro de que o seu orçamento esta esgotado. A plataforma não descarta silenciosamente o pedido nem devolve um erro ambiguo.
  4. Se as notificações estão configuradas, a negação e encaminhada pelo Módulo XV.

Um gasto negado e um evento governado. E escrito no registo de auditoria na mesma transacao que a negação, portanto não há janela onde uma negação de orçamento não esteja registada.

Notificações

Os alertas de orçamento integram-se com o Módulo XV (Integrações de saída e notificações). Quando um orçamento se aproxima ou atinge o seu limite, o achado pode ser encaminhado para qualquer destino configurado:

  • Slack / Teams — notificação por canal ou mensagem direta.
  • PagerDuty / Opsgenie — escalação de alertas.
  • Webhook assinado — para integrações personalizadas.
  • SIEM — adicionado ao fluxo de exportação de auditoria.

Os destinos de notificação são provisionados pelo operador. Um portão de orçamento aplica independentemente de haver ou não um destino de notificação configurado — o portão e a aplicação, a notificação e a camada de consciencialização.

A interação com o kill switch

O kill switch e o portão de negação de todo o ambiente e sobrepoe-se a tudo, incluindo portões de orçamento. Quando o kill switch esta ativado:

  • Toda a atuação governada e negada, incluindo qualquer gasto que os portões de orçamento de outra forma limitariam ou permitiriam.
  • O modo throttle/block de um portão de orçamento e irrelevante — o ambiente esta parado.
  • Reativar o ambiente requer a aprovação de duplo controlo habitual (dois humanos distintos, sem caminho de break-glass para reativação).

O portão de orçamento e o kill switch são controlos independentes. Compoem-se, não competem: o kill switch e uma negação de superconjunto que subsume todos os outros portões.

Roteamento de modelos e orçamento

O Módulo X gere o roteamento de modelos com preços de referência verificados pelo operador. A aplicação de orçamentos consome estes preços — não mantém a sua própria tabela de preços nem fabrica dados de custo. A dependência e unidirecional:

  • O Módulo X declara o catalogo de modelos e preços de referência.
  • O Módulo XI le esses preços para contabilizar gastos e aplicar limites de orçamento.

Se o Módulo X não tem preço de referência para um modelo, o Módulo XI não pode contabilizar o gasto contra um orçamento. Gastos não governados (sem preço, sem orçamento) são apresentados como um achado, não passados silenciosamente.

Limites honestos

A aplicação de orçamentos esta ativa e deny-closed para as superficies que a plataforma governa, mas tem limites que deve compreender antes de confiar nela:

  • A precisão de custos depende do fornecedor. A plataforma contabiliza gastos usando preços de referência declarados pelo operador e contagens de tokens observadas. Se a faturação real do fornecedor difere do preço declarado, o portão de orçamento aplica contra o preço declarado, não contra a fatura. A plataforma não fabrica dados de custo nem inventa benchmarks.
  • A cobertura e limitada pela observação. A aplicação de orçamentos aplica-se a gastos que fluem através de canais governados — fontes que a plataforma observa. Um agente que chama um modelo através de um caminho não governado (nenhuma fonte ligada, nenhuma telemetria emitida) e invisivel para o portão de orçamento. A plataforma apresenta caminhos não governados como achados quando os consegue detetar, mas não pode aplicar sobre o que não consegue ver.
  • A plataforma e pre-1.0. A aplicação de orçamentos esta implementada e ligada hoje, mas trate o detalhe contabilístico como trabalho em progresso. Veja honestidade e limites para a postura completa.

Relacionado

  • Catalogo de módulos — Módulo XI (Custos e AI FinOps) e Módulo X (Gestão de modelos e fornecedores).
  • Governança — o modelo de aplicação deny-closed que os portões de orçamento seguem.
  • Tour FinOps — a página de produto para governança de custos.
  • Kill switch — o portão de negação de todo o ambiente que sobrepoe a aplicação de orçamentos.
  • Honestidade e limites — o que esta ativo versus em fase de design.

Pesquisar documentação