Guia de uso do Genie

Este guia ajuda administradores de contas a planejar e administrar os gastos do Genie em uma grande organização. Ele descreve uma abordagem faseada: observe primeiro o uso real, agrupe os usuários em níveis de persona com base nesses dados e, em seguida, defina orçamentos que correspondam a cada nível.

Para os passos para criar um orçamento, veja Gerenciar orçamentos e controles de custos para o Genie. Para consultar o uso nas tabelas de faturamento do sistema, consulte Monitorar e entender os custos do Genie.

Por que o planejamento baseado no uso é importante

Os produtos Genie são faturados com um modelo pay-as-you-go, e cada usuário recebe uma mesada mensal gratuita. Como o uso do Genie é agêntico, o consumo varia muito mais de um usuário para outro do que em softwares tradicionais licenciados por estação. O consumo depende do seguinte:

• Padrão de uso: Com que frequência alguém usa o Genie e quais produtos utiliza.
• Complexidade da tarefa: Corrigir um erro de digitação em uma consulta demanda muito menos do que pedir ao Genie Code para construir 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.

Como essas variáveis diferem para cada organização, estimativas de cima para baixo baseadas em uma "tarefa típica" tendem a causar surpresas em ambas as direções. Observe o uso real no seu próprio ambiente antes de se comprometer com limites detalhados por usuário.

Abordagem recomendada

O Azure Databricks recomenda definir primeiro tetos de contas e espaços de trabalho, e dedicar tempo para entender como sua organização usa o Genie para identificar níveis de usuário. Pense em otimizar os gastos e o orçamento da sua organização em três fases:

Durante todo o processo, priorize "sem surpresas" em vez de otimização. Estabeleça visibilidade e um teto primeiro, depois otimize os gastos depois de entender sua linha de base.

Fase 1: Conduzir um período de descoberta

O objetivo do período de descoberta é observar o uso real, incluindo picos dos seus usuários mais intensos, antes de definir limites individuais.

Escolha um período de tempo e escopo

• Prazo: 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.
• Teto: Coloque o teto alto o suficiente para que seus usuários mais pesados não o atinjam. Se o limite restringir o uso cedo demais, você acaba descobrindo qual é o seu limite, em vez de entender do que seus usuários precisam.

Configure um orçamento de descoberta

Durante a descoberta, use limites compartilhados no nível da conta ou do espaço de trabalho e ainda não defina limites por usuário.

1. Crie um orçamento com escopo definido para o Genie. Use o tipo de recurso Unity Gateway e a tag de recurso databricks-product: genie. Veja Criar um orçamento para Genie.
2. Defina o escopo como Todos os worskpaces para uma visualização de conta ampla, ou selecione workspaces específicos para limitar a descoberta a um piloto.
3. Adicione um limite compartilhado no nível de gastos que você deseja monitorar, com apenas Enviar alerta selecionado. Adicione limiares mais baixos apenas para alertas, por exemplo, a 80%, para que você receba um aviso conforme o gasto aumenta. Um orçamento suporta até quatro limites compartilhados.
4. Opcionalmente, adicione um limite compartilhado final, selecionando Bloquear uso como um limite de segurança rígido contra gastos excessivos. Como você ainda não definiu limites por usuário, esse limite de segurança bloqueia todos os usuários no escopo quando o pool compartilhado se esgota; portanto, configure-o com um valor alto o suficiente para que os usuários com maior consumo não atinjam esse limite durante a descoberta.

Observe o uso conforme ele se desenvolve

Durante o período de descoberta, monitore o consumo para identificar quem são seus usuários mais frequentes e o que está impulsionando seus gastos:

• Use a página de detalhes do orçamento para acompanhar os gastos estimados quase em tempo real durante o mês atual. Consulte os detalhes do orçamento. Como esta página mostra o gasto acumulado no início de cada mês, use para monitoramento, não para dimensionar níveis ao longo de um período de descoberta que ultrapasse um limite mensal.
• Consulte system.billing.usage para saber o uso por usuário e por produto, agregado em todo o intervalo exato de datas do seu período de descoberta. Esta é a base confiável para o dimensionamento das camadas. Consulte Monitor e entenda o custo do Genie.
• Defina alertas para times que você espera serem usuários intensos, assim você aprende sobre o consumo deles antes que eles se aproximem do teto.

Fase 2: Defina os níveis de persona

