Pular para o conteúdo principal
Última atualização em

Construtor de Aplicativos Genie

info

Beta

Esse recurso está em Beta. Para usá-lo, um administrador do Workspace deve ativar Governed agentic app-building na página Previews . Consulte Gerenciar prévias do Databricks.

O Genie App Builder permite que você crie aplicativos do Databricks na UI do Databricks, descrevendo-os em linguagem natural. Descreva o aplicativo que você deseja, e o Genie App Builder o gera com Databricks AppKit, o framework do Databricks para aplicativos de dados e AI. Você analisa uma prévia funcional, refinando-a com prompts de acompanhamento e, em seguida, implanta-a.

O Genie App Builder cria aplicativos dentro de um Espaço de aplicativo . Um Espaço de aplicativo é um limite de governança onde os administradores definem quem pode criar e usar aplicativos, quais permissões esses aplicativos têm e quais políticas de gastos se aplicam a eles. A visualização de Criação de aplicativos baseada em agentes governados ativa o Genie App Builder e os Espaços de aplicativo. Veja Espaços de aplicativo.

Use o Genie App Builder para criar aplicativos internos de dados e AI rapidamente sem escrever código. Para controlar o código do aplicativo, o runtime ou o dimensionamento por conta própria, crie um aplicativo a partir de um padrão ou crie um aplicativo personalizado.

Requisitos​

Para usar o Genie App Builder, você precisa do seguinte:

  • Um workspace em uma região suportada:

    ap-northeast-1, ap-south-1, ap-southeast-1, ap-southeast-2, eu-central-1, eu-west-1, us-east-1, us-east-2, us-west-1, us-west-2

    As regiões do AWS GovCloud não são suportadas.

  • Recursos de AI desenvolvidos por parceiros ativados no nível da account e do Workspace. Consulte Recursos de AI oferecidos por parceiros.

  • O processamento cross-Geo está ativado, se o Geo do seu workspace exigir isso. Consulte Ativar processamento cross-Geo.

  • CAN CREATE APP permissão em um Espaço de aplicativo. Veja Permissões de Espaço de aplicativo.

  • Os navegadores dos usuários podem acessar *.databricksapps.com, onde o editor e a visualização são execução. As listas de acesso IP e as configurações do Private Link de front-end do workspace se aplicam a esse tráfego. Com o Private Link de front-end, databricksapps.com deve resolver para seu endpoint privado. Veja Controles de entrada.

Criar um aplicativo​

Descreva o aplicativo em linguagem natural e refine-o com prompts de acompanhamento até que ele funcione da maneira que você deseja.

  1. No seu workspace do Databricks, abra a página inicial de Aplicativos e clique na tab Build na navegação à esquerda.
  2. Selecione o App Space onde deseja criar o aplicativo.
  3. (Opcional) Insira um nome para o aplicativo.
  4. Insira um prompt de linguagem natural que descreva o aplicativo. Consulte Dicas para obter melhores resultados.
  5. O Genie App Builder gera uma prévia do aplicativo. Quando solicitado, clique em Sign in e conclua o login na nova tab do navegador. Veja Fazer login na pré-visualização.
  6. Refine o aplicativo com prompts de acompanhamento.
  7. Quando o aplicativo funcionar da maneira desejada, faça sua implantação.

Os aplicativos implantados escalam para zero quando parados e começam novamente quando um usuário os solicita. Consulte Runtime de aplicativos.

Para continuar melhorando um aplicativo implantado, clique em Genie App Builder na página de detalhes do aplicativo.

Entre na visualização​

A visualização é carregada a partir de um domínio diferente do seu workspace; portanto, você deve entrar nele separadamente. O login abre em uma nova tab do navegador. Se o seu navegador bloquear pop-ups para o workspace, permita-os e clique em Tentar novamente .

A visualização também precisa de cookies de terceiros. Se o seu navegador os bloquear, permita cookies de terceiros para o Workspace nas configurações do navegador ou clique em Abrir em uma nova tab para view a visualização em sua própria tab.

Compartilhar um app​

Depois de implantar um aplicativo, compartilhe-o para que outros usuários possam execução:

  1. Na página de detalhes do aplicativo, clique em Compartilhar .
  2. Adicione usuários ou grupos e selecione um nível de permissão:
    • CAN USE: Execução e interaja com o aplicativo.
    • CAN MANAGE: Edite, compartilhe e exclua o aplicativo.

A configuração de autorização de usuário do App Space limita quem pode usar o aplicativo. Se o espaço usa Qualquer role , você pode compartilhar o aplicativo com qualquer usuário. Se o espaço usa Apenas a role selecionada , você pode compartilhar apenas com usuários que podem assumir essa role, e eles devem assumi-la para usar o aplicativo. Veja Role-based access control e Configurar permissões para um aplicativo Databricks.

