Gerenciar orçamentos e controles de custos para Genie

nota

A partir de 8 de julho de 2026, às 00:00 UTC, a Databricks cobrará pelo uso do produto Genie além de um subsídio mensal gratuito. Para obter detalhes, consulte a nota sobre a versão. Administradores account podem usar orçamentos para definir controles de custos.

Os produtos Genie são cobrados usando um modelo pré-pago, com uma franquia mensal gratuita por usuário. O uso do Genie é rastreado por meio do Unity AI Gateway. Os administradores de conta podem definir orçamentos, que permitem rastrear e controlar os gastos do Genie para toda a sua conta, para workspaces específicos, para grupos de usuários ou para usuários individuais, e alertá-lo 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 AI Gateway.

Como funciona o faturamento do Genie

Os produtos Genie, incluindo Genie Agents, Genie Code e Genie One, compartilham um único modelo de preços pay-as-you-go:

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

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 AI Gateway e a tag de recurso databricks-product: genie. Não adicione outras tags de recurso a um orçamento do Genie. Tags adicionais não são suportadas e impedem que o orçamento rastreie o uso 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. Deixe o campo vazio para rastrear o uso de toda a sua account.
   3. No menu suspenso Tipos de recurso , selecione Gateway de AI do Unity .
   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 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 esgotar**, marque **Enviar alerta** e/ou **Bloquear uso**. A verificação de Bloquear uso bloqueia o uso do Genie para todos os usuários quando o limite do orçamento é atingido. A Databricks recomenda verificar apenas **Enviar alerta** e, em seguida, usar limites por usuário e substituições para bloquear o uso.
   4. Se você marcou **Enviar alerta**, digite **endereços de email** para receber alertas de orçamento quando o uso atingir o limite.
   5. Clique em Adicionar .

6. Configure os limites por usuário para definir o limite mensal que se aplica a cada usuário no escopo do orçamento.

   1. Clique em Adicionar limite .
   2. Insira um valor em dólar no campo **Limite mensal**. Esse limite se aplica a todo usuário no escopo do orçamento, além de seu uso mensal gratuito. Por exemplo, insira R$ 100 para conceder a cada usuário um limite mensal de R$ 100.
   3. Em **Quando o limite esgotar**, marque **Enviar alerta** e/ou **Bloquear uso**. A seleção de Bloquear uso bloqueia o uso do Genie para o usuário quando o limite do orçamento for atingido. É possível configurar substituições por usuário para conceder a determinados usuários ou grupos um limite superior.
   4. Insira uma lista de endereços de e-mail separados por vírgulas no campo Endereços de e-mail . Esses endereços recebem alertas quando os gastos de um usuário excedem o limite. A notificação identifica o usuário, seus gastos acumulados no mês e o orçamento.

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.

7. Adicione substituições por usuário para dar a alguns usuários ou grupos um limite maior:

   1. Clique em Adicionar substituição .
   2. No dropdown **Usuários**, selecione um usuário específico ou um grupo de usuários.
   3. Insira um valor em dólar no campo **Limite mensal**. Este limite sobrescreve o limite por usuário para os usuários selecionados. Por exemplo, atribua ao grupo genie-code um limite de R$ 200 para que esses usuários obtenham um limite superior. Se um usuário estiver em mais de um grupo de usuários, ele herda o limite mais permissivo dentro do orçamento.
   4. Clique em Adicionar .

8. Clique em Criar .

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.

Monitorar e consultar o uso e custo do Genie

Monitore o uso e o custo do Genie na página de detalhes do orçamento, que reflete o uso em tempo quase real. Consulte Ver detalhes do orçamento.

Analise o uso e o custo do Genie em sua account consultando a tabela do sistema de uso faturável. system.billing.usage atualiza a cada poucas horas. Se você consultar tabelas do sistema logo após o uso ocorrer, os resultados podem apresentar um gasto menor do que a página de detalhes do orçamento.

A seguinte consulta calcula o total de DBUs e o custo de preço de tabela para o uso do Genie, agrupados por data, usuário e superfície do Genie. Ele une system.billing.usage com system.billing.list_prices para aplicar o preço correto para cada registro de uso:

SQL

SELECT
  u.usage_date,
  u.identity_metadata.run_as,
  u.usage_metadata.genie.surface,
  SUM(u.usage_quantity) AS total_dbus,
  SUM(u.usage_quantity * lp.pricing.effective_list.default) AS total_cost
FROM system.billing.usage u
JOIN system.billing.list_prices lp
  ON u.cloud = lp.cloud
  AND u.sku_name = lp.sku_name
  AND u.usage_start_time >= lp.price_start_time
  AND (lp.price_end_time IS NULL OR u.usage_start_time < lp.price_end_time)
WHERE
  u.billing_origin_product = 'GENIE'
GROUP BY ALL