Após o período de descoberta, agrupe seus usuários em níveis com base no que você observou. Derive esses níveis a partir de dados reais de uso, em vez de defini-los de imediato: definir limites por usuário e por grupo antes da descoberta significa adivinhar limites que seus usuários ainda não mostraram. A maioria das organizações encontra uma distribuição semelhante à seguinte. Os nomes variam, mas as responsabilidades são consistentes.

Dimensione cada nível a partir dos seus próprios dados

Use seus dados do período de descoberta em vez de heurísticas fixas. Baseie o dimensionamento nos gastos faturados conforme o uso, que é o que os orçamentos controlam. Como a franquia mensal gratuita já está excluída dos gastos faturados, não a subtraia novamente.

1. Estabeleça sua linha de base total: consulte o total de uso cobrado do Genie para o intervalo exato de datas do seu período de descoberta a partir das tabelas do sistema de faturamento. Consulte Monitor e entenda o custo do Genie.
2. Segmente seus usuários por consumo: Ordene os usuários por gastos faturados durante o período de descoberta e identifique sua mediana, percentil 75 e usuários mais frequentes. Esses se tornam seus níveis para iniciantes, praticantes e usuários avançados.
3. Calcule os totais por nível: Multiplique sua mediana observada e o 75º percentil de gastos faturados pelo número de usuários em cada nível.
4. Reserve uma margem para usuários avançados e para o crescimento: o consumo dos usuários avançados varia demais para se calcular uma média. Adicione um multiplicador ao seu teto para acomodar essas pessoas 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.
5. Crie um grupo de usuários por nível: Crie um grupo de conta para cada persona, como genie-beginners, genie-practitioners, e genie-power-users, e adicione usuários ao grupo que correspondam ao uso observado. Os orçamentos aplicam limites a esses grupos na fase 3.

Considere um processo de aprovação para limites mais altos

Em vez de aumentar os limites reativamente quando usuários são bloqueados, defina como um usuário solicita um limiar mais alto. Um processo de solicitação ou abertura de ticket para acesso de usuários avançados permite conceder limites elevados de forma deliberada, com base no valor demonstrado, e fornece um registro do motivo pelo qual cada exceção existe.

Fase 3: Definir orçamentos por persona

Com níveis definidos e grupos de usuários criados, evolua seu orçamento de descoberta para uma governança por nível. Mantenha sua conta e o limite do espaço de trabalho definidos como medida de segurança.

Um único orçamento pode combinar o seguinte:

• Limiar compartilhado: O pool agregado para todos dentro do escopo. Baseie isso no seu uso total observado e na sua taxa de crescimento. Alerta a 80% e bloqueio a 100%.
• Limite por usuário: O limite padrão de indivíduo, definido a partir do seu nível 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 as etapas de configuração, veja Criar um orçamento para o Genie.

Separar alertas de bloqueio

Limiares compartilhados e por usuário lidam com alertas e bloqueios de forma diferente, então combine-os deliberadamente:

• No limite compartilhado, configure até quatro limiares para alertar antes de bloquear. Por exemplo, defina um limite apenas para alertas em 80% do pool e um limite de Uso de bloco em 100%. Isso alerta os administradores à medida que o pool total se aproxima do limite e interrompe os gastos ao atingir o teto.
• Em um limite por usuário, as ações são herdadas pelo limite padrão por usuário e todas as substituições. Para habilitar tanto um limite de alerta quanto um limite de bloqueio, crie dois orçamentos, um apenas para alertas e outro apenas para blocos.

Escopo de orçamento e produtos Genie

Todos os produtos Genie compartilham a databricks-product: genie tag de recurso, então um único orçamento cobre Código Genie, Genie One e Agentes Genie juntos, e você não pode definir um orçamento para um produto Genie individual. Durante o período promocional, apenas o Código Gênio é faturável, então os orçamentos cobrem efetivamente os gastos com o Código Gênio, enquanto o uso do Gênio Um e dos Agentes Gênios é gratuito.

Para alinhar os limites a diferentes padrões de uso, restrinja as substituições por usuário aos grupos de usuários que reflitam a forma como cada grupo trabalha. Por exemplo, dê a um grupo de engenharia de dados um limiar geral Genie mais alto do que a 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 modelos de linguagem de grande porte (LLM). O computo usado para rodar as consultas geradas pelo Genie, como um SQL warehouse, é faturado separadamente e não conta para o orçamento do Genie.

