Aller au contenu principal
Dernière mise à jour le

Créer une salle blanche Genie

info

Bêta

Cette fonctionnalité est en bêta. Les administrateurs de compte peuvent gérer l'accès à cette fonctionnalité à partir de la page Aperçus de la console du compte. Consultez Gérer les aperçus au niveau du compte.

Une salle blanche Genie permet à un fournisseur de données de partager un agent Genie Agent avec un destinataire dans une autre organisation. Le destinataire pose des questions à l’agent en langage naturel et obtient des réponses basées sur les données du fournisseur, sans voir les instructions de l’agent ni les données brutes.

Pour en savoir plus sur les agents Genie, consultez Genie Agents. Pour une présentation des clean rooms, consultez What is Databricks Clean Rooms?.

Pourquoi utiliser une Clean Room Genie ?​

Partagez vos Genie Agents sélectionnés en toute sécurité avec vos clients, sans leur permettre d’accéder aux données sous-jacentes, au contexte ou à la propriété intellectuelle propriétaire :

  • Partagez des agents, pas des données : les clients peuvent utiliser vos agents sans voir les données et le contexte sous-jacents.
  • Combiner les datasets : les clients peuvent importer leurs propres données et obtenir des insights de la combinaison des deux datasets.
  • Gérer l’utilisation : définissez une limite de demandes quotidienne. Les clients ne peuvent pas download en masse les sorties de l’agent.

Fonctionnement des salles propres Genie​

Lorsque vous créez la salle blanche, Databricks partage votre Genie Agent et toutes ses instructions dans la salle blanche centrale, ainsi que les tables, les vues et les volumes auxquels l’agent fait référence. Le destinataire discute avec l’agent depuis la tab Chat sur la page des détails de la salle blanche. Les queries s’exécutent dans la salle blanche centrale, et non dans le workspace de l’un ou l’autre des collaborateurs.

Le tableau suivant compare ce que chaque collaborateur peut faire dans une salle blanche Genie :

Compétence

Fournisseur

Destinataire

Attacher et synchroniser l’agent Genie Agent

Oui

Non

Définir la limite quotidienne de prompts

Oui

Non

Afficher les instructions et les exemples de l’agent

Oui

Non

Ajouter des assets de données

Non (les données ne peuvent pas être ajoutées via la clean room, uniquement via l’agent Genie Agent)

Oui

Poser des questions à l’agent

Non

Oui

Compétence

Fournisseur

Destinataire

Attacher et synchroniser l’agent Genie Agent

Oui

Non

Définir la limite quotidienne de prompts

Oui

Non

Afficher les instructions et les exemples de l’agent

Oui

Non

Ajouter des assets de données

Non (les données ne peuvent pas être ajoutées via la clean room, uniquement via l’agent Genie Agent)

Oui

Poser des questions à l’agent

Non

Oui

Le destinataire peut afficher les noms des tables et les métadonnées des colonnes du fournisseur. L’interface utilisateur de la clean room ne montre pas au destinataire les valeurs d’exemple ou le contenu des tables, mais il est possible que l’agent retourne des valeurs au niveau de la ligne si le destinataire les demande. Tous les download sont désactivés, le destinataire ne peut donc pas exporter en masse les sorties de l’agent. Le fournisseur ne peut voir aucun asset de données que le destinataire ajoute, y compris leurs noms.

Le fournisseur visualise les instructions et les exemples de l’agent sous Instructions Genie Agent dans le Vue d’ensemble tab de la Clean Room. Le destinataire voit une notification indiquant que les instructions sont masquées et ne peut pas ajouter les siennes.

Si le fournisseur met à jour le Genie Agent dans son Workspace, le destinataire ne verra pas les modifications tant que le fournisseur ne les aura pas synchronisées. Voir Synchroniser les modifications apportées au Genie Agent.

Contrairement à une clean room package, dans laquelle un consommateur exécute les Notebooks ou les fichiers JAR du fournisseur, une Genie Clean Room n’exécute aucun Notebook ni fichier JAR.

