Consulte Trabajar con un espacio de AI/BI Genie

Información general

Expertos en dominios, como analistas de datos, configuran espacios de Genie con conjuntos de datos, consultas de ejemplo y directrices de texto para ayudar a Genie a traducir preguntas empresariales en consultas analíticas. Después de la configuración, los usuarios empresariales pueden formular preguntas y generar visualizaciones para comprender los datos operativos. Puede actualizar continuamente el conocimiento semántico de Genie a medida que cambian los datos y los usuarios plantean nuevas preguntas. Para obtener información general sobre DatabricksIQ, vea Características con tecnología de DatabricksIQ.

AI/BI Genie selecciona nombres y descripciones relevantes de tablas y columnas anotadas para convertir preguntas de lenguaje natural en una consulta SQL equivalente. Después, responde con la consulta generada y la tabla de resultados, si es posible. Si Genie no puede generar una respuesta, puede formular preguntas de seguimiento como aclaración a medida que intenta proporcionar una respuesta.

Casos de uso de ejemplo

Puede crear diferentes espacios de Genie para servir una variedad de audiencias no técnicas. En los escenarios siguientes se describen dos posibles casos de uso.

Ejemplo 1: Visualización del estado de oportunidad

Un administrador de ventas quiere obtener el estado actual de las oportunidades abiertas y cerradas por fase en su canalización de ventas. Pueden interactuar con el espacio de Genie mediante lenguaje natural y generar automáticamente una visualización.

El gif siguiente muestra esta interacción:

Ejemplo 2: Seguimiento de la logística

Una empresa logística quiere usar espacios de Genie para ayudar a los usuarios empresariales de diferentes departamentos a realizar un seguimiento de los detalles operativos y financieros. Configuran un espacio de Genie para que sus gerentes de instalaciones de envío realicen un seguimiento de los envíos y otro para que sus ejecutivos financieros comprendan su salud financiera.

Requisitos técnicos y límites

Se aplican los siguientes requisitos y límites al usar espacios de Genie:

• Catálogo de Unity: los datos del espacio de Genie deben registrarse en el catálogo de Unity.
• Proceso: debe usar una instancia de SQL Warehouse profesional o sin servidor.
• Capacidad del área de trabajo: cada área de trabajo puede tener hasta 1000 espacios de Genie.

Permisos necesarios

Se requieren los permisos siguientes para crear, editar y usar espacios de Genie:

• Permisos de proceso: creadores, editores y usuarios de espacio Genie requieren acceso CAN USE al almacén de SQL predeterminado designado para el espacio. Los creadores seleccionan el almacén de SQL predeterminado cuando crean un espacio. Pueden seleccionar cualquier almacén de SQL para el que tenga permisos CAN RUN.
• Permisos de acceso a datos: cualquier usuario que interactúe con el espacio necesita al menos privilegios SELECT en los datos usados en un espacio.
• Permisos de espacio de Genie: los usuarios necesitan permisos CAN RUN en el espacio de Genie para interactuar con Genie y los datos usados en el espacio. Consulte ACL de espacios de Genie para obtener una asignación completa de privilegios y capacidades para un espacio de Genie.

Habilitación de espacios de Genie en el área de trabajo

Genie usa características de inteligencia artificial con tecnología de Azure que deben estar habilitadas en el nivel de cuenta y en el área de trabajo donde se crean los espacios de Genie. Para habilitar espacios de Genie, compruebe cada una de las siguientes opciones de configuración.

• Las características con tecnología de Servicios de Azure AI deben estar habilitadas en el nivel de cuenta. Un administrador de cuenta puede habilitar esta característica mediante los pasos siguientes:
  1. En la barra lateral de la consola de la cuenta, haga clic en Configuración.
  2. Haga clic en la pestaña Habilitación de funcionalidades.
  3. Active la opción Habilitar características con tecnología de Servicios de Azure AI.

Las características con tecnología de Servicios de Azure AI deben estar habilitadas en el nivel de cuenta para poder habilitarlas en el nivel de área de trabajo.

• Las características con tecnología de Servicios de Azure AI deben estar habilitadas para el área de trabajo. Un administrador del área de trabajo puede habilitar esta característica mediante los pasos siguientes:

  1. Iniciar sesión en el área de trabajo.
  2. Haga clic en su nombre de usuario en la barra superior del área de trabajo de Azure Databricks y seleccione Configuración.
  3. Haga clic en la pestaña Avanzadas y desplácese hacia abajo hasta la sección Otros.
  4. Active la opción Características con tecnología de Servicios de Azure AI.

