Application Databricks Genie pour Slack

L’application Databricks Genie pour Slack ajoute Genie à Slack, ce qui permet aux utilisateurs d’obtenir des réponses à leurs questions sur les données sans quitter Slack. Envoyez un message direct à l’application ou mentionnez @Genie dans un Canal de distribution ou un groupe de discussion. Votre question est répondue par Genie One ou par un Genie Agent spécifique pin dans un message direct ou un Canal de distribution afin d’obtenir des réponses cohérentes et spécifiques au cas d’utilisation. Lorsqu’un Genie Agent est pin, les nouvelles conversations vont directement à cet agent en mode Agent via l’ API mode Agent. Dans le cas contraire, l’application utilise l’API Genie One. L’application utilise les mêmes fournisseurs de modèles et les mêmes garanties de confiance et de sécurité que Genie ; voir Fournisseur d’hébergement utilisé lorsque le paramètre de fonctionnalités d’IA fournies par des partenaires est activé et désactivé et Confiance et sécurité des fonctionnalités d’assistance Databricks AI.

Cette page explique comment download, configurer et utiliser l'application Databricks Genie pour Slack.

Cliquez sur le bouton ci-dessous pour installer l'application Databricks Genie pour Slack.

important

Les agents Databricks peuvent générer des réponses inexactes. Vérifiez avant d'agir sur le résultat de l'agent.

Prérequis

Avant d'installer l'application Databricks Genie pour Slack, veuillez procéder comme suit :

• Si votre workspace utilise une liste d'accès IP, ajoutez les adresses IP sortantes du plan de contrôle Databricks dans la région us-west-2. Consultez les adresses IP sortantes du plan de contrôle Databricks.
• Si votre workspace utilise Private Service Connect, un administrateur de compte doit ajouter une règle d'entrée basée sur le contexte qui autorise l'application. Voir Utiliser avec des Workspace Private Service Connect.

Installez l'application Databricks Genie pour Slack

Un administrateur du workspace Slack doit installer l'application Databricks Genie pour Slack à l'aide d'une URL directe :

1. download l'application Databricks pour Slack en cliquant sur le bouton :

   

2. Vous êtes redirigé vers la page d'autorisation Slack. Examinez les autorisations demandées et cliquez sur Autoriser pour installer l'application Databricks Genie pour Slack sur votre Slack Workspace.

remarque

Si votre workspace Slack nécessite l'approbation d'un administrateur pour les applications tierces, soumettez la demande d'installation et demandez à un administrateur Slack de l'approuver.

Configurez l'application Databricks Genie pour Slack.

Une fois l'application Databricks Genie pour Slack installée par un administrateur sur votre Workspace Slack, les utilisateurs ont deux options pour configurer l'application Databricks Genie pour Slack :

From a channel

1. Ouvrez un canal et envoyez un message @Genie.

2. Vous êtes invité à vous connecter à votre workspace Databricks.

   • Choisissez parmi Recent workspaces , qui répertorie les workspaces Databricks consultés le plus récemment par les utilisateurs de votre workspace Slack, ou cliquez sur Use account selector pour vous connecter à votre compte Databricks. If no one in your Slack workspace has signed in to a Databricks workspace yet, enter your workspace URL instead.

3. Après vous être connecter, vous pouvez start à utiliser l'application Databricks Genie pour Slack.

From the App Home

1. Dans Slack, recherchez et ouvrez l'application Databricks sous Applications dans la barre latérale gauche. Cliquez sur l'onglet **Home tab**.

2. Cliquez sur **Connecter à Databricks**.

3. Vous êtes invité à vous connecter à votre workspace Databricks.

   • Choisissez parmi Recent workspaces , qui répertorie les workspaces Databricks consultés le plus récemment par les utilisateurs de votre workspace Slack, ou cliquez sur Use account selector pour vous connecter à votre compte Databricks. If no one in your Slack workspace has signed in to a Databricks workspace yet, enter your workspace URL instead.

