Application Databricks Genie dans Microsoft Teams

L’application Databricks Genie dans Microsoft Teams place Genie dans Microsoft Teams afin que les utilisateurs puissent poser des questions sur les données et obtenir des réponses sans quitter l’espace de travail Microsoft Teams. Les utilisateurs peuvent discuter avec l’application dans un message direct ou mentionner @Databricks Genie dans un canal ou une conversation de groupe Microsoft Teams. Les questions sont répondues par Genie One ou par un Agent Genie spécifique que le propriétaire du canal a épinglé pour des réponses cohérentes et spécifiques à chaque cas d’usage.

L’application Genie de Databricks dans Microsoft Teams repose sur l’API Genie One dans les deux cas ; lorsqu’un agent Genie est épinglé, Genie One envoie la question uniquement à cet agent. L’application utilise les mêmes fournisseurs de modèles ainsi que les mêmes garanties de confiance et de sécurité que Genie. Consultez le fournisseur d’hébergement utilisé lorsque le paramètre des fonctionnalités d’IA optimisées par un partenaire est activé ou désactivé et les fonctionnalités d’assistance IA de Databricks : confiance et sécurité.

Cette page explique comment télécharger, configurer et utiliser l’application Databricks Genie dans Microsoft Teams.

Prerequisites

Avant d’installer l’application Databricks Genie dans Microsoft Teams :

• Un administrateur de compte doit activer Databricks Genie pour Microsoft Teams préversion dans la console de compte.
• Pour permettre aux utilisateurs de téléverser des fichiers dans les messages directs, un administrateur de l’espace de travail doit activer l’aperçu Genie One File Upload, et le compte Microsoft Teams de chaque utilisateur doit disposer de OneDrive Entreprise. Voir Charger des fichiers.
• Pour permettre aux utilisateurs d’enregistrer des documents PDF dans des messages privés, chaque utilisateur doit utiliser OneDrive et la version 1.0.17 et supérieure de l’application Databricks Genie dans Microsoft Teams. Voir Enregistrer les documents sous forme de PDF.
• Si votre espace de travail utilise une liste d’accès IP, ajoutez les adresses IP sortantes du plan de contrôle Azure Databricks dans la région USA Est 2. Consultez les adresses IP sortantes dans la documentation Azure Databricks.

Installer l’application Databricks Genie dans Microsoft Teams

Un administrateur Microsoft 365 installe l’application Databricks Genie dans Microsoft Teams à partir de la place de marché Microsoft :

1. Dans le Marketplace Microsoft, recherchez Databricks Genie et trouvez-le.
2. Installez l’application.
3. Approuvez les autorisations d’application lorsque vous y êtes invité pendant l’installation.

Pour une liste des autorisations requises, voir Autorisations requises pour les applications sur Microsoft.

Après l’installation, les utilisateurs peuvent commencer à utiliser l’application.

Utiliser l’application Databricks Genie dans Microsoft Teams

Vous pouvez utiliser l’application Databricks Genie dans Microsoft Teams via des messages directs ou dans des conversations de canal sur votre espace de travail Microsoft Teams, ou à partir de Microsoft 365 Copilot.

Message privé

Pour envoyer directement un message à l’application Databricks Genie dans Microsoft Teams :

1. Dans Microsoft Teams, cliquez sur Applications dans la barre latérale gauche et ouvrez l’application Databricks Genie dans Microsoft Teams.

2. Saisissez votre question.

3. Si vous n’êtes pas connecté, l’application Databricks Genie dans Microsoft Teams vous invite à vous connecter :

   1. Cliquez sur Configurer.
   2. Spécifiez l’URL de votre espace de travail. Pour trouver l’URL de votre espace de travail, consultez les noms d’instance, les URLs et les identifiants de l’espace de travail.
   3. Cliquez sur Continuer pour vous connecter à votre compte Azure Databricks.

