Ajouter une ressource d’espace Genie à une application Databricks

Ajoutez des espaces AI/BI Genie en tant que ressources Databricks Apps pour activer l’interrogation en langage naturel dans vos applications. Les espaces Génie fournissent une interface conversationnelle pour l’exploration des données, ce qui permet aux utilisateurs de poser des questions professionnelles en anglais brut et de recevoir des insights SQL de vos jeux de données organisés.

Lorsque vous ajoutez un espace Genie en tant que ressource, votre application peut :

• Convertir des requêtes en langage naturel à partir d’utilisateurs en SQL
• Accéder au contexte et aux métadonnées métier préconfigurés
• Utiliser des exemples de requêtes organisés et des définitions de données
• Générer des réponses en fonction des jeux de données de votre organisation

Ajouter une ressource d’espace Genie

Avant d’ajouter un espace Genie en tant que ressource, passez en revue les prérequis des ressources d’application.

1. Lorsque vous créez ou modifiez une application, accédez à l’étape Configurer .
2. Dans la section Ressources de l’application , cliquez sur + Ajouter une ressource.
3. Sélectionnez l’espace Genie comme type de ressource.
4. Choisissez un espace Génie dans la liste des espaces disponibles dans votre espace de travail.
5. Sélectionnez le niveau d’autorisation de votre application :
   • Peut afficher : Octroie à l’application l’autorisation de lire la configuration et les métadonnées de l’espace Genie.
   • Peut s’exécuter : Octroie à l’application l’autorisation d’envoyer des requêtes à l’espace Génie et de recevoir des réponses.
   • Peut modifier : Octroie à l’application l’autorisation de modifier la configuration de l’espace Genie.
   • Peut gérer : Accorde à l’application un accès administratif complet à l’espace Genie.
6. (Facultatif) Spécifiez une clé de ressource personnalisée, c’est-à-dire la façon dont vous référencez l’espace Genie dans la configuration de votre application. La clé par défaut est genie-space.

Quand vous ajoutez une ressource d’espace Genie :

• Azure Databricks accorde au principal de service de votre application les autorisations spécifiées sur l’espace Genie sélectionné.
• L’application peut envoyer des requêtes en langage naturel à l’espace et recevoir des réponses structurées avec des requêtes et des résultats SQL.
• L’application accède au contexte métier organisé de l’espace, notamment les métadonnées, les exemples de requêtes et les définitions de données.
• L’accès est limité à l’espace sélectionné uniquement. Votre application ne peut pas accéder à d’autres espaces Genie, sauf si vous les ajoutez en tant que ressources distinctes.

Variables d’environnement

Lorsque vous déployez une application avec une ressource d’espace Genie, Azure Databricks expose l’ID d’espace via des variables d’environnement que vous pouvez référencer à l’aide du valueFrom champ dans votre app.yaml configuration.

Exemple de configuration :

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

Utilisation de l’ID d’espace dans votre application :

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?"
)

Pour plus d’informations, consultez Les variables d’environnement Access à partir de ressources.

Supprimer une ressource d’espace Genie

Lorsque vous supprimez une ressource d’espace Genie d’une application, le principal de service de l’application perd l’accès à l’espace. L’espace Genie lui-même reste inchangé et continue d’être disponible pour d’autres utilisateurs et applications disposant d’autorisations appropriées.

Combiner des espaces Genie avec d’autres ressources d’application

Combinez des espaces Genie avec d’autres ressources Databricks Apps pour créer des applications de données plus sophistiquées. Les modèles d’intégration courants sont les suivants :

Tableau de bord d’analytique du langage naturel

Utilisez les ressources suivantes ensemble pour exécuter des analyses interactives :

• Espace Génie : Convertit les questions utilisateur en requêtes SQL
• SQL Warehouse : Exécute les requêtes et retourne des résultats pour la visualisation
• Secrets: Stocke les clés API pour les outils de visualisation externes

Exemple de configuration :

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

Intelligence décisionnelle améliorée par l’IA

Utilisez les ressources suivantes pour intégrer des modèles IA :

• Espace Génie : Génère le contexte initial de requête et de données
• Point de terminaison de service de modèle : Retourne des résumés et des recommandations générés par l’IA
• SQL Warehouse : Exécute des requêtes analytiques complexes

Autorisations du principal de service

Accordez au principal de service de votre application les autorisations suivantes lors de l’intégration avec d’autres ressources d’application :

• CAN RUN sur l’espace Génie
• CAN USE sur l’entrepôt SQL (si vous utilisez un autre élément de l’espace Génie)
• CAN QUERY sur les points de terminaison de service de modèle
• USE CATALOG et USE SCHEMA sur les objets de catalogue Unity pertinents
• SELECT sur les tables des requêtes d’application directement

Meilleures pratiques

Suivez ces bonnes pratiques lorsque vous travaillez avec les ressources spatiales Genie :

• Accordez des autorisations minimales. Fournissez uniquement l’accès aux espaces Génie spécifiques dont votre application a besoin pour fonctionner.
• Assurez-vous que l’espace Genie contient des jeux de données et des métadonnées bien organisés pour améliorer la qualité des réponses aux requêtes en langage naturel.
• Testez les requêtes de votre application sur l’espace Génie pour vérifier qu’elle peut générer des résultats précis pour les questions utilisateur attendues.
• Surveillez les performances des requêtes et ajustez les modèles d’interaction de votre application avec l’espace Génie pour optimiser les temps de réponse.
• Implémentez la gestion des erreurs pour les cas où l’espace Genie ne peut pas interpréter ou répondre efficacement aux requêtes utilisateur.