Utiliser l’Assistant Databricks

Assistant Databricks est un assistant IA prenant en charge le contexte qui peut vous aider avec les notebooks Databricks, l’éditeur SQL, les travaux, les tableaux de bord AI/BI et l’éditeur de fichiers. L’Assistant Databricks vous aide avec les données et le code lorsque vous demandez de l’aide au moyen d’une interface conversationnelle.

Pour un compte : Activer ou désactiver des fonctionnalités de l’Assistant Databricks

Les fonctionnalités Azure basées sur l’intelligence artificielle de l’Assistant Databricks sont activées par défaut. Cependant, les administrateurs de compte peuvent désactiver des fonctionnalités de l’Assistant Azure basées sur l’intelligence artificielle pour tous les espaces de travail au sein d’un compte. Les administrateurs de compte peuvent également appliquer l’activation de l’Assistant Databricks pour l’ensemble du compte :

Conseil

L’activation ou la désactivation des fonctionnalités Azure basées sur l’intelligence artificielle de l’Assistant Databricks pour votre compte est capturée en tant qu’événement de compte dans vos journaux d’audit ; consultez Événements de compte.

1. En tant qu’administrateur de compte, connectez-vous à la console de compte.

   Important

   Si aucun utilisateur de votre locataire Microsoft Entra ID n’est encore connecté à la console de compte, vous ou un autre utilisateur de votre locataire devez vous connecter comme premier administrateur de compte. Pour ce faire, vous devez être Administrateur général Microsoft Entra ID, mais uniquement quand vous vous connectez pour la première fois à la console de compte Azure Databricks. Dès la première connexion, vous devenez administrateur de compte Azure Databricks et n’avez plus besoin du rôle Administrateur général Microsoft Entra ID pour accéder au compte Azure Databricks. En tant que premier administrateur de compte, vous pouvez affecter des utilisateurs dans le locataire Microsoft Entra ID comme administrateurs de compte supplémentaires (qui peuvent affecter d’autres administrateurs de compte). Les administrateurs de compte supplémentaires ne nécessitent pas de rôles spécifiques dans Microsoft Entra ID. Consultez Gérer les utilisateurs, les principaux de service et les groupes.

2. Cliquez sur Paramètres.

3. Cliquez sur l’onglet Activation des fonctionnalités.

4. Pour l’option Activer des fonctionnalités basées sur l’intelligence artificielle fournies par Azure, sélectionnez Désactivé ou Activé.

5. Empêcher les remplacements d’espace de travail avec le paramètre Appliquer :

Pour en savoir plus sur les services utilisés pour les fonctionnalités de l’Assistant Databricks avec Azure AI, consultez Fonctionnalités régies par le paramètre de fonctionnalités d’assistance IA optimisées par le partenaire.

Pour un espace de travail : Activer ou désactiver des fonctionnalités de l’Assistant

Si votre administrateur de compte active l’Assistant, il est activé par défaut dans les espaces de travail. Sauf si l’administrateur de compte a choisi d’appliquer le paramètre, les administrateurs d’espace de travail peuvent le désactiver pour leurs espaces de travail.

Pour désactiver l’Assistant Databricks dans un espace de travail :

1. Cliquez sur votre nom d’utilisateur dans la barre supérieure de l’espace de travail Databricks, puis sélectionnez >Paramètres.
2. Dans le volet gauche, sous Administrateur d’espace de travail, cliquez sur l’onglet Avancé.
3. Pour désactiver l’Assistant, cliquez sur le bouton bascule Désactiver pour Fonctionnalités d’assistance basées sur l’intelligence artificielle fournies par Azure.

Présentation du volet Assistant

Cette section décrit l’expérience par défaut du volet Assistant.

Pour ouvrir le volet Assistant, cliquez sur dans la barre latérale gauche.