Acesso aos dados​

Um aplicativo criado com o Genie App Builder acessa dados de uma de duas maneiras:

  • Como usuário conectado : Com a autorização do usuário, o aplicativo age com a identidade do usuário que se conecta a ele. O aplicativo só pode acessar os dados e recursos que o usuário já pode acessar, e apenas dentro dos escopos que o App Space permite. Se o space exigir uma função, o aplicativo agirá com as permissões dessa função. Consulte Escopos.
  • Como o aplicativo : os administradores podem adicionar Dados compartilhados , como tabelas e volumes do Unity Catalog , e Recursos compartilhados, como SQL Warehouse e serving Endpoint, ao App Space. Cada aplicativo no espaço pode usá-los com sua própria identidade. Consulte Adicionar recursos a um aplicativo Databricks.

Por exemplo, quando um usuário abre um aplicativo de dashboard que usa autorização de usuário, o aplicativo query apenas as tabelas do Unity Catalog para as quais o usuário tem permissão de leitura.

Dicas para melhores resultados​

Para obter melhores resultados com o Genie App Builder, siga estas dicas:

  • Comece de forma simples e faça iterações : comece com um prompt curto e adicione recursos com prompts de acompanhamento em vez de descrever todo o aplicativo em um único prompt grande. Ciclos de iteração curtos funcionam melhor, especialmente quando você está começando.
  • Seja específico sobre a interface de usuário e o comportamento : descreva as páginas que o aplicativo deve ter, as entradas inseridas pelos usuários, os gráficos ou as tabelas a serem exibidos e as ações que os usuários podem executar. Informe também como o aplicativo deve se comportar, incluindo quais filtros aplicar, quais valores default usar e onde o aplicativo grava os dados.

Por exemplo:

  • Geral : "Crie um painel de ventas."
  • Específico : "Criar um dashboard de ventas com uma página. Mostrar um gráfico de barras da receita mensal por região e uma tabela das 10 principais accounts por receita. Adicionar um filtro de região que usa EMEA por default."

Runtime de aplicativos​

Os aplicativos criados com o Genie App Builder são em execução em um compute Serverless isolado e sob demanda. Cada aplicativo fica em execução em no máximo uma instância e escala para zero após um período de inatividade. A primeira solicitação após a escala para baixo do aplicativo leva mais tempo enquanto o aplicativo começa.

O estado na memória ou no disco local é perdido quando o app reduz a escala. Para manter o estado durante reduções, armazene-o em uma tabela do Lakebase, um volume do Unity Catalog ou outro armazenamento externo. Consulte Estado do app. Se você precisa de um app sempre ativo ou escalonamento horizontal, crie um app a partir de um padrão ou seu próprio código. Consulte Escalonamento horizontal para apps do Databricks.

Limitações​

Os aplicativos criados com o Genie App Builder têm as seguintes limitações:

  • Os aplicativos não têm saída geral da internet pública. O acesso de saída é limitado ao workspace do Databricks e aos proxies de pacote npm e PyPI gerenciados pelo Databricks.
  • As configurações de Gateway de Saída Segura em nível de Workspace e Link Privado serverless não se aplicam a esses apps. Consulte Configurar redes para Databricks Apps.
  • Os pacotes são instalados apenas por meio de proxies de pacote gerenciados pelo Databricks. Não há suporte para repository de pacotes personalizados.

Solução de problemas do Construtor de aplicativos Genie​

Esta seção aborda problemas que você pode encontrar ao criar um aplicativo.

O editor travou ao conectar​

Se o editor ficar em Conectando ao compute por mais de alguns minutos, ou mostrar Não é possível conectar ao editor. Tentando novamente… , seu navegador pode não conseguir acessar o endereço do editor em *.databricksapps.com. As configurações de rede do workspace geralmente causam isso:

  • Listas de permissão de IP : A lista de permissão de IP do workspace deve permitir a rede em que você está. A lista também se aplica a *.databricksapps.com. Se seu navegador acessar o workspace via Private Link, mas databricksapps.com pela internet pública, consulte o próximo item.
  • Private Link de front-end : Se o seu workspace usa Private Link de front-end, databricksapps.com deve resolver para seu endpoint privado, assim como a URL do seu workspace. Encontre o endereço do editor nas ferramentas de desenvolvedor do seu navegador, nas solicitações com falha para *.databricksapps.com e execução nslookup <editor-address> da máquina ou rede em que seu navegador é executado. Se ele retornar um endereço IP público, adicione databricksapps.com às suas configurações de DNS para o Private Link. Consulte a configuração de DNS.

preços​

Durante o Beta, não há cobrança para o Genie App Builder, App Spaces ou os aplicativos criados com o Genie App Builder. Os preços dos recursos beta estão sujeitos a alterações.

Outros recursos​

Nesta página