O campo genie.surface identifica qual produto Genie gerou o uso.

Limitações

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

• Cada orçamento suporta um máximo de quatro limites compartilhados e 20 substituições por usuário.

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

• Quando o Bloquear uso é configurado em um limite, uma pequena quantidade de gastos além do limite ainda pode ocorrer. Solicitações ativas do Genie em andamento quando o limite é atingido não são interrompidas, e há um breve atraso antes que o bloqueio de uso seja imposto.

• 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

• Criar e monitorar orçamentos
• Gerenciar orçamentos para o Gateway de IA do Unity
• Monitorar o custo do Gateway de AI do Unity
• Logs de auditoria para AI/BI

Perguntas frequentes

Quando o uso mensal gratuito é redefinido?

O uso mensal gratuito é redefinido no primeiro dia de cada mês.

Como faço para conceder a cada usuário $ 30 por mês?

Crie um orçamento delimitado ao Genie e defina um limite por usuário de $ 30. O limite se aplica a cada usuário no escopo do orçamento, limitando o gasto pay-as-you-go de cada usuário a $ 30 por mês. Cada usuário também mantém seu uso mensal gratuito, o qual o orçamento não pode remover. Para conceder um limite maior a usuários ou grupos específicos, adicione uma substituição por usuário ou por grupo. Consulte Criar e monitorar orçamentos.

O que acontece quando um orçamento do Genie é esgotado?

Quando um usuário atinge um limite de orçamento, o que acontece depende da ação que o administrador definiu para o orçamento.

• Alerta : Um alerta é enviado para todos os endereços de email configurados para o limite que foi atingido, e o usuário pode continuar usando os produtos Genie.
• Bloqueio de uso : O usuário não pode usar produtos Genie até que o orçamento seja Reset ou um administrador aumente seu limite. O usuário vê uma mensagem de que o orçamento atingiu o limite.

Os usuários sempre mantêm sua utilização mensal gratuita, a qual um orçamento não pode remover. Para conceder a um usuário bloqueado mais uso pago, um administrador pode aumentar o limite do usuário com uma substituição por usuário ou por grupo.

O que acontecerá se eu não bloquear o uso no meu orçamento?

Se você não marcar Bloquear uso para um limite, o Databricks somente envia alertas quando o limite é atingido. Os usuários podem continuar usando produtos Genie até que outro limite que bloqueie o uso, como uma substituição por usuário, seja atingido.

É possível definir orçamentos diferentes para o Genie One, Genie Agents e Genie Code?

Não. Não é possível separar os orçamentos por produto. O Genie One, Genie Agents e Genie Code compartilham uma única tag de recurso databricks-product: genie, para que todos os gastos contem para o mesmo orçamento, independentemente do produto que os gerou. Por exemplo, um usuário que gasta $ 2 no Genie One e $ 10 no Genie Code tem $ 12 contados em seu orçamento mensal.

Embora você não possa definir o escopo de orçamentos por produto, você pode definir o escopo de orçamentos por grupos de usuários. Por exemplo, você pode criar um grupo de usuários para cada produto, como geniecodeusers para desenvolvedores e genieoneusers para analistas. Você pode então definir um limite por usuário para cada grupo, como $200 para geniecodeusers e $100 para genieoneusers. Quando um usuário pertence a vários grupos, o limite mais permissivo se aplica. Um usuário em geniecodeusers e genieoneusers teria $200 para gastar em todos os produtos Genie.

Qual orçamento se aplica quando mais de um orçamento está no escopo do Genie?

O limite efetivo de um usuário é o **limite mais permissivo dentro de um orçamento, mas o limite mais restritivo entre orçamentos**:

• Dentro de um orçamento: Se apenas um orçamento estiver no escopo do Genie e um usuário pertencer a um grupo de usuários com um limite de $ 100 e outro grupo de usuários com um limite de $ 200, o limite mais permissivo será aplicado, então o usuário receberá $ 200.
• Entre orçamentos : se um administrador criar mais de um orçamento com escopo para o Genie, o limite mais restritivo aplica-se. Por exemplo, se o limite mais permissivo de um usuário for de $ 100 em um orçamento e de $ 200 em outro, o usuário é bloqueado em $ 100.

Como faço para monitorar os gastos do Genie?

Os dados de gastos e uso estão disponíveis a partir de 8 de julho de 2026.

Para revisar os gastos, use o seguinte:

• Página de detalhes do orçamento: Ver gastos do mês atual, orçamento restante e gastos por usuário para orçamentos definidos para o Unity AI Gateway. Ver Ver detalhes do orçamento.
• Tabela do sistema de uso faturável : consulte system.billing.usage para análise de custos de toda a account. Para um exemplo, consulte consultar o uso e o custo do Genie. Para saber mais sobre a tabela do sistema, consulte Referência da tabela do sistema de uso faturável.