Tapez des questions dans la zone de texte en bas du volet Assistant, puis appuyez sur Entrée ou cliquez sur à droite de la zone de texte. Assistant affiche sa réponse. La capture d’écran suivante montre les actions que vous pouvez effectuer une fois qu’Assistant a généré du code dans le volet Assistant.

Vous pouvez réexécuter la même requête pour générer une autre réponse. Pour ce faire, pointez votre curseur sur la réponse, puis cliquez sur .

Pour fermer le volet, cliquez à nouveau sur l’icône ou cliquez sur dans le coin supérieur droit de la cellule. Vous pouvez développer le volet en pleine largeur en cliquant sur ; cliquez sur pour rétablir le volet à sa largeur par défaut.

Le volet Assistant effectue le suivi de vos conversations même si vous fermez le volet ou le notebook. Pour effacer les conversations précédentes, cliquez sur en haut à droite du volet Assistant.

Threads et historique des prompts

Les threads de conversation persistent dans les contextes différents dans lesquels l’Assistant Databricks est disponible. Dans le volet Assistant, vous pouvez créer des threads de conversation, afficher l’historique des questions et prompts, et gérer votre expérience avec l’Assistant Databricks.

L’Assistant Databricks intitule les threads en fonction du contexte de vos prompts. Vous pouvez donc parcourir l’historique de votre conversation Assistant. L’exemple suivant provient d’une question sur un bloc-notes.

Utiliser l’Assistant Databricks dans une cellule de notebook

Dans un notebook, l’Assistant Databricks est disponible dans le volet Assistant ou en ligne dans une cellule de code.

Pour utiliser l’Assistant Databricks directement dans une cellule de code, appuyez sur Cmd+i pour MacOS ou sur Ctrl+i pour Windows. Une zone de texte apparaît dans la cellule. Vous pouvez taper une question ou un commentaire en anglais, puis appuyer sur Entrée (et non Maj + Entrée, comme vous le feriez pour exécuter une cellule) pour qu’Assistant génère une réponse.

Utiliser des commandes de barre oblique pour les invites

Les commandes de barre oblique sont un raccourci pour créer des prompts courants.

Texte de l’invite	Ce qu’Assistant fait
/	Affiche les commandes courantes
/doc	Commente le code dans une vue de comparaison
/explain	Fournit une explication du code dans une cellule
/fix	Propose un correctif pour toutes les erreurs de code dans une vue de comparaison
/findTables	Recherche des tables pertinentes sur la base des métadonnées d'Unity Catalog.
/findQueries	Recherche des requêtes pertinentes sur la base des métadonnées d'Unity Catalog.
/optimize	Améliore les requêtes SQL inefficaces.
/prettify	Met en forme votre code dans un souci de lisibilité.
/rename	Suggère des noms mis à jour pour les cellules du notebook et d’autres éléments, en fonction du contexte.
/settings	Ajuste les paramètres de votre notebook directement à partir de l’assistant.

Lorsque vous utilisez /fix ou /doc, dans la fenêtre de comparaison, sélectionnez Accepter pour accepter les modifications proposées ou Rejeter pour conserver le code d’origine. Si vous acceptez le code proposé, le code ne s’exécute pas automatiquement. Vous pouvez passer en revue le code avant de l’exécuter. Si le code généré n’est pas ce que vous souhaitez, réessayez en ajoutant plus de détails ou d’informations à votre commentaire. Consultez Conseils pour utiliser l’Assistant Databricks.

Découvrez des explications détaillées sur les extraits de code. Utilisez l’invite /explain et incluez des termes tels que « sois concis » ou « explique le code ligne par ligne » pour préciser le niveau de détail souhaité. Vous pouvez également demander à l’Assistant Databricks d’ajouter des commentaires au code.

Pour la saisie semi-automatique du code, les performances peuvent être meilleures à l’aide du volet Assistant que dans une cellule de notebook.

Assistant se ferme automatiquement si vous acceptez ou refusez le code qu’il a généré.

Référencer des tables dans les invites à l’aide de @

