Utilisez ce guide si vous êtes admin d’un espace de travail ChatGPT et que vous configurez le modèle d’application Databricks pour votre organisation. Un modèle n’est pas l’application finale qu’utilisent les membres. Il s’agit d’un processus de configuration qui crée une ébauche d’application propre à l’espace de travail après que vous avez fourni la configuration Databricks requise.
Pour Databricks, la majeure partie de la configuration se fait dans la console de compte Databricks. Vous créez une connexion d’application OAuth personnalisée, inscrivez l’URL de rappel ChatGPT, copiez les identifiants client générés, puis collez ces valeurs dans le processus de configuration du modèle ChatGPT. Une fois que ChatGPT a créé l’ébauche d’application, vous pouvez la publier et la gérer comme les autres applications de l’espace de travail.
Ce que vous configurez
Vous créez une application Databricks propre à l’espace de travail dans ChatGPT. L’application utilise :
Une connexion d’application OAuth Databricks créée dans votre console de compte Databricks.
L’ID client et le secret client OAuth Databricks.
L’URL de rappel exacte copiée depuis ChatGPT.
Des portées Databricks qui correspondent aux fonctionnalités du connecteur que vous voulez activer.
Tous les détails de fournisseur Databricks demandés par le processus de configuration de ChatGPT, comme l’hôte de l’espace de travail, l’hôte du compte, l’ID du compte ou l’entrepôt.
Avant de commencer
Vous avez besoin de ce qui suit :
Un accès d’admin ou de propriétaire à l’espace de travail ChatGPT.
Un accès d’admin au compte Databricks. Un accès d’admin à l’espace de travail peut suffire pour certaines tâches, mais les connexions d’applications personnalisées sont configurées depuis la console de compte Databricks.
La console de compte Databricks ouverte dans un onglet distinct.
L’écran de configuration du modèle d’application Databricks ouvert dans ChatGPT pour vous permettre de copier l’URL de rappel exacte.
Une décision quant à savoir si l’application a besoin d’un accès général à l’API Databricks ou seulement d’un accès à Databricks SQL.
Un endroit sécurisé pour traiter le secret client Databricks.
N’inventez pas l’URL de rappel. Copiez l’URL de rappel exacte affichée dans ChatGPT.
Valeurs à préparer
URL de rappel : copiez-la depuis le processus de configuration du modèle ChatGPT.
ID client OAuth Databricks.
Secret client OAuth Databricks.
Portées d’accès Databricks, comme ALL APIs ou SQL.
Champs de l’espace de travail ou du compte Databricks demandés par le processus de configuration de ChatGPT.
Publier et gérer l’application dans ChatGPT
La création de l’ébauche d’application ne la rend pas automatiquement accessible aux membres. Après avoir examiné l’ébauche :
Publiez l’ébauche d’application.
Confirmez que l’application apparaît dans Paramètres de l’espace de travail > Applications > Activées.
Configurez Accès utilisateur pour les rôles qui doivent l’utiliser.
Vérifiez Contrôle des actions pour les actions Databricks exposées par l’application.
Vérifiez Autorisations de l’application pour choisir quand ChatGPT demande l’autorisation des membres avant d’utiliser l’application.
Demandez à un utilisateur test autorisé d’ouvrir Applications dans ChatGPT et de confirmer que l’application apparaît.
Ces autorisations d’application s’appliquent aux conversations ChatGPT. Les agents d’espace de travail utilisent des contrôles propres à chaque agent, définis par le créateur de l’agent, pour déterminer quelles actions d’application sont disponibles et quand les utilisateurs finaux doivent les approuver. Pour le comportement des agents, consultez : Agents d’espace de travail ChatGPT pour Enterprise et Business.
Démarrer la configuration du modèle dans ChatGPT
Dans ChatGPT, passez à l’espace de travail où l’application doit être disponible.
Ouvrez Paramètres de l’espace de travail > Applications.
Sélectionnez Répertoire.
Recherchez Databricks.
Sélectionnez le modèle d’application Databricks et démarrez la configuration.
Entrez un nom et une description d’application clairs, comme Databricks ou Databricks - Data Platform.
Dans la section du client OAuth, copiez l’URL de rappel depuis ChatGPT. Gardez cet onglet ouvert.
Exemple d’URL de rappel : https://chatgpt.com/connector/oauth/<callback_id>
Ne supprimez pas l’ID de rappel, n’ajoutez pas de barre oblique finale et ne le remplacez pas par une URL ChatGPT générique.
Créer la connexion d’application OAuth dans Databricks
Ouvrez la console de compte Databricks pour votre compte Databricks.
Dans la barre latérale gauche, ouvrez Paramètres.
Ouvrez l’onglet Connexions d’applications.
Sélectionnez Ajouter une connexion.
Entrez un nom d’application, comme Connecteur Databricks ChatGPT.
Dans URL de redirection, collez l’URL de rappel exacte copiée depuis ChatGPT.
Sous Portées d’accès, choisissez les portées dont l’application a besoin.
Utilisez ALL APIs pour une application Databricks générale qui a besoin d’API Databricks au-delà de SQL.
Utilisez SQL seulement pour une application limitée aux API Databricks SQL.
Conservez les durées de vie des tokens aux valeurs par défaut de Databricks, sauf si votre organisation a une politique précise.
Activez Générer un secret client. ChatGPT a besoin d’un client OAuth confidentiel pour ce processus.
Créez la connexion.
Copier les identifiants depuis Databricks
Dans la boîte de dialogue Connexion créée, copiez l’ID client.
Copiez immédiatement le secret client et stockez-le de façon sécurisée.
Si vous fermez la boîte de dialogue avant de copier le secret, créez ou faites tourner les identifiants de l’application OAuth et utilisez le nouveau secret.
Databricks n’affiche le secret qu’une seule fois. Traitez-le comme un identifiant et ne l’incluez pas dans des captures d’écran, des billets, des commentaires ou des clavardages.
Terminer la configuration dans ChatGPT
Retournez à l’onglet de configuration du modèle ChatGPT.
Collez l’ID client Databricks dans ID client OAuth.
Collez le secret client Databricks dans Secret client OAuth.
Laissez les portées inchangées, sauf si vous devez intentionnellement remplacer les valeurs par défaut du modèle.
Remplissez tous les champs de fournisseur Databricks requis par le processus de configuration, comme l’hôte de l’espace de travail, l’hôte du compte, l’ID du compte, l’entrepôt ou d’autres valeurs propres à Databricks.
Créez l’ébauche d’application.
Tester l’application comme utilisateur
Démarrez le processus de connexion depuis ChatGPT comme utilisateur test autorisé.
Confirmez que le navigateur ouvre le compte ou l’espace de travail Databricks attendu.
Approuvez les portées demandées.
Vérifiez que le navigateur revient à ChatGPT et que l’application s’affiche comme connectée.
Exécutez d’abord une action de lecture à faible risque, comme récupérer les renseignements de l’utilisateur actuel ou interroger une ressource Databricks SQL approuvée.
Si les actions d’écriture sont activées, effectuez un test avec un flux de travail Databricks clairement à faible risque avant un déploiement plus large.
Gérer l’accès
Databricks et ChatGPT contribuent tous deux au contrôle d’accès.
Dans ChatGPT, les admins de l’espace de travail gèrent la disponibilité de l’application publiée, les rôles de l’espace de travail qui peuvent l’utiliser, les actions activées et les moments où ChatGPT demande l’autorisation des utilisateurs avant d’utiliser l’application.
Dans Databricks, les admins gèrent les utilisateurs qui peuvent autoriser l’application OAuth et les ressources Databricks auxquelles ces utilisateurs peuvent accéder. Les autorisations du fournisseur continuent de s’appliquer après l’activation de l’application dans ChatGPT.
Dépannage
Non-correspondance de l’URI de redirection : confirmez que l’URL de redirection Databricks correspond exactement à l’URL de rappel affichée dans ChatGPT, y compris le chemin et l’ID de rappel.
Secret manquant : les secrets Databricks ne sont affichés qu’une seule fois. Générez un nouveau secret client s’il n’a pas été copié.
Application OAuth non disponible immédiatement : Databricks indique que le traitement des mises à jour d’application OAuth peut prendre jusqu’à 30 minutes.
Portée insuffisante : si ChatGPT peut s’authentifier, mais que les appels à l’API Databricks échouent, confirmez que l’application Databricks a ALL APIs lorsque l’application a besoin d’API autres que SQL.
Échec des actions SQL : confirmez la portée SQL, la configuration de l’entrepôt et les autorisations Databricks.
Mauvais espace de travail : créez et publiez l’application dans le même espace de travail ChatGPT où les utilisateurs la connecteront.
Les utilisateurs ne peuvent pas se connecter : confirmez que l’utilisateur a accès à Databricks et qu’il est autorisé à approuver l’application OAuth.