4. Votre question est acheminée vers l’Agent Génie le plus approprié et retourne une réponse avec des sources et des invites de suivi suggérées.

Pour lancer une nouvelle conversation dans un message direct, envoyez newchat. Cela efface le contexte de la conversation en cours afin que votre prochain message démarre une nouvelle conversation avec Genie. Vos messages Microsoft Teams existants ne sont pas supprimés.

Pour configurer l’espace de travail et la portée Genie pour toutes les conversations par message direct ultérieures, ouvrez l’application Databricks Genie sur la page d’accueil de Microsoft Teams et ajustez les paramètres.

Télécharger des fichiers

Dans un message privé, vous pouvez joindre jusqu’à cinq fichiers PDF, Word ou CSV de 20 Mio ou moins à un message, et Genie les utilise comme contexte pour répondre. Le chargement de fichiers n’est pas disponible dans les canaux, les conversations de groupe ou Microsoft 365 Copilot.

Microsoft Teams stocke les fichiers que vous joignez dans une conversation dans votre OneDrive Entreprise, donc votre compte Microsoft Teams doit avoir OneDrive Entreprise pour téléverser des fichiers.

Pour charger des fichiers :

1. Dans un message direct avec l’application Databricks Genie dans Microsoft Teams, associez jusqu’à cinq fichiers à votre message.
2. Facultativement, entrez une question sur les fichiers.
3. Envoyez le message.

Si votre message inclut une question, Genie téléverse les fichiers puis répond à la question en les utilisant. Si vous envoyez des fichiers sans poser de questions, Genie procède à leur chargement et confirme quand ils sont prêts. Vous pourrez alors poser des questions sur les fichiers.

Les fichiers téléchargés restent disponibles pour les questions de suivi dans la conversation en cours. Après avoir envoyé newchat, joignez à nouveau les fichiers pour les utiliser dans la nouvelle conversation.

Si vous ajoutez plus de cinq fichiers, Genie charge les cinq premiers et répertorie les fichiers qu’il a ignorés. Si un fichier ne peut pas être chargé, Genie l’affiche avec la raison. Tant qu’au moins un fichier est chargé, Genie répond toujours à votre question.

Si Genie répond qu’Azure Databricks n’a pas pu autoriser le chargement, demandez à un administrateur de l’espace de travail de confirmer que l’aperçu Chargement d’un fichier par Genie est activé pour votre espace de travail.

Enregistrer les documents sous forme de PDF

Lorsque Genie rédige un document dans un message privé, l’application Databricks Genie dans Microsoft Teams propose le document en PDF dans une carte de fichier. Pour savoir comment demander à Genie de rédiger un document, voir Documents dans Genie One.

Pour enregistrer le PDF sur votre OneDrive, cliquez sur Autoriser l’accès sur la fiche du fichier. L’application remplace la carte par le PDF dans la conversation instantanée. Pour ignorer l’offre, cliquez sur Refuser.

Pour sauvegarder des PDF, vous avez besoin de OneDrive et de la version 1.0.17 et supérieure de l’application Databricks Genie dans Microsoft Teams. Si vous ne parvenez pas à cliquer sur Autoriser parce que OneDrive est désactivé pour votre compte, ouvrez plutôt le document dans Genie One.

• Le PDF porte le nom du titre du document.
• Si une réponse inclut plus d’un document, l’application ne propose que le premier.
• L’offre expire 15 minutes après que l’application l’a publiée. Si la génération du PDF est en cours ou ne peut pas démarrer, la carte vous demande de cliquer à nouveau sur Autoriser. Faites-le avant l’expiration de l’offre. Pour obtenir un PDF après l’expiration de l’offre, demandez à Genie de générer à nouveau le document.
• Les PDF de plus de 20 Mio ne peuvent pas être sauvegardés. Ouvrez plutôt le document dans Genie One.

Conversation sur le canal

