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

Adicionar um recurso do Genie Space a um aplicativo Databricks

Adicione Genie Spaces como um recurso Databricks Apps para habilitar consultas em linguagem natural em seus aplicativos. Genie Spaces oferece uma interface conversacional para exploração de dados, permitindo que os usuários façam perguntas de negócios em linguagem simples e recebam informações baseadas em SQL a partir do seu conjunto de dados selecionado.

Ao adicionar um Genie Space como recurso, seu aplicativo poderá:

  • Converta consultas de linguagem natural dos usuários em SQL
  • Acesse o contexto comercial e os metadados pré-configurados
  • Use exemplos de consultas e definições de dados selecionadas
  • Gerar respostas com base no conjunto de dados de sua organização

Adicionar um recurso Espaço Genie​

Antes de adicionar um Genie Space como recurso, revise os pré-requisitos do recurso do aplicativo.

  1. Na seção Recurso do aplicativo , ao criar ou editar um aplicativo, clique em + Adicionar recurso > EspaçoGenie .

  2. Escolha um Espaço Genie na lista de espaços disponíveis em sua workspace.

  3. Selecione o nível de permissão para seu aplicativo:

    • Pode view: Concede ao aplicativo permissão para ler a configuração e os metadados Genie Space.
    • Execução permitida: Concede ao aplicativo permissão para enviar consultas ao Genie Space e receber respostas.
    • Pode editar: Concede ao aplicativo permissão para modificar a configuração do Genie Space.
    • Pode gerenciar: Concede ao aplicativo acesso administrativo completo ao Genie Space.

  4. (Opcional) Especifique uma key de recurso personalizada, que é como você referencia o Genie Space na configuração do seu aplicativo. A key default é genie-space.

Ao adicionar um recurso do Genie Space:

  • O Databricks concede à entidade de serviço do seu aplicativo as permissões especificadas no Genie Space selecionado.
  • O aplicativo pode enviar consultas em linguagem natural para o espaço e receber respostas estruturadas com consultas e resultados SQL.
  • O aplicativo acessa o contexto comercial selecionado do espaço, incluindo metadados, exemplos de consultas e definições de dados.
  • O acesso está restrito apenas ao espaço selecionado. Seu aplicativo não pode acessar outros Espaços Genie a menos que você os adicione como recursos separados.
nota

A entidade de serviço do aplicativo também precisa de permissões apropriadas na fonte de dados subjacente que o Genie Space consulta. Normalmente, isso inclui permissões USE CATALOG, USE SCHEMA e SELECT nas tabelas e visualizações relevantes Unity Catalog .

variável de ambiente​

Quando você implanta um aplicativo com um recurso Genie Space, Databricks expõe o ID do espaço por meio de uma variável de ambiente que você pode referenciar usando o campo valueFrom em sua configuração app.yaml .

Configuração de exemplo:

YAML
env:
  - name: GENIE_SPACE_ID
    valueFrom: genie-space # Use your custom resource key if different

Usando o ID de espaço em seu aplicativo:

Python
import os
from databricks.sdk import WorkspaceClient

# Access the Genie Space using the injected environment variable
space_id = os.getenv("GENIE_SPACE_ID")

# Initialize the workspace client
w = WorkspaceClient()

# Start a conversation with a natural language query
response = w.genie.start_conversation_and_wait(
    space_id=space_id,
    content="What were our top-selling products last quarter?"
)

# Process the response (responses contain attachments with text, queries, and so on)
for attachment in response.attachments:
    print(f"Genie response: {attachment.text.content}")

# Continue the conversation with additional questions
follow_up = w.genie.create_message_and_wait(
    space_id=space_id,
    conversation_id=response.conversation_id,
    content="Can you break that down by product category?"
)

Para obter mais informações, consulte Access variável de ambiente from recurso.

Remover um recurso do Genie Space​

Ao remover um recurso do Genie Space de um aplicativo, a entidade de serviço do aplicativo perde o acesso ao espaço. O próprio Genie Space permanece inalterado e continua disponível para outros usuários e aplicativos que possuam as permissões adequadas.

Combine Genie Spaces com outros recursos do aplicativo.​

Combine Genie Spaces com outros recursos Databricks Apps para criar aplicações de dados mais sofisticadas. Os padrões de integração comuns incluem:

Painel de análise de linguagem natural​

Use o recurso a seguir em conjunto com a execução analítica interativa:

  • Genie Space: Converte perguntas do usuário em consultas SQL.
  • SQL warehouseExecução das consultas e retorno dos resultados para visualização
  • Segredos: Armazena a chave API para ferramentas de visualização externas

Configuração de exemplo:

YAML
env:
  - name: GENIE_SPACE_ID
    valueFrom: genie-space
  - name: SQL_WAREHOUSE_ID
    valueFrom: sql-warehouse
  - name: EXTERNAL_API_KEY
    valueFrom: viz-secret

AI-Business Intelligence aprimorado​

Use o recurso a seguir para integrar-se aos modelos do site AI:

  • Genie Space: Gera a consulta inicial e o contexto de dados.
  • servindo modelo endpoint : Devoluções AI-generated summaries and recommendations
  • SQL warehouseExecução de consultas analíticas complexas

Permissões da entidade de serviço​

Conceda à entidade de serviço do seu aplicativo as seguintes permissões ao integrar-se a outro recurso de aplicativo:

  • CAN RUN no Espaço Genie
  • CAN USE no SQL warehouse (caso esteja usando um separado do Genie Space)
  • CAN QUERY no endpoint servindo modelo
  • USE CATALOG e USE SCHEMA nos objetos relevantes do Unity Catalog
  • SELECT nas tabelas, o aplicativo consulta diretamente

Melhores práticas​

Siga estas boas práticas ao trabalhar com o recurso Genie Space:

  • Conceda as permissões mínimas. Conceda acesso apenas aos Espaços Genie específicos de que seu aplicativo precisa para funcionar.
  • Garanta que o Genie Space contenha um conjunto de dados e metadados bem selecionados para melhorar a qualidade das respostas às consultas em linguagem natural.
  • Teste as consultas do seu aplicativo no Genie Space para validar se ele consegue gerar resultados precisos para as perguntas esperadas dos usuários.
  • Monitore o desempenho das consultas e ajuste os padrões de interação do seu aplicativo com o Genie Space para otimizar os tempos de resposta.
  • Implemente o tratamento de erros para os casos em que o Genie Space não consegue interpretar ou responder às consultas do usuário de forma eficaz.
Nesta página