Aller au contenu principal
Dernière mise à jour le

Analysez les fichiers dans les volumes avec un Genie Agent

Un Genie Agent peut analyser les fichiers non structurés stockés dans les volumes Unity Catalog, tels que les fichiers PDF, Word, les présentations et les images. Un auteur d’agent associe des volumes à l’agent, et les utilisateurs métier posent des questions sur leur contenu ainsi que sur les données structurées de l’agent au cours d’une seule et même conversation.

info

Bêta

Cette fonctionnalité est en Bêta. Pour l'utiliser, un administrateur de workspace doit activer Analyser les fichiers dans les volumes avec des agents Genie à partir de la page Aperçus . Voir Gérer les aperçus Databricks.

remarque

Les agents Genie étaient auparavant appelés Genie space.

Ce que vous pouvez demander à un agent Genie Agent concernant vos fichiers​

En attachant des volumes à un agent, les utilisateurs professionnels peuvent combiner les données de documents tels que les tickets d'assistance, les Logs d'appels de Ventes et les fichiers de politiques avec les données des tables structurées de l'agent. Les utilisateurs peuvent ensuite répondre à des questions telles que :

  • Quels problèmes de support prennent le plus de temps à résoudre, et que disent les clients dans les demandes d’escalade ?
  • Pourquoi les opportunités de ventes tardives sont-elles bloquées et quelles sont les objections qui apparaissent le plus souvent dans les logs d'appels de ventes ?
  • Quelles régions sont sous-performantes, et quelles politiques d’escalade internes s’appliquent ?

Quand utiliser l’analyse de fichiers dans un Genie Agent​

Attach volumes to a Genie Agent when you want a specialized agent for a specific domain. Choose a different approach when your needs are broader:

  • Utilisez Genie One comme point d’entrée unifié pour toutes les questions concernant vos données structurées. Genie One peut faire appel à un Genie Agent pour répondre à des questions concernant des fichiers.
  • Créez un superviseur multi‑agents personnalisé uniquement si vous avez besoin d'un contrôle précis sur le comportement des agents, comme la sélection du modèle, la stratégie de découpage (chunking) ou l'orchestration de plusieurs sous-agents.
  • Utilisez l’ upload de fichiers pour intégrer un fichier CSV ou Excel local dans une conversation unique au lieu d’analyser des fichiers stockés dans des volumes.

Comment un agent Genie Agent analyse les fichiers​

Lorsqu’un utilisateur pose une question qui nécessite le contexte d’un volume, l’agent Genie Agent récupère le contenu de fichier le plus pertinent pour la question et l’ajoute au contexte de l’agent. L’agent raisonne ensuite sur ce contenu ainsi que sur toutes les données structurées pour générer une réponse accompagnée de citations. Ces citations peuvent pointer vers la page spécifique du fichier source (bêta).

L'analyse de fichiers ne s'exécute qu'en mode Agent, qui utilise un raisonnement multi-étapes pour récupérer et analyser les fichiers pertinents. Consultez le mode Agent.

Le Genie Agent utilise toujours les autorisations de l'utilisateur qui pose la question. Un utilisateur qui n'a pas au moins l'autorisation READ VOLUME sur un volume attaché reçoit une erreur. Les utilisateurs peuvent poser des questions sur un volume spécifique, plusieurs volumes et des données structurées dans la même conversation.

Exigences​

Les exigences suivantes s’appliquent à l’agent et à ses utilisateurs :

Attacher des volumes à un Genie Agent​

Avant de commencer, veuillez examiner les Exigences.

Pour attacher des volumes à un Genie Agent :

  1. Ouvrez le Genie Agent auquel vous souhaitez ajouter des fichiers.
  2. Ouvrez l'onglet Sources , puis cliquez sur Ajouter .
  3. Sélectionnez un ou plusieurs volumes. Le Genie Agent traite le volume entier. Vous ne pouvez pas joindre un sous-ensemble des dossiers ou des fichiers dans un volume.
  4. Ajoutez une description claire dans le champ Description . Consultez Optimiser votre agent pour les questions sur les fichiers.

Vous pouvez attacher un volume en tant que source même lorsque son catalogue n'est pas accessible depuis ce Workspace par default, comme un catalogue qui est lié à des workspaces spécifiques.

Lorsque vous attachez un volume, Databricks active automatiquement la recherche de contenu.

How content search works​

La recherche de contenu analyse et indexe vos fichiers afin que le Genie Agent puisse analyser un plus grand ensemble de fichiers, s’appuyer sur des passages spécifiques répartis dans de nombreux fichiers et répondre aux questions avec une latence réduite. Pour connaître les limites relatives aux fichiers et aux volumes, consultez la rubrique Limitations.