4. (Facultatif) Pin un Genie Agent spécifique à un Canal de distribution pour obtenir des réponses cohérentes et spécifiques à un cas d'utilisation. Sélectionnez un Genie Agent spécifique pour toutes vos conversations 1:1 en le sélectionnant sous la portée Genie et en cliquant sur Update Genie Agent .

Utilisez l'application Databricks Genie pour Slack

Vous pouvez utiliser l'application Databricks Genie pour Slack via des messages directs, des messages de groupe ou des conversations de canal dans votre Slack Workspace. Genie répond à chaque question en utilisant les identifiants de l'utilisateur Slack qui mentionne @Genie, de sorte que chaque utilisateur ne voit que les données auxquelles il est déjà autorisé à accéder dans Databricks, régies par Unity Catalog. Voir Utiliser Genie One.

Lorsque la visibilité des messages est publique, une réponse de Genie est visible par tout le monde dans le canal ou le message privé de groupe, y compris par les membres qui n’ont pas accès aux données sous-jacentes. Pour qu’une réponse reste visible uniquement par la personne qui a posé la question, définissez la visibilité des messages sur privée.

remarque

Les réponses de Genie dans Slack incluent un bouton Voir la conversation . Cliquez dessus pour ouvrir la conversation dans Databricks Genie pour plus de contexte.

Depuis l'application Databricks Genie pour Slack, vous pouvez créer des compétences Genie et des tâches planifiées.

Messages directs

Les utilisateurs du Workspace Slack peuvent start une conversation individuelle avec l'application Databricks Genie pour Slack :

1. Trouvez l'application Databricks Genie pour Slack dans la section Apps et cliquez sur le tab Chat.
2. Envoyez votre question ou sélectionnez l’une des questions suggérées affichées lorsque vous ouvrez une nouvelle conversation. L’application Databricks Genie pour Slack achemine la question vers l’agent Genie Agent le plus approprié et renvoie une réponse accompagnée de sources et de suggestions de messages de suivi.

Planifier des tâches à partir d'un message direct

Vous pouvez créer une tâche planifiée à partir d'un message direct avec l'application Databricks Genie pour Slack. Utilisez l'une des méthodes suivantes :

• Demandez à Genie de le planifier. À tout moment de la conversation, saisissez une demande en langage naturel, par exemple : "Crée un planning quotidien pour récupérer les dernières dépenses des clients." Genie peut poser des questions de clarification, comme l’heure ou le fuseau horaire, puis crée la tâche.
• Cliquez sur la suggestion de planification. Lorsque Genie suggère d'exécuter une réponse selon un calendrier, il affiche un bouton Exécuter cette analyse selon un calendrier sous la réponse. Cliquez sur le bouton. Genie demande ce que la tâche doit faire et quand elle doit s'exécuter, puis crée la tâche.

Lorsque la tâche est exécutée, l’application Databricks Genie pour Slack vous envoie les résultats dans un message direct.

Regrouper les messages

Les utilisateurs peuvent ajouter l'application Databricks Genie pour Slack aux MP de groupe :

• Nouveaux messages de groupe : ajoutez l'application Databricks Genie pour Slack lors de la création de la chaîne, puis envoyez @Genie pour start la conversation.
• Messages de groupe existants : les applications ne peuvent pas être ajoutées à des groupes existants.

Conversations de canal

Les membres du canal peuvent utiliser l'application Databricks Genie pour Slack dans un canal Slack en mentionnant @Genie. Un propriétaire de canal de distribution peut configurer la portée de Genie et la visibilité des messages pour le canal de distribution.

1. Dans le canal de distribution, saisissez @Genie.

2. Si vous y êtes invité, ajoutez l’application Databricks Genie pour Slack au canal.

3. Configurez l'application Databricks Genie pour Slack en sélectionnant les éléments suivants :

   • Le Databricks Workspace connecté.
   • La visibilité du message (publique ou privée).
   • La portée de Genie : Genie One ou un Genie Agent spécifique.

remarque

Si vous êtes le propriétaire du canal de distribution, vous pouvez appliquer cette configuration pour vous-même ou pour l'ensemble du canal de distribution.

