Pular para o conteúdo principal

Gerenciar orçamentos e controles de custos para Genie

nota

A partir de 8 de julho de 2026, às 00:00 UTC, a Databricks cobra pelo uso do Genie Code além de uma franquia mensal gratuita. Administradores de account podem usar orçamentos para definir controles de custo.

O Genie Code é cobrado usando um modelo pay-as-you-go, com uma franquia mensal gratuita por usuário. O uso do Genie Code é rastreado através do Unity Gateway. Os administradores account podem definir orçamentos, que permitem rastrear e controlar os gastos do Genie Code para toda a sua account, para Workspace específicos, para grupos de usuários ou para usuários individuais e dar-lhe um alerta antes que os limites sejam atingidos.

Para saber mais sobre orçamentos, consulte Criar e monitorar orçamentos e Gerenciar orçamentos para o Unity Gateway.

Para obter uma abordagem em fases para planejar os gastos corporativos com o Genie, incluindo como fazer uma execução de um período de descoberta de uso e definir orçamentos por nível de persona, consulte Genie consumption guia.

Como funciona o faturamento do Genie​

O Genie Code, incluindo a Genie Code CLI, usa um modelo de preços pré-pago:

  • Uso mensal gratuito : cada usuário recebe uma quantidade gratuita de uso de LLM todo mês. O uso gratuito aplica-se a usuários identificados, e não a entidades de serviço do Databricks.
  • Uso sob demanda : O uso que excede o montante gratuito é faturado em DBUs com base na utilização do LLM subjacente.

Os orçamentos aplicam-se ao uso pago conforme o uso. Não é possível usar um orçamento para remover o uso mensal gratuito de um usuário.

Para preços atuais e a quantidade de uso gratuito, consulte a página de preços do Databricks.

Requisitos​

  • Você precisa ser administrador de contas para criar e gerenciar orçamentos.

Para delegar quem pode view e gerenciar um orçamento, conceda funções de orçamento a outros usuários, grupos ou Service Principal do Databricks. Consulte Gerenciar budget permissions.

Crie um orçamento para o Genie​

Orçamentos são criados e gerenciados no console da account. Para obter mais informações, consulte Criar e monitorar orçamentos.

Para criar um orçamento para o uso do Genie, use o tipo de recurso Unity Gateway e a tag de recurso databricks-product: genie. Se você adicionar outras tags de recurso, o uso do Genie deverá conter todas as tags que você adicionar. Caso contrário, o orçamento não rastreia nem controla esse gasto do Genie.