• Genie debe estar habilitado desde la página Versiones preliminares del área de trabajo. Un administrador del área de trabajo puede habilitar esta versión preliminar. Consulte Administración de las versiones preliminares de Azure Databricks.

  

Creación de un nuevo espacio de Genie

Cuando los espacios de Genie están habilitados en un área de trabajo, los analistas de datos pueden preparar una experiencia espacial de Genie específica del dominio para los usuarios profesionales completando los pasos siguientes:

1. Haga clic en Genie en la barra lateral.

2. Haga clic en Nuevo en la esquina superior derecha de la pantalla.

   

3. En el cuadro de diálogo Nuevo, elija la configuración inicial. Las opciones se describen de la siguiente forma:

• Título: el título aparece en el explorador del área de trabajo con otros objetos del área de trabajo. Elija un título que ayude a los usuarios finales a descubrir el espacio de Genie.
• Descripción: los usuarios ven la descripción cuando abren el espacio de Genie. Use esta área de texto para describir la finalidad de los espacios. El campo de descripción admite el formato Markdown para que pueda aplicar estilo al texto y proporcionar vínculos a contexto y referencias útiles. Para obtener más información sobre la sintaxis de Markdown, consulte esta guía.
• Almacenamientopredeterminado: este recurso de proceso alimenta las instrucciones SQL generadas en los espacios de Genie. Los usuarios finales necesitan acceso a este almacén para interactuar con el espacio. Un espacio de Genie puede usar un almacenamiento SQL profesional o sin servidor. Para obtener un rendimiento óptimo, Databricks recomienda usar un almacenamiento SQL sin servidor.
• Tablas: los espacios de Genie se pueden basar en una o varias tablas. El botón Agregar tablas abre un nuevo cuadro de diálogo donde puede seleccionar las tablas de Unity Catalog que desea incluir.
• Preguntas de ejemplo: las preguntas de ejemplo son opcionales. Aparecen en chats para proporcionar ejemplos de los tipos de preguntas que pueden hacer los usuarios. Se pueden agregar durante la creación o más tarde desde la configuración del espacio.

¿Qué datos debo usar?

Puede crear nuevos espacios de Genie basados en una o varias tablas administradas por el catálogo de Unity. AI/BI Genie usa los metadatos adjuntos a objetos de Unity Catalog para generar respuestas. Los conjuntos de datos anotados correctamente, emparejados con instrucciones específicas que proporcione, son clave para crear una experiencia positiva para los usuarios finales.

Databricks recomienda lo siguiente:

• Curación de datos para el consumoanalítico: vistas de capa para reducir el número de columnas y agregar información específica del caso de uso para aumentar la calidad de la respuesta.
• Minimizar el número de tablas y columnas en un espacio de Genie: incorpore solo las tablas y columnas necesarias para responder a preguntas para un dominio determinado. Las tablas o columnas innecesarias pueden hacer que Genie proporcione respuestas confusas o incorrectas, o que muestre un mensaje de error.

Proporcionar instrucciones

Las instrucciones ayudan a guiar las respuestas de Genie para que pueda procesar la jerga, la lógica y los conceptos únicos de un dominio determinado. Las instrucciones completas son fundamentales para una experiencia espacial perfecta e intuitiva de Genie. Para introducir instrucciones, haga clic en Instrucciones en la barra lateral del espacio de Genie a fin de abrir el panel de instrucciones. Use este panel para agregar Instrucciones generales, Consultas SQL de ejemplo y Funciones SQL.

Instrucciones generales

Proporcione instrucciones de texto sin formato que transmitan claramente sus preferencias empresariales o de respuestas para que las siga Genie. Puede dar formato a las instrucciones como una sola nota completa o clasificarlas por temas para mejorar la organización.

Después se muestra un ejemplo de información que podría incluir en instrucciones generales:

• Información sobre la empresa específica:
  • "Nuestro año fiscal comienza en febrero”
• Valores, alias o filtros comunes:
  • "Convierta siempre en minúsculas y use un operador like al aplicar filtros".
  • "Use abreviaturas para los estados en los valores de filtro".