Pour référencer rapidement des tables dans les invites de l’Assistant, utilisez le symbole @ (arobase).

Obtenir de l’aide pour du code

L’Assistant Databricks apporte une aide sur le code, à la fois SQL et Python :

• Autocomplétion basée sur l’IA dans des notebooks Databricks, dans l’éditeur SQL et dans l’éditeur de fichiers.
• Filtrage de données avec des prompts en langage naturel.
• Débogage du code avec l’erreur diagnostiquer (préversion publique).

Remarque

Les suggestions de code inline ne sont pas disponibles dans les régions ou espaces de travail Azure Government avec la conformité FedRAMP.

Filtrer les données avec des prompts en langage naturel

Utilisez l’Assistant Databricks pour filtrer les sorties de données avec des prompts en langage naturel.

Pour filtrer les sorties en langage naturel, cliquez sur l’icône Filtrer dans la table de sortie et entrez un prompt. Par exemple, comme dans l’exemple animé suivant, vous pouvez demander « Afficher seulement les hommes de plus de 70 ans ».

Obtenir des suggestions de code inline : exemples Python et SQL

Lorsque vous tapez, les suggestions s’affichent automatiquement. Appuyez sur la touche Tab pour accepter une suggestion. Pour déclencher manuellement une suggestion, appuyez sur Option + Maj + Espace (sur macOS) ou Ctrl + Maj + Espace (sur Windows).

L’autocomplétion basée sur l’IA peut également générer du code à partir de commentaires :

Débogage de code : exemples Python et SQL

Important

Cette fonctionnalité est disponible en préversion publique.

Pour utiliser l’Assistant Databricks pour corriger le code, effectuez l’une des opérations suivantes :

• Posez une question dans le volet Assistant.
• Cliquez sur le bouton Diagnostiquer l’erreur qui s’affiche dans les résultats de la cellule lorsqu’une erreur se produit.
• Cliquez sur Déboguer pour exécuter le code pas à pas de façon interactive ligne par ligne, définir des points d’arrêt, inspecter les variables et analyser l’exécution du programme.

Les onglets ci-dessous présentent des exemples de code Python et SQL :

Python

SQL

Lorsque vous cliquez sur Diagnostiquer l’erreur, l’assistant exécute automatiquement /fix.

Correctif rapide

Lorsque le code retourne des erreurs, le Correctif rapide recommande automatiquement des corrections pour les erreurs de base qui peuvent être corrigées par un simple changement d’une ligne.

Cliquez sur Accepter et exécuter pour effectuer la correction recommandé et continuer à exécuter votre code :

Diagnostiquer les erreurs dans les travaux (préversion publique)

Important

Cette fonctionnalité est disponible en préversion publique.

L’Assistant Databricks aide à diagnostiquer les erreurs dans les travaux.

Pour diagnostiquer un travail avec l’Assistant :

1. Ouvrez le travail qui a échoué depuis l’interface utilisateur des travaux.
2. Sélectionnez Diagnostiquer l’erreur.

Obtenir des réponses provenant de la documentation Azure Databricks

Dans l’éditeur de notebook, l’Assistant Databricks peut vous aider à répondre à des questions basées sur la documentation Databricks. Tapez votre question ou prompt dans la zone de prompt.

Conseils pour l’utilisation de l’Assistant Databricks

Cette section contient des conseils généraux et des meilleures pratiques lors de l’utilisation de l’Assistant Databricks.

L’Assistant Databricks utilise le contexte pour fournir de meilleures réponses

L’Assistant Databricks a accès aux schémas de table et de colonne et aux métadonnées. Cela vous permet d’utiliser le langage naturel et de générer des requêtes plus précises. Par exemple, si une table a une colonne nommée État, vous pouvez demander à l’Assistant Databricks de générer une liste d’utilisateurs qui vivent dans l’État du Michigan.

L’Assistant Databricks utilise le contexte suivant :