Vous pouvez ajouter l’application Databricks Genie dans Microsoft Teams à un canal. À l’aide configde , les propriétaires de canaux peuvent configurer des paramètres pour tous les membres d’un canal et les utilisateurs individuels peuvent configurer des paramètres personnels. Les configurations de propriétaire de canal remplacent les configurations personnelles.

Pour configurer l’application Databricks Genie dans Microsoft Teams dans un canal :

1. Dans le canal souhaité, tapez @Databricks Genie.

2. Si vous y êtes invité, ajoutez l’application Databricks Genie dans Microsoft Teams au canal.

3. Tapez config.

4. Sélectionnez l’espace de travail connecté, la visibilité du message et le scope Genie (Genie One ou un agent Genie spécifique).

   Si aucun assistant Genie n’est épinglé, le canal utilise Genie One par défaut.

5. Après la configuration, toutes les mentions @Databricks Genie dans le canal sont acheminées vers l’agent et l’espace de travail configurés.

Visualizations

Lorsqu’une réponse du Génie inclut une visualisation, le tableau apparaît sous forme d’image dans la réponse.

Les visualisations ne sont pas affichées lorsque la visibilité du message est réglée en privé, car les messages privés ne sont visibles que pour l’utilisateur qui a demandé.

Niveaux de configuration et remplacements

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

• Sélection de l’espace de travail : l’espace de travail Azure Databricks auquel l’application Databricks Genie dans Microsoft Teams se connecte pour répondre aux questions.
• Visibilité des messages : indique si @Databricks Genie les réponses dans les canaux sont visibles par tous les membres du canal ou uniquement par l’utilisateur qui a demandé. Par défaut, les réponses sont publiques.
• Périmètre de Genie : Genie One ou un agent Genie spécifique. Les deux utilisent l’API Genie One ; épingler un agent Génie spécifique demande à Génie Un d’envoyer la question uniquement à cet agent, pour des réponses cohérentes et spécifiques à chaque cas d’usage.

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

Routage des données

Genie traite vos questions dans votre espace de travail et stocke l’historique des conversations dans la région de votre espace de travail. Les requêtes entre Microsoft Teams et votre espace de travail passent par un service central Azure Databricks dans le plan de contrôle Azure Databricks. Le service central fonctionne dans la région East US 2, quelle que soit la région de votre espace de travail. Le service central ne persiste ni ne consigne aucun contenu de requête ou de réponse. Elle stocke uniquement la correspondance entre votre locataire Microsoft Teams et votre espace de travail Azure Databricks.

Microsoft Teams a besoin d’un point de terminaison fixe pour recevoir les requêtes, donc l’application utilise un service central.

Lorsque vous posez une question dans Microsoft Teams :

1. Microsoft Teams envoie votre question au service central.
2. Le service central transmet la requête à votre espace de travail Azure Databricks.
3. Genie traite la demande et génère une réponse dans votre espace de travail.
4. La réponse revient à Microsoft Teams via le service central.

Lorsque vous enregistrez un document en PDF, l’application télécharge le PDF depuis votre espace de travail et le charge sur votre OneDrive via East US 2. L’application ne stocke pas le PDF.

Là où se fait le traitement des LLM

Le service central achemine les messages entre Microsoft Teams et votre espace de travail. Genie dans votre espace de travail appelle le modèle de langage de grande taille (LLM), donc la géo de votre espace de travail et son paramètre de traitement inter-géo déterminent où le LLM traite votre contenu. Par exemple, si votre espace de travail est en Europe Geo et que le traitement inter-géo n’est pas activé, le LLM traite votre contenu en Europe. Consultez Services désignés Databricks.

Surveillez l’utilisation avec des journaux d’audit

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

L’exemple de requête suivant renvoie les requêtes Genie originées par Microsoft Teams des 5 derniers jours, incluant l’utilisateur qui a demandé et l’identifiant de conversation :

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 = 'teams'
  AND event_date >= date_add(current_date(), -5)
ORDER BY event_time DESC