Pour modifier la configuration ultérieurement, exécutez /databricks-genie config dans le Canal de distribution pour rouvrir la fenêtre de configuration.

Après configuration, les membres du canal peuvent mentionner @Genie dans le canal pour poser des questions.

Visualisations

Lorsqu'une réponse de Genie comprend une visualisation, le graphique apparaît sous la forme d'une image dans la réponse.

Les visualisations ne s'affichent pas lorsque la visibilité des messages est définie sur privé, car les messages privés ne sont visibles que par l'utilisateur qui a posé la question. Si les visualisations n'apparaissent pas dans les messages publics, un administrateur du Workspace Slack doit réinstaller l'application pour lui accorder l'autorisation files:write qui lui permet de joindre des fichiers image aux messages.

Approuver les actions de l'outil

Genie peut utiliser des outils externes connectés pour répondre aux questions et effectuer des actions. Lorsqu’un appel d’outil nécessite une approbation, Genie affiche une invite d’approbation dans la réponse. Cliquez sur Autoriser pour permettre à Genie d’exécuter l’outil, ou sur Refuser pour l’arrêter. Si l’invite inclut un sélecteur de portée, choisissez si l’approbation s’applique Une fois , Toujours dans cette discussion ou Toujours . Seul l’utilisateur qui a posé la question peut approuver ou refuser la demande.

Niveaux de configuration et remplacements

Exécutez /databricks-genie config dans un canal de distribution pour ouvrir la fenêtre de configuration. Les paramètres suivants sont configurables :

• Sélection de Workspace : Le Workspace Databricks auquel l'application Databricks Genie pour Slack se connecte pour répondre aux questions.
• Visibilité des messages : Les réponses @Genie dans les canaux sont-elles visibles par tous les membres du canal ou uniquement par l'utilisateur qui a posé la question ? Par default, les réponses sont publiques.
• Portée de Genie : Genie One ou un Genie Agent spécifique. Les nouvelles conversations sont directement dirigées vers un agent pin dans le mode Agent, et les commentaires sur ses réponses sont transmis à cet agent. Dans un Canal de distribution ou un message privé de groupe, seul un pin à l’échelle du Canal de distribution ( Enregistrer comme paramètre à l’échelle du Canal de distribution ) dirige les conversations vers l’agent. Une configuration personnelle dans un Canal de distribution utilise Genie One.

Les paramètres de visibilité des messages peuvent être définis à trois niveaux. Les niveaux supérieurs remplacent les niveaux inférieurs :

Niveau	Comment le configurer	S'applique à	Précedence
Espace de travail	L’administrateur du workspace Databricks configure les paramètres de sécurité du workspace à l’aide des paramètres Allowed collaboration platforms et Allow public messages in collaboration platforms . La prise d'effet des modifications peut prendre jusqu'à une heure.	Toutes les chaînes dans le workspace Slack	Le plus élevé, remplace le canal de distribution et les configurations personnelles
Canal	Le propriétaire du Canal de distribution envoie /databricks-genie config dans le Canal de distribution et sélectionne Enregistrer comme paramètre global du Canal de distribution	Tous les membres de ce canal	Remplace les configurations personnelles
Personnel	L'utilisateur individuel envoie /databricks-genie config dans le canal de distribution.	@Genie mentions de cet utilisateur dans le canal de distribution	Utilisé lorsqu'aucune configuration à l'échelle du Canal de distribution n'est définie.

Niveau	Comment le configurer	S'applique à	Précedence
Espace de travail	L’administrateur du workspace Databricks configure les paramètres de sécurité du workspace à l’aide des paramètres Allowed collaboration platforms et Allow public messages in collaboration platforms . La prise d'effet des modifications peut prendre jusqu'à une heure.	Toutes les chaînes dans le workspace Slack	Le plus élevé, remplace le canal de distribution et les configurations personnelles
Canal	Le propriétaire du Canal de distribution envoie /databricks-genie config dans le Canal de distribution et sélectionne Enregistrer comme paramètre global du Canal de distribution	Tous les membres de ce canal	Remplace les configurations personnelles
Personnel	L'utilisateur individuel envoie /databricks-genie config dans le canal de distribution.	@Genie mentions de cet utilisateur dans le canal de distribution	Utilisé lorsqu'aucune configuration à l'échelle du Canal de distribution n'est définie.