• Especifique las funciones para responder a preguntas y proporcione instrucciones para los valores devueltos:
  • "Para trimestres, use la adventureworks.oneb.get_quarter(date) UDF. La salida de get_quarter() es el trimestre y es 1, 2, 3 o 4. Úselo para filtrar los datos según sea necesario.

Consultas SQL de ejemplo

Las consultas SQL de ejemplo son consultas SQL que se preparan para ayudar a entrenar a Genie. Al responder a preguntas, Genie selecciona inteligentemente las consultas pertinentes para ayudar a generar la respuesta. Al añadir consultas de ejemplo, muestra eficazmente a Genie cómo usar los datos para responder a preguntas. También puede añadir preguntas de ejemplo para enseñar a Genie sobre los tipos de preguntas que esperaría que la consulta de ejemplo responda. Si Genie recibe una pregunta coincidente, puede usar la consulta de ejemplo directamente para proporcionar una respuesta. Si obtiene una pregunta similar, puede usar pistas de la consulta de ejemplo para ayudar a estructurar el CÓDIGO SQL proporcionado en la respuesta. Céntrese en proporcionar ejemplos que resalten la lógica que es única para la organización y los datos, como en el ejemplo siguiente:

  -- Return our current total open pipeline by region.
  -- Opportunities are only considered pipelines if they are tagged as such.
  SELECT
    a.region__c AS `Region`,
    sum(o.amount) AS `Open Pipeline`
  FROM
    sales.crm.opportunity o
    JOIN sales.crm.accounts a ON o.accountid = a.id
  WHERE
    o.forecastcategory = 'Pipeline' AND
    o.stagename NOT ILIKE '%closed%'
  GROUP BY ALL;

Incorporación de parámetros en consultas SQL

Los parámetros permiten escribir consultas de ejemplo que incluyen marcadores de posición para valores específicos que se van a sustituir en runtime. Con los parámetros, Genie puede tomar entradas específicas de preguntas del usuario y reutilizar la estructura de una consulta de ejemplo para proporcionar respuestas verificadas como recursos de confianza. Por ejemplo, podría ajustar la consulta SQL anterior para incluir un parámetro que filtre por el valor o.forecastcategory, lo que permite a la consulta abordar preguntas sobre las oportunidades etiquetadas en diferentes categorías de pronóstico. Para obtener más información sobre cómo usar consultas con parámetros a fin de generar repositorios etiquetados como recursos de confianza, vea Uso de recursos de confianza en espacios de AI/BI Genie.

En el siguiente fragmento de código se muestra el ejemplo anterior, modificado al agregar un parámetro para el valor o.forecastcategory. Los parámetros usan la misma sintaxis que los marcadores de parámetros con nombre. Consulte Marcadores de parámetros con nombre.

-- Return our current pipeline at a stage by region.
-- Opportunities are only considered pipelines if they are tagged as such.
  SELECT
    a.region__c AS `Region`,
    sum(o.amount) AS `Open Pipeline`
  FROM
    sales.crm.opportunity o
    JOIN sales.crm.accounts a ON o.accountid = a.id
  WHERE
    o.forecastcategory = :forecast_category AND
    o.stagename NOT ILIKE '%closed%'
  GROUP BY ALL;

Para agregar un parámetro a una consulta:

1. Coloque el cursor donde quiera colocar el parámetro en la consulta.

2. Haga clic en Agregar parámetro para insertar un nuevo parámetro.

   Esto creará un nuevo parámetro con el nombre predeterminado parameter. Para cambiar el nombre predeterminado, reemplácelo en el editor de consultas. También puede agregar parámetros escribiendo dos puntos seguidos de un nombre de parámetro (:parameter_name) en el editor.

Edición de un parámetro de consulta

Para editar un parámetro, haga lo siguiente:

