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 PDF, les documents Word, les présentations et les images. Un auteur d'agent attache un ou plusieurs volumes, et les utilisateurs professionnels 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.
Présentation
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 cela fonctionne
Lorsqu'un utilisateur pose une question qui nécessite le contexte d'un volume, le Genie Agent récupère les fichiers les plus pertinents pour la question, les analyse et ajoute leur contenu au contexte de l'agent. L'agent raisonne ensuite sur ce contenu, ainsi que sur toutes les données structurées, afin de 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
Avant d’attacher des volumes, confirmez que vous remplissez les exigences de cette section.
Exigences générales
Les exigences suivantes s’appliquent à l’agent et à ses utilisateurs :
- Unity Catalog activé dans votre Workspace.
- AI Gateway (Bêta) activée.
- 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.
Exigences relatives aux volumes
Les limites suivantes s'appliquent aux volumes et fichiers que vous joignez :
- Vous pouvez attacher un maximum de 10 volumes à un Genie Agent.
- Chaque volume peut contenir jusqu'à 500 fichiers au total. Les fichiers TXT et MD ne sont pas pris en compte dans cette limite. Les questions concernant les volumes contenant plus de 500 fichiers renverront une erreur.
- Les fichiers doivent être de l'un des types suivants : PDF, JPG, JPEG, PNG, TIFF, TIF, DOC, DOCX, PPT ou PPTX. Le Genie Agent ignore les types de fichiers non pris en charge.
- Genie Agent ignore les fichiers de plus de 10 Mo et continue de répondre aux questions en utilisant les autres fichiers pris en charge dans le volume.
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.
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.
Limitez vos questions à un petit nombre de fichiers. Pendant la version bêta, un Genie Agent peut récupérer le contexte de 5 fichiers maximum par question. Pour obtenir une réponse précise, posez des questions auxquelles un petit ensemble de fichiers pertinents peut répondre.
Fonctionne bien | Ne fonctionne pas bien |
|---|---|
« Quelles ont été les principales conclusions des rapports financiers des T1 et T2 ? » | « Résumez les insights clients sur les 500 fichiers de ce volume. » |
« Comparez les détails des tarifs dans ces deux contrats. » | « Recherchez chaque mention de l'attrition des clients dans tous les rapports de gains/pertes. » |
Limitations
Les limitations suivantes s’appliquent pendant la version Bêta :
- 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 ».
- Un Genie Agent peut récupérer le contexte à partir de 5 fichiers maximum par question.
- 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.
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 ?
Lorsqu'un utilisateur pose une question, l'agent Genie Agent récupère et traite d'abord les fichiers pertinents. Ceci génère des coûts Foundation Model Serving (facturés au jeton), facturés sous la SKU Inférence en temps réel Serverless. Voir Tarifs du Model Serving de fondation. L'agent raisonne ensuite sur le contenu récupéré, ce qui est facturé dans le cadre de l'utilisation standard de Genie. Voir Tarifs de Genie.
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 :