Configurer Genie Search

Genie Search crée et gère un index de recherche parmi les sources où votre organisation conserve ses connaissances : Google Drive, Jira, Confluence et Workday. Databricks ingère et indexe le contenu ainsi que les autorisations de chaque document, et maintient les deux à jour à mesure qu’ils sont modifiés.

Avec Genie Search, Genie effectue une recherche dans un index couvrant toutes vos sources connectées, au lieu d’interroger chaque source séparément. Genie Search étend également l’ ontologie Genie au-delà de Databricks, afin que Genie puisse s’appuyer sur vos documents et tickets comme contexte lorsqu’il répond aux questions. Les utilisateurs ne voient que le contenu qu’ils peuvent déjà ouvrir dans la source.

Workday alimente également les répertoires d'organisation dans Genie One. Voir Connecter une source de personnes pour Genie One.

Exigences

• Privilèges d’administrateur de compte Databricks
• Un administrateur pour chaque source que vous connectez, comme un administrateur Google Workspace ou Atlassian, pour autoriser l’accès. Il peut s’agir d’une personne différente de l’administrateur du compte Databricks.

Sources prises en charge

Genie Search indexe les sources suivantes.

Source	Qu’est-ce qui est indexé	Comment vous authentifier
Google Drive	Fichiers Google Workspace, fichiers Microsoft Office, fichiers PDF et fichiers texte. Consultez les types de fichiers pris en charge dans Limites.	Compte de service Google Cloud avec délégation à l’échelle du domaine
Jira Cloud	Tous les projets accessibles par l'utilisateur autorisateur	Votre propre application Atlassian OAuth 2.0
Confluence Cloud	Tous les espaces que l'utilisateur autorisant peut voir	Votre propre application Atlassian OAuth 2.0
Workday	Profils de Worker à partir d’un rapport personnalisé Workday Reports-as-a-Service (RaaS), pour les répertoires d’organisation dans Genie One	Voir Connecter une source de personnes pour Genie One.

Source	Qu’est-ce qui est indexé	Comment vous authentifier
Google Drive	Fichiers Google Workspace, fichiers Microsoft Office, fichiers PDF et fichiers texte. Consultez les types de fichiers pris en charge dans Limites.	Compte de service Google Cloud avec délégation à l’échelle du domaine
Jira Cloud	Tous les projets accessibles par l'utilisateur autorisateur	Votre propre application Atlassian OAuth 2.0
Confluence Cloud	Tous les espaces que l'utilisateur autorisant peut voir	Votre propre application Atlassian OAuth 2.0
Workday	Profils de Worker à partir d’un rapport personnalisé Workday Reports-as-a-Service (RaaS), pour les répertoires d’organisation dans Genie One	Voir Connecter une source de personnes pour Genie One.

Connecter une source

Start chaque connexion depuis la console du compte.

1. Dans la console de compte, cliquez sur Genie Ontology .
2. Cliquez sur Connecter la source .
3. Sélectionnez la source.
4. Dans Data residency Geo , sélectionnez la zone géographique où l’index de la source est stocké. Vous ne pouvez sélectionner qu’une zone géographique dans laquelle votre compte possède un Workspace. Si le compte possède déjà une source, sélectionnez la même zone géographique. Voir Stockage et emplacement.

Suivez ensuite les étapes pour votre source :

Google Drive

Vous avez besoin d’un projet Google Cloud où vous pouvez créer un compte de service, et d’un administrateur Google Workspace capable d’accorder une délégation à l’échelle du domaine dans la console d’administration Google.

1. Créez un compte de service et une clé JSON :

   1. Dans la console Google Cloud, accédez à IAM & Admin > Service Accounts .
   2. Cliquez sur Create service account .
   3. Saisissez un nom et une description pour le compte de service, puis cliquez sur Créer et continuer .
   4. Cliquez sur Terminé . Vous n’avez pas besoin d’accorder des rôles au niveau du projet.
   5. Sur la page Comptes de service , cliquez sur le compte de service que vous avez créé.
   6. Sous le Keys tab, cliquez sur Add key > Create new key .
   7. Sélectionnez JSON , puis cliquez sur Créer . Le fichier de clé JSON download sur votre machine.

2. Activez les APIs Google utilisées par le compte de service :

   1. Dans la console Google Cloud, accédez à APIs et services > Bibliothèque .
   2. Recherchez Google Drive API , cliquez dessus, puis cliquez sur Activer .
   3. Recherchez Admin SDK API , cliquez dessus, puis cliquez sur Activer .

