Charger un fichier dans un agent Genie

Important

Le chargement de fichiers CSV et Excel se trouve dans Public Preview. Le chargement de fichiers PDF est en version bêta.

Chargez des fichiers CSV, Excel et PDF directement dans un Agent Genie afin que les utilisateurs puissent les interroger en langage naturel en même temps que les tables de catalogue Unity. Cela est utile pour la validation rapide des données, l’analyse légère et l’utilisation de jeux de données externes sans importation ou transformation manuelle.

Note

Les agents génie étaient anciennement appelés Génie Spaces.

Overview

Le chargement de fichiers vers un agent Genie vous permet d’explorer les données dans une conversation de l’agent Genie. Vous pouvez ajouter des fichiers à des agents qui incluent également des tables de catalogue Unity, ce qui permet d’analyser les données chargées en même temps que les sources existantes. Au lieu d’importer et de transformer manuellement des jeux de données, vous pouvez faire glisser et déposer un fichier dans la conversation et commencer à l’interroger immédiatement. Cela est utile pour la validation rapide des données, l’analyse légère et l’utilisation de jeux de données externes sans configuration supplémentaire.

Pour permettre à un agent de répondre à des questions sur des fichiers non structurés stockés dans des volumes de catalogue Unity au lieu de charger un fichier dans une conversation unique, consultez Analyser les fichiers dans des volumes avec un Agent Genie.

Spécifications

  • Les agents Génie doivent être activés dans votre espace de travail. Consultez Créer et gérer un agent Génie.
  • Le paramètre d’administration de l’espace de travail Télécharger des données à l’aide de l’interface utilisateur doit être activé. Consultez Désactiver l’interface utilisateur de chargement des données.
  • Un administrateur d’espace de travail doit activer l’aperçu à partir de la page Aperçus. Utilisez le bouton bascule Génie - Charger le fichier pour gérer l’accès.
  • Pour charger des fichiers PDF (bêta), un administrateur d’espace de travail doit activer le bouton bascule Charger des fichiers PDF locaux vers Les agents Genie à partir de la page Aperçus. Les exigences supplémentaires suivantes s’appliquent :
  • Disposer au moins des autorisations CAN RUN pour l’agent Genie. Consultez les listes de contrôle d’accès de l’agent Genie.

Exigences relatives aux fichiers

Vous pouvez charger jusqu’à 25 fichiers par conversation, quel que soit le type de fichier.

Fichiers CSV et Excel

Les chargements CSV et Excel ne sont pas disponibles en mode Agent.

  • Chaque fichier doit être inférieur à 200 Mo.
  • Chaque fichier doit contenir moins de 100 colonnes.
  • Les fichiers Excel peuvent contenir plusieurs feuilles. Genie affiche des exemples de données de la première feuille par défaut, mais toutes les feuilles pouvant être analysées sont disponibles. Pour interroger une feuille spécifique, référencez-la par son nom lors de la demande de Genie.

Fichiers PDF

Important

Cette fonctionnalité est en version bêta. Les administrateurs d’espace de travail peuvent contrôler l’accès à cette fonctionnalité à partir de la page Aperçus . Consultez Gérer les préversions d’Azure Databricks.

Les chargements PDF nécessitent le mode Agent.

  • Chaque fichier PDF doit être inférieur à 20 Mo.
  • Chaque fichier PDF ne doit pas contenir plus de 20 pages.
  • Chaque fichier PDF est limité à 15 000 caractères.
  • Les fichiers PDF chargés s’appliquent uniquement à la conversation actuelle. Les nouveaux threads de conversation n’incluent pas de contexte à partir de fichiers PDF précédemment chargés.
  • Les téléchargements PDF sont disponibles uniquement via l’interface utilisateur. Les chargements de fichiers basés sur l’API ne sont pas pris en charge.

Charger un fichier

Seul l’utilisateur qui a chargé le fichier peut y accéder.

Chargez des fichiers de l’une des manières suivantes :

  • Glissez-déplacez le fichier dans la fenêtre de conversation.
  • Cliquez sur l’icône Paperclip. Pour sélectionner un fichier dans votre navigateur de fichiers.

Un Agent Génie affiche l’icône de paperclip.

Une fois le fichier chargé et traité, Genie affiche les données dans la réponse. Vous pouvez poser des questions sur le fichier chargé et toutes les autres données de l’Agent Genie.

Note

Les fichiers chargés sont stockés dans un volume managé de catalogue Unity spécifique à l’utilisateur et à l’agent. Le volume n’est pas listable et n’apparaît pas dans le navigateur de schéma. Les autorisations sur les fichiers chargés n’ont pas besoin d’être gérées manuellement. Les utilisateurs bénéficient automatiquement des privilèges USE CATALOG, USE SCHEMA, READ VOLUME et WRITE VOLUME sur leurs fichiers chargés.

Pour plus d’informations sur les volumes managés, consultez Qu’est-ce que les volumes catalogue Unity ?.

Afficher les fichiers disponibles

Pour afficher les fichiers qui ont été chargés sur l’agent, cliquez sur l’icône Paperclip. Pour ouvrir le menu fichier. Si un fichier Excel chargé comporte plusieurs feuilles, elles apparaissent sous forme de fichiers distincts dans le menu.

Ajuster les paramètres de format de fichier

Pour ajuster les paramètres de mise en forme appliqués à un fichier :

  1. Cliquez sur l’icône Paperclip. Pour ouvrir le menu fichier.
  2. Cliquez sur l’icône Clé. Icône de clé à droite du fichier.
  3. Ajustez les paramètres dans la boîte de dialogue Paramètres de format de fichier .
  4. Cliquez sur Appliquer les modifications pour afficher un aperçu de vos modifications.
  5. Cliquez sur Enregistrer pour conserver vos modifications et fermer la boîte de dialogue.

Supprimer un fichier

Pour supprimer un fichier et son enregistrement de conversation associé, supprimez la conversation.

Pour supprimer uniquement le fichier, cliquez sur l’icône Corbeille. Icône corbeille en regard du fichier dans le menu fichiers joints.

Liste de fichiers développée montrant une icône de corbeille à droite d’un nom de fichier.

Note

Si l’agent Genie est supprimé, le fichier est automatiquement supprimé du stockage managé.

Désactiver les chargements de fichiers

Un administrateur d’espace de travail peut empêcher le chargement de fichiers dans un Agent Genie. Pour ce faire, désactivez le chargement de données à l’aide de l’interface utilisateur. Consultez Désactiver l’interface utilisateur de chargement des données.

FAQ

Qui peut accéder aux fichiers chargés ?

Seul l’utilisateur qui a chargé le fichier peut y accéder.

Quelles données sont envoyées au LLM ?

Un sous-ensemble des données provenant de fichiers chargés est envoyé au modèle externe et utilisé pour améliorer la qualité de la réponse et analyser correctement les fichiers.

Pourquoi ne puis-je pas charger un fichier ?

Si vous n’avez pas au moins d’autorisations CAN RUN sur l’Agent Genie, l’option de chargement n’est pas disponible. L’administrateur de votre espace de travail peut également avoir désactivé le paramètre d’espace de travail Télécharger des données à l’aide de l’interface utilisateur ou l’aperçu Genie - Télécharger un fichier pour votre espace de travail. Consultez Désactiver l’interface utilisateur de chargement des données.