1. Haga clic en , junto al nombre del parámetro. Aparece un cuadro de diálogo Detalles del parámetro e incluye las siguientes opciones de configuración:

   • Palabra clave: palabra clave que representa el parámetro de la consulta. Esto solo se puede cambiar actualizando directamente el texto de la consulta.

   • Nombre para mostrar: el nombre legible que usa Genie en la experiencia de chat. Cuando Genie usa una consulta con parámetros para generar una respuesta, incluye el nombre para mostrar y el valor asociado en la respuesta.

   • Tipo: los tipos admitidos incluyen Cadena, Fecha, Fecha y hora y Numérico.

     • El tipo predeterminado es Cadena.
     • El tipo de datos Numérico permite especificar entre Decimal y Entero. El tipo numérico predeterminado es Decimal.

     Nota:

     Si el valor de entrada real no coincide con el tipo de parámetro seleccionado, Genie trata el valor de entrada como el tipo incorrecto, lo que puede provocar resultados inexactos.

2. Haga clic en otra parte de la interfaz de usuario para cerrar el cuadro de diálogo.

Funciones de SQL

Las funciones SQL son funciones personalizadas que se almacenan en el catálogo de Unity y que usan Genie para responder a preguntas específicas. Genie puede llamar a estas funciones e insertar cualquier parámetro especificado por el usuario, pero no puede acceder al contenido SQL subyacente. Esto significa que las funciones SQL son ideales para responder a preguntas específicas comunes que incluyen argumentos complejos o cálculos a los que Genie no debe poder acceder ni editar. Para obtener instrucciones sobre cómo registrar una función en el catálogo de Unity, consulte Creación de una función de tabla SQL y funciones definidas por el usuario (UDF) en el catálogo de Unity.

Recursos de confianza

Cuando se usa el texto exacto de una consulta de ejemplo con parámetros o una función SQL para generar una respuesta, Genie marca la respuesta como un Recurso de confianza. Los recursos de confianza están diseñados para transmitir un nivel adicional de garantía en la precisión de un resultado a un usuario de espacio. Consulte Uso de recursos de confianza en espacios de AI/BI Genie.

Chatear en el espacio de Genie

La mayoría de las interacciones del espacio de Genie tienen lugar en una ventana de chat.

Una nueva ventana de chat incluye un conjunto mantenido de preguntas de ejemplo. Estas preguntas de ejemplo ayudan a los usuarios a saber qué preguntas pueden formular a su espacio de Genie. El campo de texto, donde los usuarios introducen preguntas, está cerca de la parte inferior de la pantalla.

Las respuestas aparecen encima del campo de texto. Después de que un usuario escriba una pregunta, se guarda en un subproceso del historial de chat en el panel izquierdo.

Historial de chat

Los subprocesos del historial de chat se guardan para cada usuario para que puedan hacer referencia a preguntas y respuestas anteriores. Los usuarios también pueden volver a enviar o revisar preguntas de un subproceso de chat. El botón Nuevo chat del panel izquierdo inicia un nuevo subproceso.

Cada subproceso de chat mantiene contexto acerca de las preguntas anteriores que ha hecho. Esto permite a los usuarios formular preguntas de seguimiento para explorar o volver a centrar un conjunto de resultados.

Los subprocesos del historial de chat se almacenan indefinidamente y permanecen accesibles hasta que se elimine el subproceso o el espacio de Genie. Los usuarios con el permiso CAN MANAGE o superior pueden ver todos los chats dentro del espacio.

Estructura de la respuesta

La estructura de respuesta precisa varía en función de la pregunta. A menudo, las respuestas incluyen una explicación del lenguaje natural y una tabla que muestra el conjunto de resultados pertinente. Todas las respuestas incluyen la consulta SQL que se generó para responder a la pregunta. Haga clic en Mostrar código generado para ver la consulta generada.

Un conjunto de botones debajo de la respuesta permite realizar varias acciones. Puede invocar o degradar para indicar la calidad de la respuesta, o solicitar una revisión por parte de los usuarios con el permiso CAN EDIT o superior en el espacio de Genie. Entre las opciones adicionales se incluyen agregar la respuesta como una instrucción, regenerar la respuesta o ver el código SQL usado para generar el conjunto de resultados en la respuesta.

Un conjunto de iconos de acciones rápidas sigue las respuestas que incluyen datos tabulares. Puede usarlos para generar visualizaciones.

También puede generar una visualización describiendo en palabras tras la obtención de un resultado de consulta.

Dar formato a resultados

Para dar formato a una columna de una tabla dentro de una respuesta, haga clic en el menú kebab del encabezado de columna y, a continuación, haga clic en Formato para ver las opciones disponibles. Las opciones de formato dependen del tipo de datos de la columna.