Paramètres d'administration du workspace

À partir de Paramètres > Sécurité > Accès externe , un administrateur de workspace contrôle si l’application Databricks Genie pour Slack peut se connecter au workspace et si ses réponses peuvent être publiques :

• Plateformes de collaboration autorisées : quelles plateformes de collaboration peuvent se connecter au workspace. Sélectionnez Autoriser tout (valeur default), Autoriser uniquement Slack , Autoriser uniquement Teams ou Refuser tout . Lorsque Slack n'est pas autorisé, les utilisateurs ne peuvent pas connecter l'application au workspace. Les utilisateurs qui sont déjà connectés reçoivent un message privé indiquant que la connexion au workspace n'est pas autorisée et ils sont invités à changer de workspace ou à contacter un administrateur de workspace.
• Autoriser les messages publics sur les plateformes de collaboration : lorsqu’elle est activée, les utilisateurs et les propriétaires de Canaux de distribution choisissent si les réponses sont publiques ou privées. Lorsqu’elle est désactivée, les réponses ne sont visibles que par l’utilisateur qui a posé la question.

Les modifications apportées à ces paramètres peuvent prendre jusqu'à une heure pour prendre effet.

Routage des données

Genie traite vos questions dans votre workspace et stocke l’historique des conversations dans la région de votre workspace. Les demandes entre Slack et votre workspace transitent par un service Databricks central dans le plan de contrôle Databricks. Le service central ne conserve ni ne consigne le contenu des demandes ou des réponses. Il stocke uniquement le mappage entre votre workspace Slack et votre workspace Databricks.

Le service central s'exécute dans la région us-west-2, quelle que soit la région de votre workspace. Si votre workspace utilise une liste d'accès IP, ajoutez les IP sortantes du plan de contrôle Databricks dans la région us-west-2. Voir IP sortantes du plan de contrôle Databricks.

Lorsque vous posez une question dans Slack :

1. Slack envoie votre question au service central.
2. Le service central transmet la demande à votre workspace Databricks.
3. Genie traite la requête et génère une réponse dans votre workspace.
4. La réponse revient dans Slack par le biais du service central.

Où le traitement des LLM est effectué

Le service central ne fait que relayer les messages entre Slack et votre workspace. Genie dans votre workspace appelle le LLM (Large Language Model) ; ainsi, la Geo de votre workspace et son paramètre cross-Geo processing déterminent où le LLM traite votre contenu. Par exemple, si votre workspace est situé dans la Geo Europe et que le cross-Geo processing n’est pas activé, le LLM traitera votre contenu en Europe. Voir les services désignés de Databricks.

Utiliser avec des Workspace Private Service Connect

L'application Databricks Genie pour Slack fonctionne avec les Workspace qui utilisent Private Service Connect frontal. Slack ne prenant pas en charge les connexions Private Service Connect sortantes, l’application ne se connecte pas via Private Service Connect. Au lieu de cela, vous ajoutez une règle d’entrée basée sur le contexte qui permet uniquement à l’application d’accéder à l’API Genie de votre workspace. La règle ne modifie pas la façon dont votre politique gère les autres trafics et chaque demande s’exécute avec les autorisations de l’utilisateur qui l’a demandée.

Vous devez être administrateur de compte pour effectuer ces étapes. Créez la politique d’entrée avant d’activer l’accès public, afin que le workspace n’accepte aucun trafic public sans restriction à un moment donné.

Étape 1 : créer une règle d’entrée pour l’application

Une politique d'accès entrant basée sur le contexte contrôle quelles demandes peuvent atteindre votre workspace, en fonction de l'identité, du type de demande et de la source réseau de chaque demande. Voir Contrôle d'entrée basé sur le contexte.