Siga estes passos para criar um orçamento do Genie com um limite compartilhado para um workspace, além de limites por usuário e substituições:

  1. Na barra lateral do console de contas, clique em Uso .

  2. Clique na tab Orçamentos. Esta tab mostra os orçamentos existentes para a conta.

  3. Clique em **Criar orçamento**.

  4. Na seção **Escopo**, defina o escopo para o orçamento:

    1. Insira um Nome para seu orçamento.
    2. No menu suspenso **Workspaces**, selecione os workspaces que você gostaria de incluir em seu orçamento. O orçamento é compartilhado entre todos os workspaces selecionados, fazendo o acompanhamento de seu uso combinado em relação aos mesmos limites, em vez de aplicar um orçamento separado a cada workspace. Selecione **All** para aplicar o orçamento a toda a sua account.
    3. No menu suspenso Resource types , selecione Unity Gateway .
    4. Na seção tags de recursos :
      1. Clique em Selecionar tags .
      2. No menu suspenso **key**, insira **databricks-produto**.
      3. No menu suspenso **Valores**, insira **genie**.
  5. Configure Limites compartilhados para definir um pool de uso que se aplica a todos os usuários e workspaces no escopo do orçamento.

    1. Clique em Ícone de mais. Adicionar limite .
    2. Insira um valor para o **limite mensal**. Este é o limite mensal compartilhado entre todos os usuários e workspaces definido no escopo do orçamento.
    3. Em Quando o limite for atingido , marque uma ou mais das opções Enviar email , Bloquear uso e Trigger webhook . Marcar Bloquear uso bloqueia o uso do Genie para todos os usuários quando o limite de orçamento é atingido. O Databricks recomenda não marcar Bloquear uso no limite compartilhado e usar limites e substituições por usuário para bloquear o uso.
    4. Se você marcou Enviar email , insira os Endereços de email para receber alertas de orçamento quando o uso atingir o limite.
    5. Se você marcou Trigger webhook , selecione um ou mais destinos. Consulte Trigger webhooks personalizados.
    6. Clique em Adicionar .
  6. Na seção Grupos e usuários , defina os limites default por usuário que se aplicam a cada usuário no escopo do orçamento. Você pode definir um limite diário, um limite mensal ou ambos. Os limites diários monitoram o gasto de cada dia do calendário UTC e são Reset às 00:00 UTC. Os limites mensais são Reset no primeiro dia de cada mês.

    1. Clique em Ícone de mais. Adicionar limite default .
    2. Em Limite diário , Limite mensal ou ambos, clique em Adicionar default e insira um valor em dólar. Esses limites se aplicam a cada usuário no escopo do orçamento, além de seu uso mensal gratuito. Por exemplo, insira $ 100 como limite mensal para dar a cada usuário um limite mensal de $ 100 e $ 10 como limite diário para limitar cada usuário a $ 10 por dia. Defina o limite diário menor que o limite mensal.
    3. Clique em Salvar .
  7. Adicione substituições por usuário para dar a alguns usuários ou grupos um limite maior:

    1. Clique em Ícone de mais. Adicionar grupo ou usuário .
    2. No menu suspenso Grupo ou usuário , selecione um usuário específico ou um grupo de usuários.
    3. Em Limite diário ou Limite mensal , clique em Adicionar substituição e insira um valor maior que o default para esse período. Por exemplo, dê ao grupo genie-code um limite mensal de $ 200.
    4. Clique em Salvar .
  8. Configure as ações para os limites por usuário:

    1. Em Ações , clique em Editar ações .
    2. Para o período Diário , o período Mensal ou ambos, marque uma ou mais opções de Enviar email , Trigger webhook e Bloquear uso . As ações para um período aplicam-se ao limite default e a todos os overrides para esse período.
    3. Se você marcou Enviar email , insira uma lista de endereços de email separados por vírgula no campo Endereços de email . Esses endereços recebem alertas quando os gastos de um usuário excedem seu limite. A notificação identifica o usuário, o período, o gasto e o orçamento.
    4. Se você marcou Trigger webhook , selecione um ou mais destinos. O payload do webhook identifica o usuário, o período, seus gastos e seu limite. Consulte Trigger webhooks personalizados.
    5. Clique em Salvar .
importante

As notificações por e-mail do orçamento incluem o nome do orçamento, a identidade do usuário para limites por usuário e as tags personalizadas definidas. Os destinatários de email não precisam ser usuários da Databricks. Certifique-se de que você esteja protegendo dados confidenciais ao nomear o orçamento, selecionar tags e adicionar destinatários de email.

  1. Clique em Criar .

Exemplo de configuração de orçamento para uso do Genie.

A imagem acima mostra uma configuração de orçamento de exemplo para uso do Genie no workspace dais-development, com um limite compartilhado de US$ 5.000 e um limite por usuário de US$ 100. As substituições por usuário concedem aos usuários do grupo genie-code um limite maior de $ 200 e aos usuários do grupo power-users $ 300 por mês. Se um usuário estiver em ambos genie-code e power-users, ele herda o limite mais permissivo de R$ 300.

Como os limites compartilhados e por usuário funcionam juntos​

Um único orçamento pode combinar um limite compartilhado mensal com limites diários e mensais por usuário (com substituições por usuário). Esses limites são avaliados independentemente. Quando um limite tem Bloquear uso habilitado, um usuário é bloqueado assim que o primeiro limite desse tipo é atingido:

  • Limite compartilhado : um pool mensal único de gastos pré-pagos compartilhado por todos no escopo do orçamento. Quando o pool se esgota, todos os usuários no escopo são bloqueados, mesmo que um usuário individual não tenha atingido seu limite por usuário.
  • Limites por usuário : o limite diário individual default, o limite mensal ou ambos, para cada usuário no escopo do orçamento. Quando um usuário atinge qualquer um desses limites, ele é bloqueado, mesmo que ainda haja orçamento disponível no Pool compartilhado. Um usuário bloqueado por um limite diário pode usar o Genie novamente após 00:00 UTC.
  • Substituições por usuário : um limite diário ou mensal mais alto para usuários ou grupos específicos. Uma substituição substitui o limite default por usuário para o mesmo período para esses usuários. Isso não substitui o limite compartilhado.

Uma substituição individual do usuário aumenta o limite individual de um usuário, não o Pool compartilhado. Um usuário não pode gastar além de um limite compartilhado esgotado, e um orçamento compartilhado não utilizado não permite que um usuário gaste além do seu próprio limite por usuário. A regra **mais permissiva** se aplica apenas entre os limites e as substituições por usuário: quando um usuário pertence a vários grupos com substituições diferentes, ele recebe o maior. Não se aplica entre o limite compartilhado e os limites por usuário.

