Adicionar um recurso Genie Space a uma aplicação Databricks

Adicione Genie Spaces como recursos de Databricks Apps para permitir consultas em linguagem natural nas suas aplicações. Os Genie Spaces fornecem uma interface conversacional para exploração de dados, permitindo aos utilizadores colocar questões empresariais em inglês simples e obter insights baseados em SQL a partir dos seus conjuntos de dados selecionados.

Quando adiciona um Genie Space como recurso, a sua aplicação pode:

• Converter consultas de linguagem natural de usuários em SQL
• Acesse o contexto de negócios e metadados pré-configurados
• Usar consultas de exemplo selecionadas e definições de dados
• Gerar respostas com base nos conjuntos de dados da sua organização

Adicionar um recurso Genie Space

Antes de adicionar um Genie Space como recurso, revê os pré-requisitos de recursos da aplicação.

1. Na secção de recursos da aplicação , ao criar ou editar uma aplicação, clique em + Adicionar recurso>Genie Space.
2. Escolha um Genie Space da lista de espaços disponíveis no seu espaço de trabalho.
3. Selecione o nível de permissão para seu aplicativo:
   • Pode ver: Concede à aplicação permissão para ler a configuração e os metadados do Genie Space.
   • Pode executar: Concede à aplicação permissão para submeter consultas ao Genie Space e receber respostas.
   • Posso editar: Concede à aplicação permissão para modificar a configuração do Genie Space.
   • Consegue gerir: Concede à aplicação acesso administrativo total ao Espaço Genie.
4. (Opcional) Especifica uma chave de recurso personalizada, que é a forma como referencias o Genie Space na configuração da tua aplicação. A chave padrão é genie-space.

Quando adicionas um recurso Genie Space:

• Azure Databricks concede à principal de serviço da sua aplicação 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 SQL e resultados.
• O aplicativo acessa o contexto de negócios com curadoria do espaço, incluindo metadados, consultas de exemplo e definições de dados.
• O acesso está limitado apenas ao espaço selecionado. A tua aplicação não pode aceder a outros Genie Spaces a menos que os adiciones como recursos separados.

Variáveis de ambiente

Quando implementas uma aplicação com um recurso Genie Space, Azure Databricks expõe o ID de espaço através de variáveis de ambiente que podes consultar usando o campo valueFrom na tua configuração app.yaml.

Exemplo de configuração:

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

Usando o ID de espaço na sua aplicação:

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 Acessar variáveis de ambiente a partir de recursos.

Remover um recurso Genie Space

Quando remove um recurso Genie Space de uma aplicação, o principal de serviço da aplicação perde o acesso ao espaço. O próprio Espaço Genie mantém-se inalterado e continua disponível para outros utilizadores e aplicações que tenham permissões apropriadas.

Combine o Genie Spaces com outros recursos da aplicação

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

Painel de análise de linguagem natural

Use os seguintes recursos juntos para executar análises interativas:

• Espaço Génio: Converte perguntas dos utilizadores em consultas SQL
• Armazém SQL: Executa as consultas e retorna resultados para visualização
• Segredos: Armazena chaves de API para ferramentas de visualização externas

Exemplo de configuração:

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

Inteligência de negócios aprimorada por IA

Use os seguintes recursos para integrar com modelos de IA:

• Espaço Génio: Gera a consulta inicial e o contexto dos dados
• Ponto de extremidade de serviço do modelo: Devolve resumos e recomendações gerados por IA
• Armazém SQL: Executa consultas analíticas complexas

Permissões do principal de serviço

Conceda à entidade de serviço da sua aplicação as seguintes permissões ao integrar com recursos de outras aplicações:

• CAN RUN no Espaço do Génio
• CAN USE no armazém SQL (caso esteja a usar um separado do Genie Space)
• CAN QUERY nos endpoints de disponibilização de modelos
• USE CATALOG e USE SCHEMA em objetos relevantes do Catálogo Unity
• SELECT Em tabelas, o aplicativo consulta diretamente

Melhores práticas

Siga estas melhores práticas ao trabalhar com os recursos do Genie Space:

• Conceda permissões mínimas. Apenas forneça acesso aos Genie Spaces específicos de que a sua aplicação precisa para funcionar.
• Garanta que o Genie Space contém conjuntos de dados e metadados bem selecionados para melhorar a qualidade das respostas a consultas em linguagem natural.
• Compare as consultas da sua aplicação com o Genie Space para validar que ela pode gerar resultados precisos para as perguntas esperadas dos utilizadores.
• Monitorize o desempenho das consultas e ajuste os padrões de interação da sua aplicação com o Genie Space para otimizar os tempos de resposta.
• Implemente o tratamento de erros para casos em que o Espaço Genie não consiga interpretar ou responder eficazmente às consultas dos utilizadores.