• Code ou requêtes dans la cellule de notebook ou l’onglet de l’éditeur Databricks SQL actuels.
• Noms et descriptions des tables et des colonnes.
• Questions d’invite précédentes.
• Tables favorites et actives.
• Pour la fonctionnalité de Diagnostiquer une erreur, la trace de pile de la sortie d’erreur.

Lorsque vous sélectionnez des colonnes à partir d’un DataFrame, vous pouvez obtenir des résultats plus précis en fournissant une requête de démarrage. Par exemple, fournissez une instruction telle que SELECT * FROM <table_name>. Cela permet à l’Assistant Databricks d’obtenir les noms de colonnes et de ne pas avoir à deviner.

Étant donné que l’Assistant Databricks utilise votre historique des conversations pour fournir des réponses meilleures et plus précises, vous pouvez demander à l’Assistant Databricks de modifier la sortie d’une réponse précédente sans avoir à réécrire toute l’invite. Utilisez l’historique des discussions d’Assistant pour nettoyer, explorer, filtrer et découper de manière itérative les DataFrames dans le volet Assistant.

Être précis

La structure et les détails que l’Assistant Databricks fournit varient de temps en temps, même pour la même invite. Essayez de fournir à Assistant autant de conseils que vous pouvez pour l’aider à renvoyer les informations souhaitées dans le format et le niveau de détail souhaités, et selon d’autres critères. Par exemple :

• “Expliquez ce code en quelques phrases” ou “expliquez cette ligne de code par ligne”.
• “Créez une visualisation à l’aide de MatPlotLib” ou “créez une visualisation à l’aide de Seaborn”.

Donnez des exemples de valeurs de données au niveau des lignes

Étant donné que l’Assistant Databricks n’utilise pas de données au niveau des lignes, vous devrez peut-être fournir plus de détails aux invites pour obtenir la réponse la plus précise. Utilisez des commentaires de table ou de colonne dans l’Explorateur de catalogues pour ajouter une ligne d’exemples de données. Par exemple, supposons que votre colonne de hauteur soit au format feet-inches. Pour aider Assistant à interpréter les données, ajoutez un commentaire tel que « La colonne de hauteur est au format chaîne et est séparée par un trait d’union. Exemple : ‘6-2’.” Pour plus d’informations sur les commentaires de table et de colonne, consultez Ajouter des commentaires aux ressources d’IA et de données.

Si vous devez utiliser des conversions de type de données de colonne pour exécuter une opération, vous devrez peut-être fournir des détails. Par exemple : « convertissez ce code de pandas en PySpark, y compris le code nécessaire pour convertir le DataFrame pandas en un PySpark DataFrame et en changeant le type de données de désabonnement des colonnes de booléen à entier ».

Utiliser Maj+Entrée pour ajouter une nouvelle ligne dans la zone de texte de conversation

Utilisez Maj+Entrée pour ajouter une nouvelle ligne dans la zone de texte de conversation de l’Assistant. Cela facilite la mise en forme et l’organisation de vos messages dans l’Assistant Databricks.

Modifier et exécuter du code dans le volet de conversation de l’Assistant Databricks

Exécutez du code dans le volet Assistant pour le valider ou l’utiliser comme bloc-notes. Pour exécuter du code, cliquez sur dans le coin supérieur gauche de la zone de code dans le volet Assistant.

Les onglets ci-dessous présentent des exemples de code Python et SQL :

Python

SQL

Lorsque vous exécutez du code dans le volet Assistant, la sortie s’affiche et les variables deviennent utilisables dans le notebook.

Vous pouvez également modifier le code généré par l’Assistant Databricks directement dans la zone de conversation de l’Assistant avant de déplacer le code vers le notebook.

Informations supplémentaires

Les articles suivants contiennent des informations supplémentaires sur l’utilisation de l’Assistant Databricks :

• Qu’est-ce que l’Assistant Databricks ?
• Confiance et sécurité de DatabricksIQ
• Impact de l’Assistant Mesurer Databricks