Descargar el conjunto de resultados

Los usuarios del espacio pueden descargar hasta aproximadamente 1 GB de datos de resultados como CSV. El tamaño final de descarga de archivos puede ser ligeramente mayor o menor que 1 GB, ya que el límite de 1 GB se aplica a un paso anterior que la descarga final de archivos. Para descargar los resultados, haga clic en el icono de descarga en la respuesta.

Proporcionar comentarios de respuesta

Cada respuesta de AI/BI Genie incluye un botón de comentarios de pulgar hacia arriba o pulgar hacia abajo. Databricks recomienda animar a los usuarios a proporcionar comentarios sobre el espacio mediante este mecanismo.

Para obtener una respuesta que incluya los resultados de la consulta, los usuarios pueden solicitar que un editor de espacio de Genie lo revise haciendo clic en . Si un usuario tiene preguntas sobre la calidad o precisión de una respuesta generada, puede marcarla para su revisión y, opcionalmente, añadir su comentario o pregunta.

Los usuarios empresariales pueden ver las actualizaciones de las preguntas que han marcado para su revisión en su página Historial. Los usuarios con al menos el permiso CAN MANAGE en el espacio de Genie pueden revisar el intercambio específico, comentar la solicitud y confirmar o corregir la respuesta. Pueden acceder a los comentarios y revisar las solicitudes en la página de supervisión. Los comentarios se pueden usar para ajustar las respuestas e iterar en el espacio. Consulte Revisar el historial y los comentarios.

Revisar el historial y los comentarios

Un espacio de Genie pretende ser una herramienta de colaboración continua para que los equipos de datos y los usuarios empresariales acumulen conocimientos, no una implementación única. Conocer las nuevas preguntas para las que los usuarios empresariales necesitan respuestas es fundamental para la creación de conocimientos. En la página de historial, puede ver preguntas y respuestas individuales, así como comentarios de pulgar hacia arriba o pulgar hacia abajo proporcionados por los usuarios y preguntas marcadas para su revisión. Para abrir la página del historial, haga clic en Historial en la barra lateral del espacio de Genie.

En la página de historial se muestran todas las preguntas y respuestas que se han hecho en el espacio. Puede filtrar las preguntas por hora, clasificación, usuario o estado. Al supervisar el espacio, los editores de Genie pueden comprender de forma proactiva las consultas generadas por los usuarios profesionales y cómo ha respondido el espacio de Genie.

Al identificar las preguntas con las que Genie tiene dificultades, puede actualizar el espacio de Genie con instrucciones específicas para mejorar sus respuestas. Haga clic en una pregunta para abrir el texto de la pregunta y la respuesta. También puede acceder al subproceso de chat completo desde esta vista.

Editar SQL generado

Puede revisar y editar el código SQL generado en cualquier respuesta. Los autores del espacio de Genie suelen conocer el dominio y los datos que les permiten reconocer cuándo genera Genie una respuesta incorrecta. A menudo, los errores se pueden corregir con una pequeña cantidad de ajuste manual a la consulta SQL generada. Para ver el código SQL generado para cualquier respuesta, haga clic en Mostrar código generado para inspeccionar la consulta.

Puede editar la instrucción SQL generada para corregirla si tiene privilegios CAN EDIT o mayores en el espacio de Genie. Después de realizar las correcciones, ejecute la consulta. A continuación, puede guardarla como una instrucción para enseñar a Genie a responder en el futuro. Para guardar una consulta editada, haga clic en Guardar como instrucción.

Evaluación de respuestas con pruebas comparativas

Las pruebas comparativas permiten escalar verticalmente las pruebas y la evaluación de respuestas individuales en un espacio de Genie. A diferencia de las instrucciones, las pruebas comparativas están diseñados para evaluar, no informar, su espacio de Genie. Genie no usa preguntas comparativas ni SQL de ejemplo para mejorar el contexto de Genie.

Mediante pruebas comparativas, puede ejecutar una colección de preguntas de prueba y usar las respuestas para medir la precisión de Genie. Opcionalmente, puede incluir una instrucción SQL que devuelva los resultados esperados. Cuando se ejecuta la pregunta de la prueba comparativa, la respuesta de Genie se compara con los resultados proporcionados por la instrucción SQL y se puntúa para obtener precisión. Si no se ha proporcionado ninguna respuesta SQL, la pregunta se marca para su revisión.