Conditions requises​

  • Votre workspace répond aux exigences des espaces de données nettoyées. Consultez Configuration requise.

  • Un administrateur de compte pour le fournisseur et le destinataire a activé l’aperçu Genie Clean Room depuis la page Aperçus de la console de compte. Voir Gérer les aperçus au niveau du compte.

  • Pour créer la salle blanche, le fournisseur doit disposer des éléments suivants :

    • Le privilège CREATE CLEAN ROOM sur le metastore.
    • Autorisation CAN EDIT sur le Genie Agent qu'ils souhaitent partager.
    • SELECT sur chaque table et vue de métrique, et READ VOLUME sur chaque volume, auxquels l’agent Genie Agent fait référence.
    • USE CATALOG et USE SCHEMA sur les catalogues et les schémas qui contiennent ces assets.
    • Identifiant de partage de la salle blanche du destinataire. Voir Étape 1. Demander l’identifiant de partage du collaborateur.

  • Pour ajouter leurs propres données à la salle blanche, le destinataire doit être le propriétaire de la salle blanche ou disposer du privilège MODIFY CLEAN ROOM sur celle-ci, et doit disposer de SELECT sur toute table ou vue et de READ VOLUME sur tout volume qu’il ajoute, ainsi que de USE CATALOG et USE SCHEMA sur les catalogues et schémas qui les contiennent.

  • Pour poser des questions à l’agent, le destinataire doit disposer du privilège EXECUTE CLEAN ROOM TASK sur la clean room.

Bonnes pratiques​

Databricks recommande les éléments suivants lors de la création d’une Genie Clean Room Databricks :

  • Terminez la curation avant de partager : vérifiez les instructions et les exemples de l’agent dans votre workspace avant de créer la clean room, car l’expérience du destinataire en dépend.
  • Maintenez l'agent ciblé : Ne faites référence qu'aux tables, vues et volumes dont le destinataire a besoin et maintenez l'agent dans la limite de taille. Voir Limitations.
  • start avec une limite de prompt prudente : pour un essai ou une évaluation, définissez une limite quotidienne basse et augmentez-la plus tard.
  • Synchronisez après chaque changement : Les modifications que vous apportez à l'agent dans votre workspace n'atteignent la clean room que lorsque vous les synchronisez.

Créer une salle blanche Genie​

Effectuez les étapes suivantes en tant que fournisseur.

Obtenir l'identifiant de partage du destinataire​

Demandez au destinataire son identifiant de partage de la salle blanche. Il peut le trouver en suivant les instructions de Trouver votre identifiant de partage.

Créer la salle blanche​

  1. Dans votre Databricks workspace, cliquez sur Icône Données. Catalog .

  2. Cliquez sur le bouton Salles blanches > .

  3. Cliquez sur Créer une salle blanche .

  4. Sous Clean room type (Type de Clean Room), sélectionnez Genie Clean Room .

  5. Dans Nom de la clean room , saisissez un nom pour la clean room.

    Le nom ne peut pas utiliser d’espaces, de points ou de barres obliques (/), et vous ne pouvez pas le modifier après avoir créé la salle blanche.

  6. Dans Région , sélectionnez le cloud et la région de la salle blanche centrale. Voir Disponibilité régionale.

  7. Dans Identifiant de partage de Clean Room , saisissez l’identifiant de partage du destinataire.

    Vous ne pouvez pas changer de collaborateurs après la création de la clean room.

  8. Sous Genie Agent , recherchez et sélectionnez le Genie Agent à partager. Vous ne pouvez pas le remplacer par un agent différent par la suite.

  9. Cliquez sur Créer une salle blanche .

Définir la limite quotidienne de prompts​

  1. Sur la page de détails de la clean room, cliquez sur le tab Contrôles de sortie .
  2. Dans Prompts autorisés par jour , saisissez le nombre maximal de prompts que le destinataire peut envoyer par jour.
  3. Cliquez sur Enregistrer .

Chaque message envoyé par le destinataire et chaque réponse qu’il régénère compte pour une invite. Le compteur est Reset à minuit UTC. Le destinataire peut voir la limite sous son tab Contrôles de sortie , mais ne peut pas la modifier.

Synchroniser les modifications apportées à l’Genie Agent​

Lorsque vous modifiez l’agent Genie Agent dans votre workspace, synchronisez la clean room pour partager les modifications avec le destinataire. La synchronisation met à jour les instructions, les exemples et les tables, vues et volumes référencés de l’agent dans la clean room. Cela ne modifie pas et ne supprime pas les assets de données ajoutés par le destinataire.

  1. Sur la page des détails de la salle blanche, cliquez sur le Vue d’ensemble tab.
  2. Dans la section Genie Agent du volet droit, cliquez sur Synchroniser Genie Agent .

Utiliser un espace de données nettoyées Genie​

En tant que destinataire, effectuez les étapes suivantes.