1. Dans la console de compte, ouvrez ou créez la politique de réseau de workspace pour votre workspace. Voir Créer des politiques de réseau d'accès.

2. Dans l’onglet Ingress tab, sous Public network access , vérifiez que Allow access from all public IPs est désactivé. Les demandes publiques sont alors refusées sauf si elles correspondent à une règle d'autorisation.

3. Ajoutez une règle Autoriser avec les paramètres suivants :

   • Type d'accès : API , avec l'étendue de l'API Genie .
   • Identité : Tous les utilisateurs et les Service Principal , ou Identités sélectionnées pour limiter les personnes pouvant utiliser l’application.
   • Source : Plateformes de partenaires > Application Slack Databricks . Consultez Autoriser les plateformes de partenaires dans les politiques d'accès entrant basées sur le contexte.

4. Enregistrez la politique et attachez-la à votre workspace. Voir Attacher une politique aux Workspace. Les modifications peuvent prendre jusqu’à 30 minutes pour prendre effet.

Étape 2 : Activer l'accès public sur le workspace

Lorsque l’accès public est désactivé, toutes les demandes publiques, y compris celles émanant de l’application, sont bloquées avant que la politique d’entrée ne soit évaluée. L’activation de l’accès public n’ouvre pas le workspace à tout le trafic public. La politique d’entrée de l’étape 1 continue d’évaluer chaque requête publique et n’autorise que les requêtes qui correspondent à une règle d’autorisation. Vos Endpoint privés existants ne changent pas.

Dans l'objet de paramètres d'accès privé du workspace, réglez Accès public sur Géré par vos politiques d'entrée Databricks . Pour vérifier le paramètre, dans la console du compte, cliquez sur Sécurité > Paramètres d'accès privé . La colonne Accès public indique Régie par vos politiques d’entrée Databricks lorsque l’accès public est activé. Pour modifier le paramètre, consultez Mettre à jour un objet de paramètres d'accès privé.

Ce paramètre s'applique à chaque workspace qui utilise l'objet de paramètres d'accès privé. Assurez-vous que chacun de ces Workspace dispose d’une stratégie d’entrée qui restreint l’accès public.

Vérifier la configuration

Une fois que la politique prend effet, vérifiez que le workspace bloque toujours le trafic public externe et que l'application peut l'atteindre :

1. Déconnectez-vous de votre VPN ou de tout autre réseau acheminant vers vos Endpoint privés, afin que votre navigateur se connecte via l’internet public.
2. Ouvrez l’URL de votre workspace. Sauf si une autre règle d’autorisation dans la stratégie couvre votre réseau, l’accès est refusé.
3. Dans Slack, mentionnez @Genie et posez une question. L’application renvoie une réponse.

Pour examiner les demandes refusées, effectuez une query sur la table système system.access.inbound_network, qui enregistre les demandes entrantes refusées par une politique d'entrée. La demande de navigateur refusée de l'étape 2 s'y affiche. Si l'application ne peut pas atteindre votre workspace, le tableau indique quelle règle a refusé ses demandes. Les enregistrements sont généralement disponibles dans un délai d'une heure. Voir le schéma de la table système des événements d'accès réseau entrant.

Surveiller l'utilisation avec les Logs d'audit

Les administrateurs de compte et de workspace peuvent utiliser la table système des journaux d'audit (system.access.audit) pour surveiller l'utilisation de Genie provenant de Slack. Lorsqu'un utilisateur envoie un message via l'application Databricks Genie pour Slack, Genie One enregistre un événement createGenieChatResponse sous le service genieChat, et le champ request_params.source enregistre slack comme origine. Cela vous permet de distinguer les requêtes Slack des requêtes effectuées dans l'interface utilisateur web de Databricks (webapp) ou via d'autres intégrations, telles que Microsoft Teams (teams).

La requête exemple suivante renvoie les demandes Genie provenant de Slack au cours des 5 derniers jours, incluant l'utilisateur qui a posé la question et l'ID de conversation :