La recherche de contenu se synchronise automatiquement avec votre volume. Lorsque vous ajoutez, modifiez ou supprimez des fichiers, Databricks met à jour l’index pour refléter vos modifications, afin que l’agent Genie Agent analyse le contenu actuel sans aucune étape manuelle.

Optimisez votre agent pour les questions de fichiers​

Après avoir attaché vos volumes, suivez ces recommandations pour aider le Genie Agent à utiliser leur contenu :

  • Ajoutez une description claire : Décrivez le contenu du volume, son organisation et la façon dont l’agent doit l’utiliser. L’agent utilise cette description pour récupérer les fichiers pertinents.
  • Évitez le contenu dupliqué : attacher plusieurs volumes qui contiennent des informations superposées rend plus difficile pour l’agent de récupérer les documents pertinents. Il en va de même pour les fichiers individuels au sein d'un volume.
  • Évitez les fichiers non pertinents : Incluez uniquement les fichiers pertinents pour le domaine de l’agent. Les fichiers non pertinents peuvent perturber l’agent.
  • Utilisez des noms de fichiers clairs : Utilisez des noms de fichiers descriptifs afin que l’agent puisse distinguer les fichiers.

Posez des questions sur les fichiers​

Pour poser des questions sur les fichiers dans un Genie Agent :

  1. Ouvrez un Genie Agent auquel des volumes sont attachés.
  2. Activez le mode Agent dans la boîte de discussion. Vous devez utiliser le mode Agent pour répondre aux questions concernant les fichiers.
  3. Saisissez une question et envoyez votre invite. Le mode Agent récupère le contexte à partir du volume pertinent, puis génère une réponse une fois l’analyse terminée.

Régions prises en charge pour la recherche de contenu​

La recherche de contenu est disponible dans les régions répertoriées dans cette section.

Dans certaines régions, la recherche de contenu ne s’exécute que si un administrateur de compte active le traitement inter-Geo, ce qui permet à Databricks de traiter vos fichiers en dehors du Geo de votre workspace. Voir Activer le traitement inter-Geo.

Regions that don't require cross-Geo processing​

La recherche de contenu s’exécute dans la région de votre Workspace pour les régions suivantes :

  • Asie-Pacifique (Sydney)
  • Asie-Pacifique (Tokyo)
  • UE (Francfort)
  • UE (Irlande)
  • UE (Londres)
  • États-Unis – Est (Virginie du Nord)
  • États-Unis – Est (Ohio)
  • États-Unis – Ouest (Oregon)

Regions that require cross-Geo processing​

For the following regions, an account admin must enable cross-Geo processing before content search runs:

  • Asie-Pacifique (Mumbai)
  • Asie-Pacifique (Singapour)
  • Canada (Centre)
  • Amérique du Sud (São Paulo)

Limitations​

Les limitations suivantes s’appliquent :

  • Vous pouvez attacher un maximum de 10 volumes à un Genie Agent.

  • Pour utiliser du contenu provenant de sources externes telles que Google Drive ou SharePoint, attachez plutôt des connecteurs MCP. Consultez la page Connecter un Genie Agent à des outils et sources externes.

  • Chaque utilisateur de l’agent doit disposer à la fois du droit Workspace access et du droit Databricks SQL access . Voir Droits d’accès.

  • During the Beta, account-only users can't use this feature. See Account-only user access to Genie One.

  • Cette fonctionnalité n'est pas disponible sur AWS GovCloud.

  • Seuls les volumes gérés par Unity Catalog prennent en charge la recherche de contenu. Les volumes externes et les volumes Mes fichiers ne sont pas pris en charge. Voir Stocker des fichiers dans Mes fichiers.

  • Chaque workspace peut comporter jusqu’à 250 volumes associés à des Genie Agents.

  • Chaque volume indexé peut contenir jusqu’à 10 000 fichiers.

  • La recherche de contenu ignore les fichiers de plus de 100 Mo et les fichiers comptant plus de 500 pages.

  • La recherche de contenu prend en charge les fichiers PDF, JPG, JPEG, PNG, TIFF, TIF, DOC, DOCX, PPT, PPTX, MD ou TXT. Tous les autres types de fichiers sont ignorés.

Questions fréquemment posées​

Les questions suivantes couvrent les sujets courants pour l'analyse des fichiers dans les volumes.

Comment cette fonctionnalité est-elle facturée ?​

Databricks charges for the following:

  • Preparing files : When Databricks enables content search or syncs a volume, it parses your files with the ai_parse_document AI function, which is billed under AI Functions Tarifs.
  • Answering questions : The agent's reasoning over your files is billed as part of standard Genie usage. See Genie Tarifs.

Puis-je analyser des fichiers dans des volumes via l'API ?​

Oui. Vous pouvez analyser des fichiers dans des volumes via les APIs du mode Agent. Consultez la référence de l’API du mode Agent.

Ressources supplémentaires​

Voir les ressources suivantes pour des informations connexes :

Sur cette page