Guia de consumo do Genie
Este guia ajuda os administradores de conta a planejar e governar os gastos do Genie em uma grande organização. O texto descreve uma abordagem em fases: observar primeiro o uso real, agrupar os usuários em camadas de persona com base nesses dados e, em seguida, definir orçamentos que correspondam a cada camada.
For the steps to create a budget, see Manage budgets and cost controls for Genie. To query usage in the billing system tables, see Monitor and understand your Genie cost.
Por que o planejamento baseado no uso é importante
Genie products are billed with a pay-as-you-go model, and each user receives a free monthly allowance. Because Genie usage is agentic, consumption per user varies far more than it does for traditional per-seat software. Consumption depends on the following:
- Usage pattern : How often someone uses Genie, and which products they use.
- Complexidade da tarefa : Corrigir um erro de digitação em uma query consome muito menos do que pedir ao Genie Code para criar e depurar um pipeline.
- Contexto disponível : A qualidade dos metadados disponíveis, o tamanho do seu catálogo e as instruções personalizadas disponíveis para o Genie.
Because these variables differ for every organization, top-down estimates based on a "typical tarefa" tend to produce surprises in both directions. Observe actual usage in your own environment before you commit to fine-grained per-user limits.
O uso é desigual por natureza. Nas implantações de clientes observadas, uma pequena fração dos usuários responde pela grande maioria do gasto total. Planeje-se para essa assimetria em vez de presumir uma distribuição uniforme em toda a sua população de usuários.
Abordagem recomendada
A Databricks recomenda definir primeiro os limites da conta e do workspace e dedicar tempo para entender como sua organização usa o Genie para identificar os níveis de usuário. Pense em otimizar os gastos e o orçamento da sua organização em três fases:
Fase | Goal | Configuração de orçamento |
|---|---|---|
Saiba como sua organização realmente usa o Genie. | Somente limite compartilhado de account ou Workspace. Alerta antes de bloquear. | |
Agrupe os usuários pelo consumo observado e pelo valor comercial. | Nenhuma alteração ainda. Analise o uso e crie grupos de usuários. | |
Aplicar limites por camada, mantendo uma rede de segurança em nível de account. | Limite compartilhado, além de limites e substituições por usuário. |
Em todo o processo, priorize "sem surpresas" em vez de otimização. Estabeleça a visibilidade e um limite máximo primeiro e, depois, otimize os gastos após entender sua linha de base.
Fase 1: Executar um período de descoberta
O objetivo do período de descoberta é observar o uso real, incluindo picos dos usuários mais intensivos, antes de definir limites individuais.
Escolha um período e escopo
- Período : 30 dias é o ideal, e 14 dias é o mínimo prático. Períodos mais curtos raramente capturam toda a gama de padrões de uso.
- Escopo : escolha um caso de uso representativo ou uma equipe em vez de habilitar todos de uma vez. Por exemplo, comece com uma equipe de engenharia de dados usando o Genie Code.
- Limite superior : defina o limite superior alto o suficiente para que seus usuários mais intensivos não o atinjam. Se o limite superior bloquear o uso cedo demais, você descobrirá qual é o seu limite em vez do que seus usuários precisam.
O uso do Genie One e dos agentes do Genie é gratuito até 31 de janeiro de 2027. Durante esse período promocional, esse uso não conta para a franquia mensal gratuita nem para o uso do Genie rastreado em relação a um orçamento. Um piloto desses produtos durante o período promocional mostra o uso na SKU GENIE_FREE_USAGE, em vez do gasto de pagamento conforme o uso (pay-as-you-go) faturado que você usa para dimensionar os orçamentos. Use o uso do Genie Code para estabelecer uma linha de base de custos durante esse período ou estime o custo equivalente a partir de seus dados de uso gratuito em system.billing.usage.
Configurar um orçamento de descoberta
Durante a descoberta, use limites compartilhados no nível da conta ou do workspace e ainda não defina limites por usuário.
- Criar um orçamento com escopo para o Genie. Use o tipo de recurso Unity Gateway e a tag de recurso
databricks-product: genie. Veja Criar um orçamento para o Genie. - Set the scope to All workspaces for an account-wide view, or select specific workspaces to limit discovery to a pilot.
- Adicione um limite compartilhado no nível de gastos até o qual você deseja observar, com apenas Enviar alerta selecionado. Adicione limites apenas de alerta mais baixos, por exemplo, a 80%, para receber um aviso à medida que os gastos aumentam. Um orçamento oferece suporte a até quatro limites compartilhados.
- Opcionalmente, adicione um limite compartilhado final com Block usage selecionado como uma proteção rígida contra gastos excessivos. Como você ainda não definiu limites por usuário, essa proteção bloqueia todos os usuários no escopo quando o pool compartilhado se esgota. Portanto, defina-o com um valor alto o suficiente para que seus usuários mais intensivos não o atinjam durante a descoberta.
Algumas organizações preferem um único orçamento centralizado em nível de account, enquanto a maioria prefere gerenciar orçamentos em nível de workspace. Se você configurar um orçamento em nível de account e em nível de workspace, um não substituirá o outro. O limite que for atingido primeiro envia alertas, bloqueia o uso ou ambos, dependendo da sua configuração.
Durante a operação normal, emita um alerta sobre os gastos agregados da account e do Workspace e reserve o bloqueio para limites individuais de usuários, para que o gasto de um usuário não possa interromper a todos. A descoberta é a exceção: sem limites por usuário em vigor ainda, um limite de bloqueio compartilhado é sua única proteção, portanto, mantenha-o alto.
Acompanhe o uso à medida que ele se desenvolve
Durante o período de descoberta, monitore o consumo para identificar quais são os seus usuários com maior uso e o que está impulsionando os gastos deles:
- Use a página de detalhes do orçamento para acompanhar o gasto estimado em tempo real durante o mês atual. Veja Ver detalhes do orçamento. Como esta página mostra os gastos acumulados no mês que sofrem reset no primeiro dia de cada mês, use-a para monitoramento, e não para dimensionar camadas em um período de descoberta que ultrapasse a virada do mês.
- Query
system.billing.usagepara o uso por usuário e por produto agregado ao longo do intervalo de datas exato do período de descoberta. Esta é a base confiável para o dimensionamento de camadas. Consulte Monitor and understand your Genie cost. - Defina alertas para equipes que você espera que sejam usuárias intensivas, para que você fique sabendo sobre o consumo delas antes que se aproximem do limite.
Phase 2: Define persona tiers
Após o período de descoberta, agrupe seus usuários em camadas com base no que você observou. Derive esses níveis a partir de dados de uso reais em vez de defini-los antecipadamente: definir limites por usuário e por grupo antes da descoberta significa adivinhar limites que seus usuários ainda não mostraram a você. A maioria das organizações encontra uma distribuição semelhante à seguinte. Os nomes variam, mas as responsabilidades são consistentes.
Persona | Descrição | Tratamento típico de orçamento |
|---|---|---|
Iniciantes em AI | Use o Genie ocasionalmente para aumentar a produtividade. O uso permanece mínimo, com picos ocasionais. | Menor limite por usuário. Muitos desses usuários permanecem dentro da franquia mensal gratuita. |
Profissionais de IA | Use o Genie regularmente. Use o Genie One para entregar percepções ou o Genie Code para criar e otimizar pipelines de dados. | Limite moderado por usuário, definido a partir da mediana observada e do consumo no 75º percentil. |
Usuários avançados de AI | Execute tarefas de agentes de longa execução e assíncronas que geram valor organizacional significativo. | Maior limite por usuário, aplicado como substituição ao grupo de usuários avançados. |
Defina limites para iniciantes altos o suficiente para que os usuários possam evoluir para profissionais. Um limite que bloqueie alguém que esteja experimentando o Genie pela primeira vez prejudica sua produtividade.
Dimensionar cada camada com seus próprios dados
Use os dados do período de descoberta em vez de heurísticas fixas. Baseie seu dimensionamento nos gastos faturados do modelo pay-as-you-go, que é o que os orçamentos monitoram. Como a franquia mensal gratuita já está excluída dos gastos faturados, não a subtraia novamente.
- Estabeleça sua linha de base total : faça uma query do uso total faturado do Genie para o intervalo de datas exato do período de descoberta nas tabelas do sistema de faturamento. Consulte Monitore e entenda seu custo do Genie.
- Segmente seus usuários por consumo : classifique os usuários pelo gasto faturado durante o período de descoberta e identifique sua mediana, o 75º percentil e os usuários com maior consumo. Estes se tornam seus níveis de iniciante, profissional e usuário power.
- Calcular os totais por nível : multiplique os gastos faturados medianos e do 75º percentil observados pelo número de usuários em cada nível.
- Adicione margem para usuários avançados e crescimento : o consumo de usuários avançados varia demais para ser tirada uma média. Adicione um multiplicador ao seu teto para acomodá-los e aplique uma taxa de crescimento que reflita sua adoção esperada. Mantenha o total dentro do que sua organização aprovou para gastos com IA.
- Crie um grupo de usuários por nível : crie um grupo da account para cada persona, como
genie-beginners,genie-practitionersegenie-power-users, e adicione os usuários ao grupo correspondente ao uso observado deles. Os orçamentos aplicam limites a esses grupos na fase 3.
Você pode pedir ao Genie para ajudar com esta análise. Para obter os melhores resultados, certifique-se de ter acesso a system.billing.usage, system.access.assistant_events e system.access.audit.
Considere um processo de aprovação para limites mais altos
Em vez de aumentar os limites de forma reativa quando os usuários são bloqueados, defina como um usuário solicita um limite mais alto. Um aplicativo ou processo de tíquete para acesso de usuários avançados permite conceder limites altos deliberadamente, em troca de valor demonstrado, e fornece um registro do motivo pelo qual cada substituição existe.
Phase 3: Set budgets by persona
Com os níveis definidos e os grupos de usuários criados, evolua seu orçamento de descoberta para a governança por nível. Mantenha o teto da sua conta e do workspace no lugar como uma rede de segurança.
Um único orçamento pode combinar o seguinte:
- limite compartilhado : o pool agregado para todos no escopo. Baseie isso no seu uso total observado mais a sua taxa de crescimento. Alerta em 80% e bloqueio em 100%.
- Threshold por usuário : o limite individual default, definido a partir do seu nível de iniciante. Isso se aplica a todos os usuários no escopo.
- Substituições por usuário : limites mais altos para seus grupos de profissionais e usuários avançados.
Para saber os passos de configuração, consulte Criar um orçamento para o Genie.
Os limites compartilhados e os limites por usuário são avaliados de forma independente. Nenhum substitui o outro, e um usuário é bloqueado assim que o primeiro limite com Bloquear uso ativado for atingido. Uma substituição por usuário aumenta um limite individual, e não o pool compartilhado. Consulte Como os limites compartilhados e por usuário funcionam juntos.
Separar o envio de alertas do bloqueio
Os limites compartilhados e os limites por usuário lidam com alertas e bloqueios de maneira diferente; portanto, combine-os de forma deliberada:
- No limite compartilhado , organize até quatro limites para alertar antes de bloquear. Por exemplo, defina um limite somente para alertas em 80% do Pool e um limite de bloqueio de uso em 100%. Isso avisa os administradores à medida que o pool agregado se enche e, em seguida, interrompe os gastos no limite máximo.
- Em um limite por usuário , as ações são herdadas em todo o limite por usuário default e em todas as substituições. Para habilitar um limite de alerta e um limite de bloqueio, crie dois orçamentos: um apenas para alerta e outro apenas para bloqueio.
Escopo de orçamento e produtos do Genie
Todos os produtos Genie compartilham a tag de recurso databricks-product: genie; portanto, um único orçamento cobre o Genie Code, o Genie One e os agentes Genie juntos, e não é possível definir um orçamento para um produto Genie individual. Durante o período promocional, apenas o Genie Code é cobrado; portanto, os orçamentos cobrem efetivamente os gastos com o Genie Code, enquanto o uso do Genie One e dos agentes Genie é gratuito.
Para alinhar os limites com diferentes padrões de uso, delimite as substituições por usuário para grupos de usuários que reflitam a forma como cada grupo trabalha. Por exemplo, conceda a um grupo de engenharia de dados um limite do Genie geral maior do que o de um grupo de analistas de negócios. Quando um usuário pertence a vários grupos, aplica-se a substituição mais permissiva dentro de um orçamento.
Os orçamentos rastreiam apenas o uso de grandes modelos de linguagem (LLM). O compute usado para executar as queries geradas pelo Genie, como um SQL warehouse, é cobrado separadamente e não é contabilizado no orçamento do Genie.
Práticas recomendadas para o uso eficiente do Genie Code
O Genie Code é baseado em agentes; portanto, o quanto ele consome depende de quão eficientemente os usuários trabalham com ele. Cada turno reenvia todo o contexto da conversa para o modelo, e uma tarefa com agentes executa vários turnos para planejar, agir e verificar seu trabalho. O consumo cresce tanto com a extensão de uma conversa quanto com a quantidade de contexto que ela carrega; portanto, a vigésima mensagem em uma conversa custa mais do que a primeira. O objetivo é manter o contexto de cada conversa relevante para a tarefa em questão.
Uma regra prática útil é tratar o Genie Code como um novo colega de trabalho competente: dê contexto suficiente para concluir a tarefa na primeira tentativa, sem precisar retornar para esclarecimentos.
Share the following practices with your users, and reinforce them with workspace instructions and agent skills so Genie Code applies them automatically. Because instructions load with every message, keep them lean.
Incentive os usuários a aproveitarem os recursos que não consomem o uso pago. Sugestões de preenchimento automático embutidas, sugestões de correção rápida e renomeação, e a revisão de resultados que o Genie já gerou em um espaço não consomem a franquia paga. Cada usuário também recebe uma franquia mensal gratuita que é redefinida no primeiro dia do mês. Reservar o chat para trabalhos que realmente precisam dele estende ainda mais essa franquia.
Gerenciar a janela de contexto
- Inicie um novo chat para cada tarefa. Esta é a alavanca mais eficaz. Um novo chat limpa a janela de contexto, de modo que uma nova tarefa não carregue tokens de trabalhos não relacionados. Mantenha o trabalho relacionado no mesmo chat para que o Genie Code retenha o contexto e reutilize seu cache de prompts, mas inicie um novo chat ao mudar de assunto. O Genie Code resume, compacta e trunca automaticamente contextos longos, mas somente um novo chat o limpa completamente.
- Disable MCP servers you aren't using. Each connected MCP server adds its tools to what Genie Code carries in context. Turn off servers a chat doesn't need.
Dê ao Genie Code o que ele precisa antecipadamente
Quanto menos o Genie Code precisar explorar para entender sua intenção e seus dados, menos ele consumirá.
- Referencie ativos com
@. Para trabalhar com uma tabela, um arquivo ou um notebook específico, aponte para ele com@em vez de pedir ao Genie Code para encontrá-lo. - Seja específico sobre a tarefa e a saída. Descreva a tarefa, o nível de detalhe, o formato e o tamanho desejados em um único prompt. Prompts vagos acionam uma exploração ampla e rodadas de acompanhamento; prompts específicos permitem que o Genie Code trabalhe com leituras mínimas e uma resposta mais curta.
- Mostre um exemplo em vez de descrever um. Uma breve amostra da saída ou da query desejada transmite a intenção em menos tokens do que uma descrição longa.
- Não repita o contexto que o Genie Code já tem. O Genie Code já consegue ver seu esquema e o chat atual; portanto, repetir nomes de tabelas ou resultados anteriores em cada prompt adiciona tokens sem adicionar informação.
- Documente seus dados. Adicione comentários de tabelas e colunas no Unity Catalog para que o Genie Code entenda seu esquema em vez de adivinhar. Consulte Adicionar comentários gerados por IA a objetos do Unity Catalog.
- Forneça atalhos determinísticos. Forneça ao Genie Code ferramentas confiáveis, como views de métricas e funções do Unity Catalog, para operações comuns. Use comandos de barra como
/findTablespara prompts comuns que, de outra forma, exigiriam vários tokens para serem formulados.
Ajustar o esforço do modelo à tarefa
Most tasks run well on the default effort level, Auto , which optimizes for quality. Para tarefas simples e bem definidas, defina o nível de esforço como Baixo para usar um modelo mais rápido e barato.
Guie trabalhos longos ou complexos
- Trabalhe em etapas e verifique à medida que avança. Divida uma tarefa grande em tarefas menores e confirme cada resultado antes de continuar, para que um erro seja detectado enquanto ainda é barato de corrigir.
- Forneça alvos de verificação. Inclua a saída esperada, um exemplo ou o erro exato para que o Genie Code possa verificar o próprio trabalho em vez de iterar.
- Faça correções de curso antecipadamente. Se o Genie Code começar a entrar em loop, voltar atrás ou explorar de forma muito ampla, interrompa-o e adicione esclarecimentos em vez de deixá-lo continuar.
Reutilize o trabalho repetido com skills
Para uma tarefa que uma equipe executa com frequência, como configurar um pipeline padrão, gerar um relatório de rotina ou executar verificações de qualidade, capture o trabalho uma vez em uma skill em vez de deduzi-lo do zero todas as vezes. Uma skill pode incluir um script executável, de modo que o Genie Code reconheça a solicitação, carregue a skill e execute o script em vez de planejar, gerar e iterar a cada execução. Isso transforma uma tarefa de vários turnos em um único turno de baixo consumo, e uma skill do workspace espalha a economia entre todos que executam a mesma tarefa. Bons candidatos são tarefas que sua equipe realizou várias vezes com um formato consistente.
Para obter mais maneiras de receber respostas melhores e mais eficientes, consulte Dicas para melhorar as respostas do Genie Code.
Fique atento a estes drivers de consumo comuns:
- Chats maratona : continuar um chat longo em várias tarefas não relacionadas em vez de iniciar um novo chat.
- Círculos sem convergência : uma tarefa ambígua ou difícil pode fazer com que o Genie Code entre em loop, retroceda ou explore de forma muito ampla. Quando isso acontecer, interrompa o Genie Code e forneça esclarecimentos.
- Exploração excessivamente ampla : Pedir ao Genie Code para ler centenas de ativos quando ele precisa apenas de uma pasta específica.
Diagnose a cost spike
Quando os gastos do Genie aumentam inesperadamente, os orçamentos e as tabelas do sistema mostram quando isso aconteceu e quem os impulsionou, mas não o porquê . Encontre a causa antes de alterar os limites:
-
Encontre onde o consumo está concentrado. Faça uma query em
system.billing.usagepara ver quais workspaces e usuários impulsionaram o aumento e em quais datas. Consulte Monitorar e entender seu custo do Genie. Para classificar seus principais usuários do Genie Code e as tarefas mais movimentadas deles, use o painel de eventos do Genie Code. Veja Medir o impacto do Genie Code. -
Descubra o motivo. Para os usuários que estão impulsionando o pico, analise o que eles realmente fizeram em vez de parar nos totais:
- Use o dashboard de eventos do Genie Code para ver os chats mais intensos e o tipo de trabalho por trás deles, como criar um dashboard, criar um pipeline ou editar vários ativos.
- Compare o que você vê com os drivers de consumo comuns: chats em maratona, giros sem convergência e exploração excessivamente ampla.
- Para uma resposta específica e dispendiosa ou fora do esperado, peça ao usuário para clicar no ícone de bug no final da resposta — o que copia o ID da sessão — e envie-o para a equipe da sua conta. O ID da sessão permite que o Databricks rastreie o que impulsionou o consumo.
-
Corrija a causa específica. Forneça ao usuário afetado a única prática que resolve o que você encontrou, em vez de toda a lista:
- Chats da Marathon: comece um novo chat para cada tarefa.
- Exploração ampla ou leituras pesadas de ativos: faça referência a ativos com
@e escreva prompts mais precisos. - Tarefas simples repetidas no modelo default: defina o nível de esforço como Low .
- Falta de diretrizes: confirme se as instruções e as habilidades do workspace estão configuradas. Para ver o conjunto completo de práticas, consulte Práticas recomendadas para o uso eficiente do Genie Code.
-
Limite os gastos se necessário. Se um usuário ou grupo exceder consistentemente o que você aprovou, aplique ou reduza uma substituição por usuário. Consulte Criar um orçamento para o Genie.
Eduque seus usuários
Os orçamentos funcionam melhor quando os usuários os entendem. Como parte da sua implantação, informe o seguinte aos usuários:
- O uso do Genie é faturado, e cada usuário recebe uma franquia mensal gratuita que é Reset no primeiro dia de cada mês.
- A complexidade da tarefa afeta o consumo. Grandes tarefas de agentes consomem mais do que perguntas curtas.
- O que acontece quando eles atingem um limite e como solicitar um limite maior.
Para obter respostas a perguntas comuns, consulte Perguntas frequentes sobre custos e orçamentos do Genie.
Limitações
Os orçamentos fornecem uma estimativa de gastos em tempo real aproximado e não constituem um limite absoluto de gastos. Revise a lista completa de limitações antes de confiar nos orçamentos para o controle de custos. Consulte Limitações.
Mais recursos
- Gerenciar orçamentos e controles de custos para o Genie
- Monitore e entenda seu custo do Genie
- Perguntas frequentes sobre custos e orçamentos do Genie
- Dicas para melhorar as respostas do Genie Code
- Medir o impacto do Genie Code
- Criar e monitorar orçamentos
- Analisar o custo do Unity Gateway
- Preços do Genie