Melhores práticas para uso eficiente do Código Genie

O Genie Code funciona como agente, então o quanto consome depende da eficiência com que os usuários o utilizam. Cada turno reenvia todo o contexto da conversa para o modelo, e uma tarefa agentiva envolve vários turnos para planejar, agir e verificar o próprio trabalho. O consumo cresce tanto com o tempo de um chat quanto com a quantidade de contexto que ele carrega, então a vigésima mensagem em um chat custa mais que a primeira. O objetivo é manter o contexto de cada chat relevante para a tarefa em questão.

Uma regra prática útil é tratar o Código Genie como um novo colega capaz: dê contexto suficiente para terminar a tarefa na primeira tentativa, sem precisar voltar para esclarecimentos.

Compartilhe as práticas a seguir com seus usuários e reforce-as com instruções de espaço de trabalho e habilidades de agentes para que o Genie Code as aplique automaticamente. Como as instruções carregam a cada mensagem, mantenha-as enxutas.

Gerenciar a janela de contexto

• Comece um novo chat para cada tarefa. Essa é a alavanca mais eficaz. Um novo chat limpa a janela de contexto, então uma tarefa nova não carrega tokens de trabalhos não relacionados. Mantenha as tarefas relacionadas no mesmo chat para que o Genie Code retenha o contexto e reutilize o cache de prompt, mas comece um novo chat quando passar para outra tarefa. O Genie Code resume, compacta e trunca automaticamente contextos longos, mas apenas uma nova conversa os limpa completamente.
• Desative os servidores MCP que você não está usando. Cada servidor MCP conectado adiciona suas ferramentas ao que o Genie Code carrega em contexto. Desligue os servidores de que um chat não precisa.

Dê ao Código Gênio o que ele precisa desde o início

Quanto menos o Código Genie precisa explorar para entender sua intenção e seus dados, menos ele consome.

• Referenciar ativos com @. Para trabalhar com uma tabela, arquivo ou notebook específico, use @ para apontar para ele, em vez de pedir ao Genie Code para encontrá-lo.
• Seja específico sobre a tarefa e o resultado. Descreva a tarefa, o nível de detalhe e o formato e duração que você deseja em um único prompt. Prompts vagos levam a uma exploração mais ampla e a rodadas adicionais de acompanhamento; prompts específicos permitem que o Genie Code opere com o mínimo de leituras e gere uma resposta mais curta.
• Mostre um exemplo em vez de descrever um. Uma amostra curta da saída ou consulta que você deseja transmite intenção em menos tokens do que uma descrição longa.
• Não repita o contexto que o Código Gênio já tem. O Genie Code já pode ver seu schema e o chat atual, então repetir nomes de tabelas ou resultados anteriores em cada prompt adiciona tokens sem acrescentar 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 aos objetos do Catálogo do Unity.
• Forneça atalhos determinísticos. Forneça ao Genie Code ferramentas confiáveis, como visualizações métricas e funções do Catálogo Unity, para operações comuns. Use comandos com barra, como /findTables, para solicitações comuns que, de outra forma, exigiriam vários tokens para formular.

Adapte o esforço do modelo à tarefa

A maioria das tarefas funciona bem no nível de esforço padrão, Auto, que prioriza a qualidade. Para tarefas simples e bem definidas, defina o nível de esforço para Baixo para usar um modelo mais rápido e barato.

Guie trabalhos longos ou complexos

• Trabalhe em etapas e verifique conforme avança. Divida uma tarefa grande em subtarefas e confirme cada resultado antes de continuar, para que um desvio de rumo seja identificado quando o custo de corrigi-lo ainda é baixo.
• Dê metas de verificação. Inclua o resultado esperado, um exemplo ou o erro exato para que o Código Gênio possa verificar seu próprio trabalho em vez de iterar.
• Corrija o rumo cedo. Se o Código Gênio começar a se repetir, voltar atrás ou explorar de forma muito ampla, pare e adicione esclarecimentos em vez de deixar continuar.

Reutilizar trabalho repetitivo com habilidades

Para uma tarefa que a equipe executa com frequência, como configurar um pipeline padrão, gerar um relatório de rotina ou realizar verificações de qualidade, registre esse trabalho uma única vez como uma habilidade, em vez de ter que pensar em como fazê-lo do zero todas as vezes. Uma habilidade pode incluir um script executável, então o Código Genie reconhece a solicitação, carrega a habilidade e executa o script em vez de planejar, gerar e iterar a cada execução. Isso transforma uma tarefa com múltiplas rodadas em uma única vez de baixo consumo, e uma habilidade de espaço de trabalho distribui a economia entre todos que executam a mesma tarefa. Bons candidatos são tarefas que sua equipe já realizou várias vezes com uma forma consistente.

