Adicionar um recurso de espaço Genie a um aplicativo Databricks

Adicione espaços AI/BI Genie como recursos do Databricks Apps para habilitar consultas em linguagem natural em seus aplicativos. Os espaços Genie fornecem uma interface de conversação para exploração de dados, permitindo que os usuários façam perguntas de negócios em inglês simples e recebam insights baseados em SQL de seus conjuntos de dados selecionados.

Quando você adiciona um espaço Genie como recurso, seu aplicativo 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 espacial do Genie

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

1. Quando criar ou editar uma aplicação, navegue até ao passo Configurar .
2. Na secção de recursos da App , clique em + Adicionar recurso.
3. Selecione Espaço Genie como o tipo de recurso.
4. Escolha um espaço Genie na lista de espaços disponíveis no seu espaço de trabalho.
5. Selecione o nível de permissão para seu aplicativo:
   • Pode visualizar: Concede permissão ao aplicativo para ler a configuração e os metadados do espaço do Genie.
   • Pode ser executado: Concede permissão ao aplicativo para enviar consultas ao espaço Genie e receber respostas.
   • Pode editar: Concede permissão ao aplicativo para modificar a configuração de espaço do Genie.
   • Pode gerenciar: Concede ao aplicativo acesso administrativo total ao espaço Genie.
6. (Opcional) Especifique uma chave de recurso personalizada, que é como você referencia o espaço Genie na configuração do seu aplicativo. A chave padrão é genie-space.

Quando você adiciona um recurso de espaço Genie:

• O Azure 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 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 tem como escopo apenas o espaço selecionado. Seu aplicativo não pode acessar outros espaços do Genie, a menos que você os adicione como recursos separados.

Variáveis de ambiente

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

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 em seu aplicativo:

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 de espaço do Genie

Quando você 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 Genie em si permanece inalterado e continua disponível para outros usuários e aplicativos que têm permissões apropriadas.

Combine espaços Genie com outros recursos do aplicativo

Combine espaços Genie com outros recursos do Databricks Apps para criar aplicativos de dados mais sofisticados. 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 Genie: Converte perguntas do usuário 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 Genie: Gera a consulta inicial e o contexto de 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 da entidade de serviço

Conceda à entidade de serviço do seu aplicativo as seguintes permissões ao integrar com outros recursos do aplicativo:

• CAN RUN no espaço Genie
• CAN USE no armazém SQL (se estiver usando um separado do espaço Genie)
• CAN QUERY no modelo servindo endpoints
• USE CATALOG e USE SCHEMA em objetos relevantes do Catálogo Unity
• SELECT Em tabelas, o aplicativo consulta diretamente

Melhores práticas

Siga estas práticas recomendadas ao trabalhar com recursos espaciais do Genie:

• Conceda permissões mínimas. Forneça acesso apenas aos espaços Genie específicos de que seu aplicativo precisa para funcionar.
• Certifique-se de que o espaço do Genie contenha conjuntos de dados e metadados bem selecionados para melhorar a qualidade das respostas a consultas em linguagem natural.
• Teste as consultas do seu aplicativo em relação ao espaço Genie para validar se ele pode gerar resultados precisos para as perguntas esperadas do usuário.
• Monitore o desempenho da consulta e ajuste os padrões de interação do seu aplicativo com o espaço Genie para otimizar os tempos de resposta.
• Implemente 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.