Consulte Uso de pruebas comparativas en un espacio de Genie.

Compartir un espacio de Genie

Los usuarios del espacio de Genie deben tener permisos CAN USE en el almacenamiento adjunto a un espacio de Genie y permisos de acceso en los objetos de Unity Catalog que se muestran en el espacio. Consulte ¿Qué datos debo usar?

Los nuevos espacios de Genie se guardan en la carpeta de usuario de forma predeterminada. Al igual que otros objetos del área de trabajo, heredan permisos de su carpeta envolvente. Puede usar la estructura de carpetas del área de trabajo para compartirlas con otros usuarios. Consultar Organización de objetos del área de trabajo en carpetas.

También puede especificar determinados usuarios o grupos con los que compartir en un nivel de permiso determinado: PUEDE ADMINISTRAR, PUEDE EDITAR, PUEDE EJECUTAR y PUEDE VISUALIZAR.

Para compartir con usuarios o grupos específicos:

1. Haz clic en Compartir.
2. Escriba usuarios o grupos con los que quiera compartir el espacio. Después, haga clic en Agregar y establezca los niveles de permisos adecuados.
3. Use el botón Copiar vínculo situado en la parte inferior del cuadro de diálogo Compartir para obtener un vínculo al espacio de Genie que se pueda compartir. Los usuarios con privilegios pueden hacer clic en el vínculo para abrir el espacio de Genie en una nueva pestaña y formular preguntas.

Clonar un espacio de Genie

La clonación de un espacio de Genie crea una copia, incluido todo el contexto de instalación y las instrucciones. Esto resulta útil si tiene un espacio bien desarrollado y desea crear un nuevo espacio para pruebas adicionales o reutilizar el contexto del espacio original. Después de clonar un espacio, el nuevo espacio es independiente del original, lo que le permite realizar modificaciones y ajustes sin afectar al original.

Los siguientes elementos se copian en un espacio clonado de Genie:

• Tablas y configuraciones
• Instrucciones generales
• Consultas SQL de ejemplo
• Funciones de SQL

Los subprocesos de chat existentes y los datos del historial no se copian en el nuevo espacio.

Para clonar un espacio de Genie, haga lo siguiente:

1. Abra el espacio de Genie que desea clonar.
2. Haga clic en el menú kebab de la esquina superior derecha del espacio.
3. Haga clic en Clonar.
4. (Opcional) En el cuadro de diálogo Clonar, especifique un nuevo nombre y una ubicación de carpeta del área de trabajo para el espacio clonado de Genie.
5. Haga clic en Clonar para crear el nuevo espacio.

Privacidad y seguridad

P: ¿Qué modelo usa Genie?

Genie usa el modelo de Azure OpenAI.

P: ¿Qué datos se envían al modelo?

Los espacios de Genie generan respuestas a preguntas de lenguaje natural mediante metadatos e instrucciones. Genie no tiene acceso a los datos de nivel de fila.

Para procesar las respuestas, Genie usa lo siguiente:

• Mensaje de lenguaje natural enviado por el usuario
• Nombres y descripciones de tablas
• Títulos y descripciones de columnas
• Instrucciones generales
• Consultas SQL de ejemplo
• Funciones de SQL

P: ¿Recopila Azure OpenAI mis datos?

No. Databricks ha optado por la exención del programa de supervisión de abusos y revisión humana, en el que Microsoft no almacena las solicitudes y finalizaciones enviadas al servicio Azure OpenAI. Para obtener más información, consulte la documentación de Microsoft.

Procedimientos recomendados para la preparación del espacio

• Antes de compilar, establezca un conjunto de preguntas bien definidas que quiera que los usuarios del espacio puedan responder.
• Pruebe el espacio de Genie para comprobar la calidad de la respuesta. Pruebe lo siguiente para ver si el modelo proporciona la respuesta esperada:
  • Rephrase las preguntas proporcionadas.
  • Haga otras preguntas relacionadas con los conjuntos de datos.
• Agregue y refina las instrucciones de espacio de Genie hasta que las preguntas proporcionen la respuesta esperada.

Para obtener más instrucciones sobre procedimientos recomendados y ayuda a fin de solucionar problemas, vea Mantenimiento de un espacio eficaz de Genie.