SQL

SELECT
  event_time,
  user_identity.email AS user_email,
  request_params.conversation_id AS conversation_id
FROM system.access.audit
WHERE service_name = 'genieChat'
  AND action_name = 'createGenieChatResponse'
  AND request_params.source = 'slack'
  AND event_date >= date_add(current_date(), -5)
ORDER BY event_time DESC

Pour le schéma de la table des logs d'audit et d'autres exemples de queries, consultez la référence de la table système des logs d'audit. Pour obtenir la liste complète des événements de chat Genie One, consultez Chat events in Genie One.

Limitations

• Vous ne pouvez pas spécifier le compute (SQL Warehouse) utilisé par l'application Databricks Genie pour Slack. Databricks sélectionne automatiquement un SQL Warehouse auquel l’utilisateur est autorisé à accéder.
• Lorsqu’un Genie Agent spécifique est pin en tant que portée Genie, Genie One peut réécrire la question avant qu’elle n’atteigne l’agent pin.
• Les conversations commencées sur Genie One y restent après qu’un Genie Agent a été pin. Seules les nouvelles conversations sont dirigées vers l’agent pin.
• Les commentaires (pouce vers le haut ou vers le bas) sont toujours envoyés à Genie One, même lorsqu’un Genie Agent spécifique est pin.
• La création d’agents Genie ou d’agents Genie à partir de Slack n’est pas prise en charge.

Dépannage

Message « Approbation de l'administrateur requise » lors de la Connexion

Si vous utilisez Microsoft Entra ID pour vous authentifier auprès de votre Databricks workspace, le message suivant « Nécessite l'approbation de l'administrateur » peut apparaître lorsque vous vous connectez. Cela se produit car le tenant Microsoft Entra bloque le consentement de l'utilisateur pour l'application Databricks. Si le consentement de l'administrateur n'est pas accordé, Microsoft Entra ID continue de bloquer le processus de connexion même si vous avez un accès direct au workspace.

Pour résoudre ce problème, un utilisateur Microsoft Entra disposant des rôles d'administrateur appropriés doit accorder le consentement d'administrateur à l'échelle du tenant à l'application d'entreprise Databricks.

Demandez à l'administrateur Microsoft Entra de visiter le Link suivant. Remplacez {TENANT_ID} par votre ID de tenant Microsoft Entra :

Text

https://login.microsoftonline.com/{TENANT_ID}/adminconsent?client_id=aaec40b0-c0ae-4211-a98b-6fc160abb71b

Si le Link échoue, l’administrateur peut accorder le consentement manuellement :

1. Dans le centre d'administration Microsoft Entra, accédez à Entra ID > Applications d'entreprise > Toutes les applications et recherchez l'application d'entreprise Databricks utilisée pour le Single Sign On. Pour identifier l'application, recherchez l'ID de l'application aaec40b0-c0ae-4211-a98b-6fc160abb71b.
2. Accorder le consentement de l'administrateur pour les autorisations demandées par l'application d'entreprise Databricks :
   1. Sous Sécurité , cliquez sur Autorisations .
   2. Cliquez sur Accorder le consentement administrateur .

Pour des instructions détaillées, consultez la documentation Microsoft.

Questions fréquemment posées

Mes messages privés (éphémères) dans un canal de distribution ont disparu. Que s’est-il passé ?

Un message éphémère Slack disparaît de la vue de l'utilisateur dans l'une des situations suivantes :

• L'utilisateur recharge ou refresh le client Slack.
• L'utilisateur change de plateformes, par exemple, de l'ordinateur de bureau au mobile.
• L'utilisateur se déconnecte, se reconnecte ou la session expire.
• Le processus de l’application Slack se ferme et se rouvre.

Ressources supplémentaires

• Utiliser Genie One
• Discuter dans Genie One
• Connecter Genie Code aux serveurs MCP
• Destinations d’applications Genie pour Slack et Microsoft Teams
• Centre d'aide Databricks