Usando a configuração de exemplo anterior (um limite compartilhado de R$ 5.000, um limite por usuário de R$ 100, uma substituição de R$ 200 para genie-code e uma substituição de R$ 300 para power-users, todos com Bloquear uso habilitado):

  • Um usuário em power-users pode gastar até $ 300 em uso pré-pago, desde que o pool compartilhado de $ 5.000 não esteja esgotado.
  • Se o pool compartilhado de R$ 5.000 estiver esgotado, esse usuário será bloqueado mesmo que não tenha atingido seu próprio limite de R$ 300.
  • Um usuário em genie-code e power-users recebe o limite mais permissivo de $ 300, não $ 200.
  • Se o orçamento também tiver um limite diário de $ 10 por usuário, um usuário que gastar $ 10 em um dia será bloqueado até 00:00 UTC, mesmo que não tenha atingido seu limite mensal.

Monitorar e consultar o uso e custo do Genie​

Monitore o uso e o custo estimados do Genie na página de detalhes do orçamento, que refresh frequentemente. Consulte Ver detalhes do orçamento.

Para query e analisar o uso e o custo do Genie em sua account a partir das tabelas do sistema de faturamento, incluindo como o uso do Genie se mapeia para SKUs e como os preços promocionais aparecem em seus dados de uso, consulte Monitorar e entender seu custo do Genie.

Limitações​

importante

Os orçamentos para o Unity Gateway fornecem uma estimativa quase em tempo real dos gastos monitorados em relação aos limites configurados, e os custos reais incorridos podem diferir dos limites configurados. Este recurso destina-se a ajudar no controle de custos quase em tempo real. Não use este recurso como uma forma de garantir um limite absoluto de gastos nos valores finais faturados. A Databricks não é responsável por custos incorridos acima dos limites de orçamento configurados.

  • Orçamentos não podem remover o uso mensal gratuito de um usuário.

  • Cada orçamento oferece suporte a no máximo quatro limites compartilhados e 100 substituições por usuário.

  • Os limites compartilhados são apenas mensais. Os limites e substituições por usuário podem ser diários, mensais ou ambos. Para adicionar uma substituição para um período, o orçamento deve ter um limite default por usuário para esse período.

  • Sua account pode ter um máximo de 1.000 orçamentos.

  • Entidades de serviço da Databricks não recebem uso mensal gratuito e são cobradas por todo o seu uso.

  • Orçamentos monitoram o uso de LLM. Compute usado para executar queries, como um SQL warehouse, é cobrado separadamente e não está incluído nos orçamentos do Genie.

  • Pode haver um breve atraso entre a ocorrência do uso e o envio de um alerta.

  • Os limites de uso de bloqueio são aplicados aproximadamente. A aplicação usa uma estimativa de custo em tempo real, portanto, o gasto real pode variar acima ou abaixo do limite configurado. Isso significa:

    • Um usuário pode ser bloqueado antes que seu gasto real atinja o limite.
    • Um valor de gasto acima do limite pode ocorrer antes que a aplicação entre em vigor. As solicitações ativas do Genie em andamento quando o limite é atingido não são interrompidas.

    system.billing.usage permanece como a fonte da verdade para o uso faturável real. Para discrepâncias entre o uso monitorado em relação a um orçamento e os custos reais, a Databricks pode ajustar retroativamente as estimativas orçamentárias para reconciliá-las.

  • Os valores de gastos nos emails de alerta de orçamento, na página de detalhes do orçamento e system.billing.usage podem diferir quando comparados no mesmo momento. Isso é esperado, porque cada origem é atualizada em uma taxa diferente:

    • Emails de alerta de orçamento : Refletem o gasto no momento em que o alerta foi Trigger.
    • **Página de Detalhes do Orçamento**: Atualiza-se frequentemente, mas pode mostrar um valor inferior ao de um email de alerta recente quando visualizado pouco tempo depois.
    • system.billing.usage : Atualizações a cada poucas horas. Consultar tabelas do sistema pouco depois de receber um alerta pode retornar um valor de gasto menor do que a página de detalhes do orçamento ou emails de alerta.

    A aplicação do orçamento, incluindo o bloqueio de uso e os limites de alerta, baseia-se no acompanhamento de gastos quase em tempo real e não é afetada pelo tempo de refresh da tabela do sistema.

Recursos adicionais​