Cargar un archivo en un agente Genie

Importante

La carga de archivos CSV y Excel se encuentra en Public Preview. La carga de archivos PDF está en beta.

Cargue archivos CSV, Excel y PDF directamente en un agente de Genie para que los usuarios puedan consultarlos en lenguaje natural junto con las tablas del catálogo de Unity. Esto resulta útil para la validación rápida de datos, el análisis ligero y el trabajo con conjuntos de datos externos sin importación o transformación manual.

Note

Genie Agents se conocía anteriormente como Genie Spaces.

Overview

Subir archivos a un Genie Agent le permite explorar datos en una conversación con un Genie Agent. Puede agregar archivos a agentes que también incluyan tablas de Catálogo de Unity, lo que permite analizar los datos cargados junto con los orígenes existentes. En lugar de importar y transformar manualmente conjuntos de datos, puede arrastrar y colocar un archivo en el chat y empezar a consultarlo inmediatamente. Esto resulta útil para la validación rápida de datos, el análisis ligero y el trabajo con conjuntos de datos externos sin configuración adicional.

Para permitir que un agente responda preguntas sobre los archivos no estructurados almacenados en volúmenes del catálogo de Unity en lugar de cargar un archivo en una sola conversación, consulte Análisis de archivos en volúmenes con un agente de Genie.

Requisitos

  • Los agentes de Genie deben estar habilitados en el área de trabajo. Consulte Creación y administración de un agente de Genie.
  • La configuración de administrador del espacio de trabajo Cargar datos mediante la interfaz de usuario debe estar habilitada. Consulte Deshabilitar la interfaz de usuario de carga de datos.
  • Un administrador del área de trabajo debe habilitar la vista previa desde la página Vistas previas. Utilice el Genie - Upload File para administrar el acceso.
  • Para cargar archivos PDF (beta), un administrador del área de trabajo debe habilitar la opción Cargar archivos PDF locales en Genie Agents en la página Vista previa. Se aplican los siguientes requisitos adicionales:
    • Las funciones de IA desarrolladas por socios deben estar habilitadas. Consulte funcionalidades de IA impulsadas por socios.
    • Las cargas en PDF no se admiten en las áreas de trabajo del perfil de seguridad de cumplimiento.
  • Como mínimo, permisos CAN RUN en el agente Genie. Consulte ACL del agente Genie.

Requisitos de archivos

Puede cargar hasta 25 archivos por conversación, independientemente del tipo de archivo.

Archivos CSV y Excel

Las cargas CSV y Excel no están disponibles en modo de agente.

  • Cada archivo debe ser inferior a 200 MB.
  • Cada archivo debe contener menos de 100 columnas.
  • Los archivos de Excel pueden contener varias hojas. Genie muestra datos de ejemplo de la primera hoja de forma predeterminada, pero todas las hojas que se pueden analizar están disponibles. Para consultar una hoja específica, haga referencia a ella por nombre al preguntar a Genie.

Archivos PDF

Importante

Esta característica se encuentra en su versión beta. Los administradores del área de trabajo pueden controlar el acceso a esta característica desde la página Vistas previas . Consulte Administrar versiones preliminares de Azure Databricks.

Las cargas en PDF requieren el modo agente.

  • Cada PDF debe ser inferior a 20 MB.
  • Cada PDF no debe contener más de 20 páginas.
  • Cada PDF está limitado a 15 000 caracteres.
  • Los ARCHIVOS PDF cargados solo se aplican a la conversación actual. Los nuevos subprocesos de chat no incluyen contexto de archivos PDF cargados previamente.
  • Las cargas en PDF solo están disponibles a través de la interfaz de usuario. No se admiten cargas de archivos basadas en API.

Carga de un archivo

Solo el usuario que cargó el archivo puede acceder a él.

Cargue archivos de una de las maneras siguientes:

  • Arrastre y coloque el archivo en la ventana de chat.
  • Haga clic en el icono paperclip. para seleccionar un archivo en el explorador de archivos.

Un agente de Genie muestra el icono de paperclip.

Subir un archivo ya no envía un mensaje automáticamente. Puedes añadir un prompt para enviar con el archivo, o subir el archivo y luego hacer preguntas sobre él. Una vez cargado y procesado el archivo, Genie muestra los datos en la respuesta. Puede hacer preguntas sobre el archivo cargado y cualquier otro dato del agente de Genie.

Note

Los archivos cargados se almacenan en un volumen administrado de Unity Catalog específico para cada usuario y agente. El volumen no se puede enumerar y no aparece en el explorador de esquemas. No es necesario administrar manualmente los permisos en los archivos cargados. A los usuarios se les conceden automáticamente los privilegios USE CATALOG, USE SCHEMA, READ VOLUME y WRITE VOLUME en sus archivos cargados.

Azure Databricks almacena archivos cargados en almacenamiento raíz gestionado por el cliente en espacios de trabajo clásicos y en almacenamiento predeterminado en espacios de trabajo sin servidor.

Para obtener más información sobre los volúmenes administrados, consulte ¿Qué son los volúmenes del catálogo de Unity?.

Visualización de archivos disponibles

Para ver los archivos cargados en el agente, haga clic en el icono paperclip para abrir el menú archivo. Si un archivo Excel cargado tiene varias hojas, aparecen como archivos independientes en el menú.

Ajustar la configuración del formato de archivo

Para ajustar la configuración de formato aplicada a un archivo:

  1. Haga clic en el icono paperclip. Para abrir el menú archivo.
  2. Haga clic en Icono de llave. El icono de llave a la derecha del archivo.
  3. Ajuste la configuración en el cuadro de diálogo Configuración de formato de archivo .
  4. Haga clic en Aplicar cambios para obtener una vista previa de los cambios.
  5. Haga clic en Guardar para mantener los cambios y cerrar el cuadro de diálogo.

Quitar un archivo

Los archivos subidos a un Agente Genie no tienen un periodo fijo de retención. Permanecen disponibles hasta que ocurra una de las siguientes situaciones:

  • El usuario elimina el archivo haciendo clic en el icono de la papelera. El icono de la papelera junto al archivo está en el menú de archivos adjuntos.
  • La conversación se elimina.
  • El Agente Genio es eliminado. Los archivos se eliminan automáticamente del almacenamiento gestionado cuando se elimina el agente.

Una lista de archivos expandida que muestra un icono de papelera a la derecha de un nombre de archivo.

Deshabilitar subidas de archivos

Un administrador del área de trabajo puede impedir la capacidad de cargar archivos en un agente de Genie. Para ello, desactive Cargar datos mediante la interfaz de usuario. Consulte Deshabilitar la interfaz de usuario de carga de datos.

FAQ

¿Quién puede acceder a los archivos cargados?

Solo el usuario que cargó el archivo puede acceder a él.

¿Qué datos se envían al LLM?

Un subconjunto de los datos de los archivos cargados se envía al modelo externo y se usa para mejorar la calidad de la respuesta y analizar correctamente los archivos.

¿Por qué no puedo cargar un archivo?

Si no tiene al menos permisos CAN RUN en el agente de Genie, la opción de carga no está disponible. Es posible que el administrador de su área de trabajo también haya desactivado la configuración del área de trabajo Cargar datos mediante la interfaz de usuario o la vista previa Genie - Upload File para su área de trabajo. Consulte Deshabilitar la interfaz de usuario de carga de datos.