Pour le schéma de la table du journal d’audit et d’autres exemples de requêtes, voir Référence de la table système du journal d’audit. Pour la liste complète des événements de discussion Genie One, voir Événements de chat dans Genie One.

Autorisations requises pour les applications sur Microsoft

Lorsque vous installez l’application Databricks Genie dans Microsoft Teams, elle demande les autorisations suivantes. Les permissions Entra ID sont des autorisations Microsoft Graph à l’échelle du locataire auxquelles un administrateur Microsoft 365 consent pour votre organisation. Les autorisations spécifiques à une ressource sont des autorisations de consentement spécifique à une ressource (RSC) de Teams qui ne s’appliquent qu’au chat, au canal ou à l’équipe où l’application est installée.

Pour plus d’informations sur ces permissions, voir Consentement spécifique à la ressource et Autorisations Graph dans la documentation Microsoft.

Résolution des problèmes

Message « Besoin d’approbation administrateur » lors de la connexion

Le message suivant « Besoin d’approbation d’administrateur » s’affiche lorsque vous vous connectez à votre espace de travail Azure Databricks, car le locataire Microsoft Entra bloque le consentement de l’utilisateur pour l’application Azure Databricks. Si le consentement de l’administrateur n’est pas accordé, Microsoft Entra ID continue de bloquer le flux de connexion même si vous disposez d’un accès direct à l’espace de travail.

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

Demandez à l’administrateur Microsoft Entra de consulter le lien suivant. Remplacez {TENANT_ID} par votre ID de locataire Microsoft Entra :

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

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

1. Dans le centre d’administration Microsoft Entra, accédez à Entra ID>Enterprise apps>All applications et recherchez l’application d’entreprise Azure Databricks utilisée pour l’authentification unique. Pour identifier l’application, recherchez l’ID d’application aaec40b0-c0ae-4211-a98b-6fc160abb71b.
2. Accordez le consentement administrateur pour les autorisations demandées par l’application d’entreprise Azure Databricks :
   1. Sous Sécurité, cliquez sur Autorisations.
   2. Cliquez sur Accorder le consentement de l’administrateur.

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

Limitations

• Vous ne pouvez pas spécifier le calcul (SQL Warehouse) que l’application Databricks Genie utilise dans Microsoft Teams. Azure Databricks sélectionne automatiquement un entrepôt SQL auquel l’utilisateur est autorisé à accéder.
• Lorsqu’un assistant Genie spécifique est épinglé comme étendue Genie, Genie One peut reformuler la question avant qu’elle n’atteigne l’assistant épinglé.
• Les commentaires (pouce vers le haut ou vers le bas) sont toujours envoyés à Genie One, même lorsqu’un assistant Genie spécifique est épinglé.
• PrivateLink n’est pas pris en charge.
• Le téléversement de fichiers n’est pris en charge que dans les messages directs. Dans les canaux, les groupes de discussion et Microsoft 365 Copilot, Genie ne répond pas à un message contenant des pièces jointes. À la place, il répond que les téléversements fonctionnent uniquement par message direct.
• Le téléchargement de fichiers ne prend en charge que les fichiers PDF, Word (.docx) et CSV de 20 Mo ou moins, jusqu’à cinq fichiers par message.
• L’enregistrement des documents en PDF n’est disponible que par messages directs. Genie ne propose pas de PDF dans les canaux, les groupes de discussion ou Microsoft 365 Copilot. OneDrive et la version 1.0.17 et supérieure de l’application Databricks Genie dans Microsoft Teams sont nécessaires. Les PDF de plus de 20 Mio ne peuvent pas être sauvegardés.
• Le déclenchement d’actions dans Azure Databricks depuis Teams n’est pas pris en charge.

Ressources additionnelles

• Utiliser Genie One
• Conversation dans Genie One
• Destinations de l’application Genie pour Slack et Microsoft Teams
• Pour obtenir du support, consultez le centre d’aide Databricks.