3. Accorder une délégation à l’échelle du domaine :

   1. Dans la console Google Cloud, copiez l’ ID unique (ID client) du compte de service à partir de l’ tab Détails.

   2. Dans la console d'administration Google, accédez à Sécurité > Contrôle de l'accès et des données > Contrôles de l'API .

   3. Sous Délégation à l’échelle du domaine , cliquez sur Gérer la délégation à l’échelle du domaine .

   4. Cliquez sur Ajouter un nouveau .

   5. Dans Client ID , collez l’ID unique du compte de service.

   6. Dans OAuth scopes , saisissez les portées en lecture seule suivantes, séparées par des virgules :

      Text

      https://www.googleapis.com/auth/drive.readonly,https://www.googleapis.com/auth/admin.directory.user.readonly,https://www.googleapis.com/auth/admin.directory.group.readonly,https://www.googleapis.com/auth/admin.reports.audit.readonly

   7. Cliquez sur Autoriser .

4. Dans la boîte de dialogue Connecter Google Drive dans Databricks, collez le contenu complet de la clé JSON, y compris les accolades ouvrantes et fermantes, dans JSON du compte de service .

5. Dans Admin e-mail , saisissez l’e-mail d’un administrateur Google Workspace qui peut lire les utilisateurs, les groupes et les lecteurs partagés. Le compte de service agit en tant qu’administrateur.

6. Cliquez sur start l'ingestion .

Si vous ignorez l’une des étapes de délégation, d’API ou d’étendue, l’ingestion peut échouer ou manquer de contenu jusqu’à ce que vous ayez terminé cette configuration.

Jira

L’utilisateur qui autorise la connexion doit disposer des autorisations globales ADMINISTER JIRA et BROWSE USERS AND GROUPS. Consultez Autorisations globales dans la documentation Atlassian.

1. Dans la boîte de dialogue Connecter Jira , copiez l’URL de rappel.

2. Dans la console développeur Atlassian, cliquez sur Créer > Intégration OAuth 2.0 , saisissez un nom et cliquez sur Créer . Pour utiliser une application OAuth existante à la place, ouvrez-la et ajoutez les scopes et l’URL de rappel dans les étapes suivantes.

