Adicionar um recurso espacial do Genie a um aplicativo Databricks

Adicionar AI/BI Genie spaces como Databricks Apps recurso para permitir a consulta em linguagem natural em seus aplicativos. Genie spaces fornecer uma interface de conversação para a exploração de dados, permitindo que os usuários façam perguntas comerciais em inglês simples e recebam percepções baseadas em SQL do seu conjunto de dados com curadoria.

Quando o senhor adiciona um espaço Genie como um recurso, seu aplicativo pode:

• 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 espacial Genie

Antes de adicionar um espaço do Genie como um recurso de aplicativo, verifique os pré-requisitos do recurso.

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

2. Selecione Genie space como o tipo de recurso.

3. Escolha um espaço Genie na lista de espaços disponíveis em seu site workspace.

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

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

5. (Opcional) Especifique um recurso personalizado key, que é como o senhor faz referência ao espaço Genie na configuração do aplicativo. O default key é genie-space.

Quando o senhor adiciona um recurso espacial do Genie:

• Databricks concede à entidade de serviço do seu aplicativo as permissões especificadas no espaço Genie 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 tem como escopo somente o espaço selecionado. Seu aplicativo não pode acessar outros Genie spaces a menos que o senhor os adicione como recurso separado.

nota

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

variável de ambiente

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

Configuração de exemplo:

YAML

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

Usando o ID de espaço em seu aplicativo:

Python

import os
from databricks.genie import GenieClient

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

# Submit a natural language query
response = genie_client.query(
    space_id=space_id,
    query="What were our top-selling products last quarter?"
)

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

Remover um recurso espacial do Genie

Quando o senhor remove um recurso de espaço do Genie de um aplicativo, a entidade de serviço do aplicativo perde o acesso ao espaço. O espaço do Genie em si permanece inalterado e continua disponível para outros usuários e aplicativos que tenham as permissões apropriadas.

Combine o site Genie spaces com outro recurso de aplicativo

Combine o Genie spaces com outros Databricks Apps recurso para criar aplicativos de dados mais sofisticados. 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:

• Espaço Genie: 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:
      resourceKey: genie-space
  - name: SQL_WAREHOUSE_ID
    valueFrom:
      resourceKey: sql-warehouse
  - name: EXTERNAL_API_KEY
    valueFrom:
      resourceKey: viz-secret

AI-Business Intelligence aprimorado

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

• Espaço Genie: 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 (se estiver usando um espaço separado do Genie )
• 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 práticas recomendadas quando o senhor trabalhar com o recurso de espaço Genie:

• Conceda permissões mínimas. Forneça acesso apenas ao site Genie spaces específico de que seu aplicativo precisa para funcionar.
• Assegurar que o espaço Genie contenha um conjunto de dados e metadados bem selecionados para melhorar a qualidade das respostas de consultas em linguagem natural.
• Teste as consultas do seu aplicativo no espaço do Genie para validar que ele pode gerar resultados precisos para as perguntas esperadas do usuário.
• Monitore o desempenho das consultas e ajuste os padrões de interação do seu aplicativo com o espaço Genie para otimizar os tempos de resposta.
• Implementar o tratamento de erros para casos em que o espaço Genie não consegue interpretar ou responder às consultas do usuário de forma eficaz.