Analysez les fichiers dans les volumes avec un Genie Agent
Un Genie Agent peut analyser les fichiers non structurés stockés dans des volumes Unity Catalog, tels que des PDF, des documents Word, des présentations et des images. Un auteur d’agent joint jusqu’à 10 volumes, et les utilisateurs métier posent des questions sur leur contenu parallèlement aux données structurées de l’agent dans une seule conversation.
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.
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 ?
Pour intégrer un fichier CSV ou Excel local dans une seule conversation au lieu d’analyser les fichiers stockés dans des volumes, consultez Upload un fichier vers un Genie Agent.
Comment un agent Genie Agent analyse les fichiers
Lorsqu’un utilisateur pose une question nécessitant un contexte provenant d’un volume, le 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 avec des citations.
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 :
- Unity Catalog activé dans votre Workspace.
- Le mode Agent est disponible dans votre région. Voir Disponibilité régionale.
- Un Genie Agent bien préparé avec des instructions claires et des métadonnées de table. Voir Organiser un Genie Agent efficace.
- Un ou plusieurs volumes Unity Catalog qui contiennent des fichiers pertinents.
- Les droits d'accès **Accès au Workspace** et **Accès Databricks SQL** pour chaque utilisateur de l'agent. Les utilisateurs peuvent utiliser le reste de Genie sans **Accès au Workspace**, mais cette fonctionnalité requiert les deux. Consultez Gérer les droits.
- Au minimum
READ VOLUMEautorisation sur les volumes attachés pour chaque utilisateur de l'agent.
Attacher des volumes à un Genie Agent
Avant de commencer, veuillez examiner les Exigences.
Pour attacher des volumes à un Genie Agent :
- Ouvrez le Genie Agent auquel vous souhaitez ajouter des fichiers.
- Ouvrez l'onglet Sources , puis cliquez sur Ajouter .
- 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.
- Ajoutez une description claire dans le champ Description . Consultez Optimiser votre agent pour les questions sur les fichiers.
- Vous pouvez, si vous le souhaitez, activer la recherche de contenu pour les volumes que vous avez joints. Consultez Activer la recherche de contenu pour les volumes attachés.
Activer la recherche de contenu pour les volumes attachés
Databricks recommande d'activer la recherche de contenu pour les volumes que vous attachez. La recherche de contenu prépare et indexe vos fichiers afin que le Genie Agent puisse les utiliser plus efficacement, ce qui améliore sa capacité à raisonner sur un ensemble de fichiers plus vaste et à répondre aux questions avec une latence réduite. Un volume indexé peut contenir jusqu’à 10 000 fichiers de 50 Mo chacun au maximum. Consultez Recherche de contenu pour les volumes Unity Catalog.
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 :
- Ouvrez un Genie Agent auquel des volumes sont attachés.
- Activez le mode Agent dans la boîte de discussion. Vous devez utiliser le mode Agent pour répondre aux questions concernant les fichiers.
- 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.
Limitations
Les limitations suivantes s’appliquent :
- Vous pouvez attacher un maximum de 10 volumes à un Genie Agent.
- Cette fonctionnalité n'est pas disponible sur AWS GovCloud.
- Les utilisateurs avec accès consommateur uniquement, Databricks SQL uniquement et compte uniquement ne peuvent pas utiliser cette fonctionnalité. Chaque utilisateur de l'agent doit disposer des droits « Accès au Workspace » et « Accès Databricks SQL ».
- Sur les volumes pour lesquels la recherche de contenu n’est pas activée, un Genie Agent peut récupérer du contexte à partir de 5 fichiers maximum par question. Consultez Limitations for volumes without content search.
- Le Genie Agent ne peut pas analyser les fichiers externes, tels que les fichiers dans Google Drive ou SharePoint.
- Les outils de recherche web ne sont pas disponibles.
Limitations pour les volumes sans recherche de contenu
Databricks recommande d’activer la recherche de contenu sur les volumes que vous attachez. Si vous n’activez pas la recherche de contenu pour un volume attaché, un Genie Agent peut récupérer le contexte à partir de 5 fichiers maximum par question. De plus, les limites suivantes s’appliquent aux fichiers qu’il peut lire :
Propriété | Limite |
|---|---|
Nombre total de fichiers par volume | Jusqu’à 500 fichiers. Les fichiers TXT et MD ne sont pas comptabilisés dans cette limite. Les questions adressées à des volumes contenant plus de 500 fichiers renvoient une erreur. |
Types de fichiers pris en charge | PDF, JPG, JPEG, PNG, TIFF, TIF, DOC, DOCX, PPT ou PPTX |
Taille maximale du fichier | Jusqu’à 10 Mo |
L’agent Genie Agent ignore les types de fichiers non pris en charge et les fichiers qui dépassent la taille maximale autorisée. Il continue de répondre aux questions en utilisant les autres fichiers pris en charge dans le volume.
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 ?
La facturation dépend de l’activation ou non de la recherche de contenu sur le volume associé. Dans les deux cas, l’agent raisonne sur le contenu récupéré, qui est facturé dans le cadre de l’utilisation standard de Genie. Voir les tarifs de Genie.
- Volumes sans recherche de contenu : pendant la version bêta, les utilisateurs sont facturés uniquement pour le raisonnement de l'agent sur le contenu récupéré.
- Volumes avec recherche de contenu : l'agent interroge l'index existant au lieu d'analyser les fichiers au moment de la query, de sorte qu'aucun coût de Foundation Model Serving ne s'applique à la récupération. Des coûts d'ingestion et de service de query s'appliquent à la place. Voir Comment la recherche de contenu est facturée.
Quand dois-je utiliser cette fonctionnalité plutôt qu’un Superviseur multi-agents ?
Attachez des volumes à un Genie Agent lorsque vous souhaitez qu’un agent réponde à des questions sur des données structurées et non structurées au sein d’un domaine spécifique. Créez un agent superviseur personnalisé uniquement lorsque vous avez besoin d’un contrôle précis sur le comportement de l’agent, tel que la sélection du modèle, la stratégie de découpage ou l’orchestration de plusieurs sous-agents.
Quand dois-je utiliser cette fonctionnalité au lieu de Genie One ?
Attachez des volumes à un Genie Agent lorsque vous souhaitez créer un agent spécialisé qui répond à des questions dans un domaine spécifique. 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 sur les fichiers.
Puis-je analyser des fichiers dans des volumes via l'API ?
Oui. Vous pouvez analyser les fichiers dans les volumes via les APIs en mode Agent. Consultez les APIs en mode Agent dans les Agents Genie.
Ressources supplémentaires
Voir les ressources suivantes pour des informations connexes :