Application Databricks Genie pour Slack

info

Aperçu

Cette fonctionnalité est en aperçu public.

L’application Databricks Genie pour Slack intègre Genie dans Slack afin que les utilisateurs obtiennent des réponses à leurs questions sur les données sans quitter Slack. Envoyez un message direct à l’application, ou mentionnez @Genie dans un canal ou un message direct de groupe. Votre question reçoit une réponse de Genie One ou d’un Genie Agent spécifique qu’un propriétaire de Canal de distribution a pin pour obtenir des réponses cohérentes et spécifiques au cas d’utilisation. L’application s’appuie sur l’API Genie One dans les deux cas ; lorsqu’un Genie Agent est épinglé, Genie One envoie la question uniquement à cet agent. 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 des fonctionnalités d’IA basées sur des partenaires est activé ou désactivé et Confiance et sécurité des fonctionnalités d’assistance par IA de Databricks.

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 :

• Un administrateur de compte doit activer l'aperçu public de **Databricks Genie for Slack** dans la console de compte.
• 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.

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.
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. Connectez-vous à votre compte Databricks et sélectionnez un Workspace auquel vous connecter.
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 Genie dans Slack incluent un bouton **Afficher dans Genie**. Cliquez dessus pour ouvrir 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. L'application Databricks Genie pour Slack achemine la question à l'agent Genie le plus approprié et renvoie une réponse avec des sources et des suggestions de relance.

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.

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 deux utilisent l’API Genie One ; l’épinglage d’un Genie Agent spécifique demande à Genie One d’envoyer la question uniquement à cet agent, pour des réponses cohérentes et spécifiques au cas d’utilisation.

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 effectue la configuration à partir des paramètres de sécurité du Workspace en utilisant les champs Allow connection to 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 effectue la configuration à partir des paramètres de sécurité du Workspace en utilisant les champs Allow connection to 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.

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 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.
• PrivateLink n'est pas pris en charge.
• Les fonctionnalités suivantes ne sont pas prises en charge :
  • Visualiser des graphiques
  • Envoi de notifications Databricks à Slack.
  • Trigger des actions dans Databricks depuis Slack
  • Création d'Agents Genie ou d'Agents Genie.

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: Connectez manuellement Genie Code aux serveurs MCP. Ceci est distinct de l'application Databricks Genie pour Slack.
• Centre d'aide Databricks