3. Allez dans Autorisations > API Jira (sous Portées d'API ) et cliquez sur Ajouter .

4. Cliquez sur Scopes classiques > Modifier les scopes , puis ajoutez read:jira-work et read:jira-user.

5. Cliquez sur Granular Scopes > Edit Scopes , puis ajoutez les étendues suivantes :

   • read:project-role:jira
   • read:project-category:jira
   • read:project:jira
   • read:user:jira
   • read:avatar:jira
   • read:group:jira
   • read:application-role:jira
   • read:workflow:jira
   • read:issue-security-level:jira
   • read:issue-security-scheme:jira
   • read:audit-log:jira
   • read:sprint:jira-software
   • read:board-scope:jira-software
   • read:board-scope.admin:jira-software

6. Accédez à Autorisation , cliquez sur Ajouter et saisissez l’URL de rappel que vous avez copiée.

7. Accédez à Paramètres et copiez l’ ID client et le Secret .

8. Dans la boîte de dialogue Connecter Jira , saisissez l' URL du site Jira , y compris https://. Par exemple, https://yourcompany.atlassian.net. N’ajoutez pas de chemin ou de barre oblique finale.

9. Saisissez l’ identifiant client et le secret client de votre application OAuth.

10. Cliquez sur Autoriser , choisissez le site Jira et cliquez sur Accepter .

11. Cliquez sur start l'ingestion .

Confluence

L’utilisateur qui autorise la connexion doit disposer de l’autorisation globale CONFLUENCE ADMINISTRATOR et avoir accès à chaque espace que vous souhaitez indexer. Consultez Gérer les autorisations globales dans la documentation Atlassian.

1. Dans la boîte de dialogue Connecter Confluence , copiez l’URL de rappel.

2. Dans la console développeur Atlassian, cliquez sur Créer > Intégration OAuth 2.0 , saisissez un nom et cliquez sur Créer . Pour utiliser une application OAuth existante à la place, ouvrez-la et ajoutez les scopes et l’URL de rappel dans les étapes suivantes.

3. Accédez à Autorisations > API Confluence (sous Portées de l’API ) et cliquez sur Ajouter .

4. Cliquez sur Granular Scopes > Edit Scopes , puis ajoutez les étendues suivantes :

   • read:page:confluence
   • read:attachment:confluence
   • read:space:confluence
   • read:configuration:confluence
   • read:label:confluence
   • read:space.permission:confluence
   • read:content.permission:confluence
   • read:content-details:confluence
   • read:group:confluence
   • read:user:confluence
   • read:audit-log:confluence
   • read:analytics.content:confluence

5. Accédez à Autorisation , cliquez sur Ajouter et saisissez l’URL de rappel que vous avez copiée.

6. Accédez à Paramètres et copiez l’ ID client et le Secret .

7. Dans la boîte de dialogue Connect Confluence , saisissez le domaine du site Confluence , sans https://. Par exemple, yourcompany.atlassian.net.

8. Saisissez l’ identifiant client et le secret client de votre application OAuth.

9. Cliquez sur Autoriser , choisissez le site Confluence et cliquez sur Accepter .

10. Cliquez sur start l'ingestion .

Workday

Pour connecter Workday pour les répertoires d'organisation, voir Connecter une source de personnes pour Genie One.

L’indexation initiale peut prendre des heures ou des jours, selon la quantité de contenu dans la source. Le statut de la source est Provisionnement jusqu’à ce que l’indexation se termine, puis Recherchable . Si la configuration échoue, le statut est Échec .

Utiliser le contenu indexé

Une fois qu’une source est interrogeable , le chat de Genie One utilise automatiquement la recherche Genie pour répondre aux questions. Les utilisateurs peuvent également trouver du contenu indexé dans Genie One Discover, en plus des assets Databricks. Voir Utiliser la recherche Genie dans Genie One.

Connecteurs Genie Search et MCP

Genie Search et les connecteurs Model Context Protocol (MCP) fonctionnent ensemble, et Databricks recommande d’activer les deux pour les sources sur lesquelles vos équipes s’appuient. Genie Search permet à Genie de rechercher tout ce qu’un administrateur de compte a indexé en un seul endroit. Les connecteurs MCP permettent à chaque utilisateur de connecter des applications telles que Gmail et Slack avec leurs propres identifiants, afin que Genie One puisse consulter des informations en temps réel et prendre des mesures, comme la rédaction d’un e-mail, la publication sur un canal de distribution Slack ou la mise à jour d’un ticket Jira.

Lorsque les deux sont activés, Genie choisit l’approche qui correspond à chaque requête. Par exemple, Genie peut utiliser Genie Search pour trouver les documents de conception, les wikis et les tickets relatifs à un lancement, puis utiliser le connecteur Atlassian pour mettre à jour les tickets Jira associés.

Aspect	Genie Search	Connecteurs MCP
Installer	Un administrateur de compte connecte chaque source une seule fois pour l’ensemble du compte.	Chaque utilisateur se connecte à chaque connecteur avec ses propres identifiants.
Rechercher	Recherche simultanée de tout le contenu indexé dans les sources connectées.	Query chaque source en direct. Genie choisit les connecteurs à appeler pour chaque requête.
Fraîcheur	Montre les modifications après le prochain refresh de l’index.	Renvoie l’état actuel de la source.
Actions	Lecture seule.	Crée et met à jour le contenu de l’application en tant qu’utilisateur. Voir Actions d’écriture.
Autorisations	Applique les autorisations source de chaque document. Les autorisations sont refresh avec le contenu, et les documents non publics sont revérifiés au moment de la query.	Utilise les autorisations de l’utilisateur dans l’application.
Gouvernance	Les administrateurs de compte gèrent chaque source sur la page Ontologie Genie dans la console de compte.	Les administrateurs contrôlent les connecteurs, les outils et les politiques dans Unity Gateway. Voir Gérer un MCP.
Sources	Google Drive, Jira, Confluence et Workday.	Connecteurs fournis par Databricks et services MCP personnalisés. Voir Connecter Genie One à des applications externes avec MCP.

Aspect	Genie Search	Connecteurs MCP
Installer	Un administrateur de compte connecte chaque source une seule fois pour l’ensemble du compte.	Chaque utilisateur se connecte à chaque connecteur avec ses propres identifiants.
Rechercher	Recherche simultanée de tout le contenu indexé dans les sources connectées.	Query chaque source en direct. Genie choisit les connecteurs à appeler pour chaque requête.
Fraîcheur	Montre les modifications après le prochain refresh de l’index.	Renvoie l’état actuel de la source.
Actions	Lecture seule.	Crée et met à jour le contenu de l’application en tant qu’utilisateur. Voir Actions d’écriture.
Autorisations	Applique les autorisations source de chaque document. Les autorisations sont refresh avec le contenu, et les documents non publics sont revérifiés au moment de la query.	Utilise les autorisations de l’utilisateur dans l’application.
Gouvernance	Les administrateurs de compte gèrent chaque source sur la page Ontologie Genie dans la console de compte.	Les administrateurs contrôlent les connecteurs, les outils et les politiques dans Unity Gateway. Voir Gérer un MCP.
Sources	Google Drive, Jira, Confluence et Workday.	Connecteurs fournis par Databricks et services MCP personnalisés. Voir Connecter Genie One à des applications externes avec MCP.

Gérer les sources

Les administrateurs de compte gèrent les sources connectées sur la page Genie Ontology dans la console du compte.

Pour arrêter de servir une source Google Drive, Jira ou Confluence sans supprimer son contenu indexé, désactivez son commutateur Enabled . Genie arrête d’utiliser la source. Vous pourrez la réactiver ultérieurement.

Pour remplacer les informations d’identification d’une source Google Drive, Jira ou Confluence sans supprimer son contenu indexé, cliquez sur le menu Kebab sur la ligne de la source, puis cliquez sur Réautoriser . Pour révoquer une information d’identification, supprimez la source.

Pour supprimer une source :

1. Cliquez sur le menu kebab sur la ligne de source.
2. Cliquez sur Supprimer la source .
3. Confirmez. L’ingestion s’arrête, le contenu indexé est supprimé et la reconnexion nécessite une ingestion complète.

Comment Genie Search traite vos données

Genie Search stocke une copie de votre contenu indexé et de ses autorisations dans Databricks. Les sections suivantes décrivent où ces données sont stockées, comment les informations d’identification et les autorisations sources sont gérées, et combien de temps les données sont conservées.

Stockage et emplacement

Chaque compte obtient un catalogue dédié et chaque source obtient son propre index de recherche. Les données indexées sont stockées dans le plan de données et isolées des autres clients.

Les données indexées restent dans une seule zone géographique, choisie par un administrateur de compte lorsqu’il connecte une source. Toutes les sources du compte utilisent la même zone géographique. Les utilisateurs peuvent interroger les données indexées à partir de n’importe quel Workspace dans cette zone géographique, et les querys provenant de Workspace dans d’autres zones géographiques sont bloquées. Les chats Genie One au niveau du compte peuvent utiliser des données indexées lorsque leur région est dans la même zone géographique.

Identifiants

Les informations d’identification que vous fournissez lorsque vous connectez une source sont stockées dans une connexion Unity Catalog dans un compte géré par Databricks. Databricks ne les utilise que pour ingérer les données que vous autorisez. Pour remplacer ou révoquer une information d’identification, voir Gérer les sources.

Autorisations

Databricks ingère les autorisations de chaque document avec son contenu et les applique lorsque Genie récupère des résultats, afin que les utilisateurs ne voient que le contenu auquel ils peuvent déjà accéder dans la source.

Les autorisations sont refresh au même rythme que le contenu, selon un calendrier qui varie en fonction de la source et dépend de facteurs tels que les limites de l’API de la source et le volume de données. Pour les documents non publics, Genie Search revérifie également l’accès à la source au moment de la query, en utilisant un cache court.

Les répertoires d’organisation font exception. Tous les utilisateurs de Genie One dans votre compte voient les mêmes détails de profil. Voir Qu’est-ce qui est ingéré.

Rétention et suppression

Le contenu supprimé dans la source est retiré de l’index lors du prochain refresh. Pour supprimer toutes les données indexées d’une source, supprimez la source. La reconnexion ultérieure nécessite une ingestion complète. Pour arrêter d’utiliser une source sans supprimer ses données, désactivez la source. Voir Gérer les sources.

Limitations

Les limitations suivantes s’appliquent à Genie Search.

• Genie Search n’est pas disponible dans les régions AWS GovCloud.

• Le contenu de Genie Search est uniquement disponible dans Genie One. Genie Code ne l’utilise pas.

• Vous ne pouvez pas exclure de contenu d’une source, comme des dossiers Google Drive spécifiques, des projets Jira ou des espaces Confluence.

• Google Drive n’indexe que les types de fichiers suivants. Les autres fichiers, tels que les images et les vidéos, sont ignorés.

  • Google Docs, Google Sheets et Google Slides
  • Microsoft Word (.doc et .docx)
  • Microsoft Excel (.xls et .xlsx)
  • Microsoft PowerPoint (.ppt et .pptx)
  • PDF (.pdf)
  • Texte brut (.txt)
  • Markdown (.md)
  • Format de texte riche (.rtf)
  • CSV (.csv)

• Les fichiers Google Drive supérieurs à 100 Mo sont ignorés et les fichiers supérieurs à 10 Mo conservent uniquement les métadonnées.

• Les PDF sont indexés à partir du texte extrait, sans reconnaissance optique de caractères (OCR).

• Seuls Jira Cloud et Confluence Cloud sont pris en charge. Jira on-premise et Confluence on-premise ne le sont pas.

• Les résultats de Jira et de Confluence suivent les autorisations de chaque élément, mais Genie Search ne vérifie pas si l’utilisateur possède toujours une licence Jira ou Confluence.

• Il n’existe pas d’API pour gérer les sources. La configuration se trouve dans la console du compte.

• Toutes les sources d’un compte utilisent la même zone géographique. Pour changer de zone géographique, supprimez toutes les sources, puis reconnectez-les.

Tarifs

Actuellement, les clients n’encourent aucun coût pour Genie Search. Databricks peut toutefois mettre à jour les Tarifs de la fonctionnalité à tout moment en vous en informant et/ou en mettant à jour notre page Tarifs.