Ouvrir l’espace de données nettoyées​

  1. Dans votre Databricks workspace, cliquez sur Icône Données. Catalog .
  2. Cliquez sur le bouton Salles blanches > .
  3. Cliquez sur le nom de l’espace protégé que le fournisseur a partagé avec vous.

La clean room s’ouvre sur le tab Chat , où vous discutez avec l’agent Genie Agent du fournisseur. Pour afficher les noms des tables du fournisseur, cliquez sur le tab Vue d’ensemble .

Ajoutez vos propres données (facultatif)​

Pour permettre à l’agent de combiner vos données avec celles du fournisseur, ajoutez vos tables, vues, vues de métriques, tables de streaming, tables externes ou volumes Unity Catalog à la clean room. L’agent peut query vos données avec les données du fournisseur. Le fournisseur ne peut pas voir les assets que vous ajoutez, y compris leurs noms.

  1. Sur la page des détails de la salle blanche, cliquez sur le Vue d’ensemble tab.
  2. Cliquez sur Ajouter des assets de données .
  3. Sélectionnez les assets de données à ajouter, examinez leurs alias et cliquez sur Enregistrer .

Pour plus de détails sur la sélection d'assets et d'alias, consultez Étape 3. Ajouter des assets de données et des notebooks à la clean room. Pour les autorisations dont vous avez besoin, consultez Conditions requises. Vous ne pouvez pas ajouter de notebooks, de fichiers JAR ou de modèles à une Genie Clean Room.

Posez des questions​

Dans le Chat tab, saisissez une question en langage naturel ou cliquez sur l’une des questions suggérées. L'agent répond à l'aide des instructions du fournisseur et des données contenues dans l'espace de données nettoyées. Pour afficher les conversations passées, cliquez sur l’icône d’historique.

Le coin supérieur droit du chat indique le nombre d’invites qu’il vous reste aujourd’hui, sur la limite quotidienne du fournisseur. Si vous atteignez la limite quotidienne d’invites du fournisseur, le chat affiche le message suivant jusqu’à minuit UTC :

Text
You've reached this Genie clean room's limit of {limit} prompts per day. Please wait until the next UTC day before asking another question.

Limitations​

  • Un espace de données nettoyées Genie comporte exactement deux collaborateurs : le fournisseur et un destinataire. Le collaborateur qui crée l’espace de données nettoyées est le fournisseur.

  • Une « clean room » ne peut avoir qu’un seul agent Genie Agent et vous ne pouvez pas le remplacer par un autre agent.

  • Genie Clean Rooms prennent uniquement en charge le mode chat. Le mode Agent n'est pas pris en charge.

  • Vous ne pouvez pas ajouter ou synchroniser un agent Genie Agent qui fait référence aux éléments suivants : L’agent peut utiliser ces sources dans votre workspace, mais elles ne peuvent pas être partagées dans une clean room :

    • Tables dans les catalogs system ou samples.
    • Tables dans un schéma information_schema.
    • Tables que vous avez reçues via OpenSharing, y compris les tables de Databricks Marketplace.

  • Les tables auxquelles l’agent Genie Agent fait référence à partir de différents catalogues ne peuvent pas partager le même nom schema.table.

  • Le fournisseur ne peut pas voir les conversations du destinataire.

  • Les destinataires ne peuvent pas upload de fichiers dans la discussion de salle blanche.

  • Les destinataires ne peuvent pas ajouter leurs propres instructions au Genie Agent.

  • Si la définition du Genie Agent fait plus de 262 000 octets lorsqu’elle est compressée, la salle blanche ne peut pas la partager. Réduisez le nombre d’instructions ou d’exemples de queries.

  • Un agent Genie Agent créé à partir d’une intégration, telle que Catalog Explorer, ne peut pas être partagé dans une salle blanche.

  • Les réponses en langage naturel peuvent toujours révéler des informations sur les données du fournisseur. Databricks n'applique pas de threshold d'agrégation ni ne limite la taille des réponses dans Genie Clean Rooms.

  • Les prompts et les conversations du destinataire ne sont pas enregistrés dans la table système des événements de clean room ni dans les logs d'audit. Lorsque le fournisseur attache ou synchronise l'agent ou modifie la limite de prompt, les logs d'audit enregistrent les événements createCleanRoomAsset ou updateCleanRoomAsset. Voir Événements de Clean Rooms.

Ressources supplémentaires​

Sur cette page