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 Genie como recurso, revise os pré-requisitos do recurso do aplicativo.

1. Ao criar ou editar um aplicativo, navegue até Configurar o passo.

2. Na seção Recurso do aplicativo , clique em + Adicionar recurso .

3. Selecione Genie space como o tipo de recurso.

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

5. 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.

6. (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: 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 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: 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:

• 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.