Para mais maneiras de obter respostas melhores e mais eficientes, veja Dicas para melhorar as respostas do Código Genie.

Fique atento a esses fatores comuns de consumo:

• Conversas intermináveis: Continuar a mesma conversa por muito tempo ao longo de várias tarefas não relacionadas, em vez de iniciar uma nova conversa.
• Circulação sem convergência: Uma tarefa ambígua ou difícil pode fazer com que o Código Gênio se curve, retroceda ou explore de forma muito ampla. Quando isso acontecer, pare o Genie Code e forneça esclarecimentos a ele.
• Exploração excessivamente ampla: Pedir ao Genie Code para ler centenas de assets quando ele só precisa de uma pasta específica.

Diagnosticar um aumento repentino de custo

Quando o gasto com Genie aumenta inesperadamente, os orçamentos e as tabelas do sistema mostram quando isso aconteceu e quem o causou, mas não por que. Encontre a causa antes de mudar os limites:

1. Encontre onde o consumo está concentrado. Consulte system.billing.usage para ver quais espaços de trabalho e usuários impulsionaram o aumento, e em quais datas. Consulte Monitor e entenda o custo do Genie. Para classificar seus principais usuários do Código Genie e suas tarefas mais ocupadas, use o painel de eventos do Código Genie. Veja o impacto do Measure Genie Code.
2. Descubra o porquê. Para os usuários que impulsionam o pico, vejam o que eles realmente fizeram, em vez de parar nos totais:
   • Use o painel de eventos do Genie Code para ver os chats mais complexos e o tipo de trabalho envolvido neles, como a criação de um painel a criação de um pipeline ou a edição de vários ativos.
   • Compare o que você está vendo com os fatores comuns de consumo: conversas intermináveis, discussões em círculos sem chegar a uma conclusão e exploração ampla demais.
   • Para uma resposta dispendiosa ou fora do esperado, peça ao usuário que clique no ícone de bug no fim da resposta, o que copia o ID da sessão, e o envie para a equipe da sua conta. O ID da sessão permite que o Azure Databricks rastreie o que impulsionou o consumo.
3. Corrija a causa específica. Dê ao usuário afetado a única prática que aborda o que você encontrou, em vez da lista completa:
   • Conversas maratona: comece um novo chat para cada tarefa.
   • Exploração ampla ou leitura intensiva de ativos: faça referência aos ativos com @ e escreva prompts mais precisos.
   • Tarefas simples repetidas no modelo padrão: definir o nível de esforço para Baixo.
   • Proteções ausentes: confirme se as instruções e as habilidades do workspace estão configuradas. Para o conjunto completo de práticas, veja Melhores práticas para uso eficiente do Código Genie.
4. Limite o gasto se necessário. Se um usuário ou grupo ultrapassar consistentemente o que você aprovou, solicite ou reduza uma substituição por usuário. Veja Criar um orçamento para Genie.

Eduque seus usuários

Orçamentos funcionam melhor quando os usuários os compreendem. Como parte do seu lançamento, diga aos usuários o seguinte:

• O uso do Genie é faturado, e cada usuário recebe uma mesada mensal gratuita que é reiniciada no primeiro dia de cada mês.
• A complexidade das tarefas afeta o consumo. Tarefas grandes baseadas em agentes consomem mais do que perguntas curtas.
• O que acontece quando eles atingem um limite e como pedir um mais alto.

Para respostas a perguntas comuns, veja o FAQ sobre custos e orçamentos do Genie.

Limitações

Orçamentos fornecem uma estimativa quase em tempo real dos gastos e não são um limite absoluto de gastos. Revise a lista completa de limitações antes de depender dos orçamentos para controle de custos. Confira Limitações.

Recursos adicionais

• Gerenciar orçamentos e controles de custo para o Genie
• Monitore e entenda o custo do seu Genie
• Perguntas frequentes sobre custos e orçamentos do Genie
• Dicas para melhorar as respostas do Genie Code
• Medir o impacto do Genie Code
• Crie e monitore orçamentos
• Analisar o custo do Unity Gateway
• Preços do Genie