Solución de problemas de espacios de Genie

En esta página se describe cómo resolver problemas comunes al crear y mantener espacios de Genie.

Jerga empresarial mal entendida

La mayoría de las empresas o dominios tienen una abreviatura específica que usan para comunicarse sobre eventos específicos de la empresa. Por ejemplo, al hacer referencia a un año, siempre podría significar el año fiscal y este año fiscal podría comenzar en febrero o marzo en lugar de enero. Para habilitar que Genie responda a estas preguntas de forma natural y precisa, incluya instrucciones que asignen explícitamente su jerga empresarial a palabras y conceptos que Genie puede comprender. Consulte Proporcionar instrucciones.

Uso incorrecto de tablas o columnas

Si Genie intenta extraer datos de una tabla incorrecta o ejecutar análisis en columnas incorrectas, puede ajustar los datos de una de las maneras siguientes:

• Proporcione descripciones claras y precisas: compruebe las tablas y los metadatos asociados para comprobar que la terminología usada allí coincide con la terminología de los usuarios en las preguntas enviadas. Si no es así, refinar la descripción o agregar una instrucción que asigne la terminología usada en la tabla a la terminología usada en la pregunta.
• Agregar consultas de ejemplo: proporcione consultas SQL de ejemplo que Genie puede usar para obtener información sobre cómo responder a determinadas preguntas. Consulte Proporcionar instrucciones.
• Quitar tablas o columnas del espacio: algunas tablas pueden incluir columnas o conceptos superpuestos que dificultan que Genie sepa qué datos usar en una respuesta. Si es posible, quite tablas o columnas innecesarias o superpuestas. Para ocultar columnas de la interfaz de usuario del espacio de Genie sin cambiar los objetos de datos subyacentes, vea Ocultar o mostrar columnas pertinentes.

Errores de filtrado

Las consultas generadas suelen incluir una cláusula WHERE para filtrar los resultados según un valor específico. Cuando Genie no tiene visibilidad sobre los valores de datos, puede establecer la WHERE cláusula para filtrar el valor incorrecto. Por ejemplo, podría intentar coincidir con el nombre "California" cuando la tabla usa abreviaturas como "CA".

Para situaciones como esta, compruebe que las columnas pertinentes tienen habilitados valores de ejemplo y diccionarios de valores. Si se han agregado nuevos datos a las tablas pertinentes, actualice los valores. Consulte Creación de un almacén de conocimiento para obtener espacios de Genie más confiables.

Combinaciones incorrectas

Si las referencias de clave externa no están definidas en el catálogo de Unity, es posible que el espacio no sepa cómo combinar tablas diferentes.

Pruebe a implementar una o varias de las siguientes soluciones:

• Defina las referencias de clave externa en Unity Catalog siempre que sea posible. Consulte la cláusula CONSTRAINT.
• Si las relaciones de clave externa de las tablas no se especifican en el Catálogo de Unity, defina las relaciones de combinación en el almacén de conocimiento del espacio de Genie. Esta estrategia es útil para escenarios de combinación más complejos, como autocombinaciones, o si no tiene permiso suficiente para modificar las tablas subyacentes. Consulte Defina relaciones de uniones.
• Proporcione consultas de ejemplo en las que se unen tablas de maneras estándar.

Si ninguno de estos resuelve el problema, únase previamente a la tabla en una vista y úselo como entrada para el espacio en su lugar.

Comentarios de columna que no se sincronizan desde tablas externas

Azure Databricks no administra los metadatos, los datos ni la semántica de las escrituras en tablas externas. En función de la tabla de origen, es posible que los comentarios no sean accesibles desde Azure Databricks. Para que los comentarios estén disponibles, Azure Databricks recomienda realizar una de las siguientes acciones:

• Edite los metadatos de columna en la interfaz del espacio Genie. Los metadatos editados solo se aplican al espacio de Genie donde se encuentran. Consulte Editar metadatos de columna.
• Cree vistas materializadas sobre tablas federadas. Puede agregar y editar comentarios en una vista materializada como lo haría en una tabla administrada. Puede reutilizar esta vista en diferentes espacios de Genie. Para obtener más información acerca de la carga de datos de tablas externas en una vista materializada, consulte Carga de datos de tablas externas con vistas materializadas. Para obtener más información sobre cómo trabajar con vistas materializadas, consulte Vistas materializadas.

Problemas de cálculo de métricas

La forma en que se calculan y se recopilan las métricas puede ser arbitrariamente compleja y abarcar muchos detalles de negocio que su área no entiende. Esto puede provocar informes incorrectos.

Pruebe a implementar una o varias de las siguientes soluciones:

• Defina las métricas como expresiones SQL en el almacén de conocimiento. Las expresiones SQL proporcionan definiciones reutilizables y precisas para medidas, filtros y dimensiones que Genie puede aplicar de forma coherente. Consulte Definición de expresiones SQL.
• Si las métricas se agregan a partir de tablas base, proporcione un ejemplo de consultas SQL que calculan cada valor acumulativo.
• Si las métricas se han calculado previamente y se encuentran en tablas agregadas, explíquela en los comentarios de la tabla. Especifique agregaciones válidas para cada métrica si las métricas de esa tabla se pueden inscribir aún más.
• Si SQL que intenta generar es muy complicado, intente crear vistas que ya hayan agregado las métricas para el espacio.

Cálculos incorrectos basados en el tiempo

Es posible que Genie no siempre pueda deducir la zona horaria representada en los datos o la zona horaria en la que se debe realizar el análisis a menos que proporcione explícitamente instrucciones adicionales.

Incluya instrucciones más explícitas que detallan la zona horaria de origen original, la función de conversión y la zona horaria de destino. En los ejemplos siguientes se muestra cómo modificar las instrucciones generales para conversiones de zona horaria más confiables:

• Convertir siempre las horas en una zona horaria específica: en este ejemplo, supongamos que la marca de tiempo de origen es UTC y desea obtener resultados en la zona horaria America/Los_Angeles. Agregue lo siguiente a las instrucciones y reemplace <timezone-column> por el nombre de columna adecuado:
  • Las zonas horarias de las tablas se encuentran en UTC.
  • Convierta todas las zonas horarias mediante la función siguiente: convert_timezone('UTC', 'America/Los_Angeles', <timezone-column>).
• Convertir formatos de fecha y hora no UTC a UTC: si la zona horaria predeterminada del área de trabajo es UTC pero los usuarios de Los Ángeles deben hacer referencia hoy para un conjunto específico de registros, agregue lo siguiente a las instrucciones generales del espacio:
  • Para hacer referencia a hoy, use date(convert_timezone('UTC', 'America/Los_Angeles', current_timestamp())).

Consulte convert_timezone función para obtener más detalles y sintaxis.

Omitir instrucciones

Incluso si ha explicado las tablas y columnas en comentarios y ha proporcionado instrucciones generales, es posible que el espacio todavía no los use correctamente.

Pruebe una o más de las estrategias siguientes:

• Proporcione consultas de ejemplo que usen correctamente las tablas. Las consultas de ejemplo son especialmente eficaces para enseñar el espacio a usar los datos.
• Ocultar columnas irrelevantes en el espacio de Genie. Consulte Ocultar o mostrar las columnas pertinentes.
• Cree vistas a partir de las tablas que proporcionan una vista más sencilla de los datos.
• Revise las instrucciones e intente centrar el espacio quitando las tablas o instrucciones irrelevantes.
• Intente iniciar un nuevo chat. Las interacciones anteriores pueden influir en las respuestas de Genie en cualquier chat dado, pero iniciar un nuevo chat le ofrece un punto de partida en blanco para probar nuevas instrucciones.

Problemas de rendimiento

Cuando Genie necesita generar consultas o respuestas de texto excepcionalmente largas, puede tardar mucho tiempo en responder o incluso agotar el tiempo de espera durante la fase de pensamiento.

Pruebe una o varias de las siguientes acciones para mejorar el rendimiento:

• Compruebe el historial de consultas para identificar consultas de ejecución lenta. Se pueden resolver muchos problemas de rendimiento mediante la optimización de las consultas SQL generadas en lugar de modificar la configuración del espacio de Genie. Revise los tiempos de ejecución de consultas y los planes de consulta en el historial de consultas de SQL Warehouse para identificar cuellos de botella y oportunidades de optimización.
• Use recursos o vistas de confianza para encapsular consultas complejas. Consulte Uso de recursos de confianza en espacios de AI/BI Genie.
• Reduzca la longitud de las consultas SQL de ejemplo siempre que sea posible.
• Inicie un nuevo chat si Genie comienza a generar respuestas lentas o con errores.

Respuestas poco confiables a preguntas críticas

Use recursos de confianza para proporcionar respuestas comprobadas a preguntas específicas que espera que los usuarios hagan. Consulte Uso de recursos de confianza en espacios de AI/BI Genie.

Advertencia de límite de tokens

Los tokens son las unidades básicas de texto que Genie usa para procesar y comprender el lenguaje. Las instrucciones de texto y los metadatos de un espacio de Genie se convierten en tokens. Si el espacio se aproxima al límite de tokens, aparece una advertencia. Genie usa el filtrado de contexto para priorizar los tokens que considera más relevantes para una pregunta. Aunque las respuestas deben generarse cuando aparezca una advertencia, la calidad puede reducirse si se filtra el contexto importante. Cuando se supera el límite de tokens, ya no puede enviar ni recibir mensajes en el espacio de Genie.

Tenga en cuenta los procedimientos siguientes para reducir el número de tokens:

• Quitar columnas innecesarias: las columnas innecesarias de las tablas pueden aumentar significativamente el uso de tokens. Cuando sea posible, cree vistas para excluir campos redundantes o no esenciales de las tablas sin procesar. También puede ocultar columnas innecesarias en un espacio de Genie. Consulte Ocultar o mostrar las columnas pertinentes.
• Simplificar las descripciones de columnas: aunque las descripciones de columnas son importantes, evite repetir la información que ya haya transmitido en los nombres de columna. Por ejemplo, si una columna se denomina account_name, una descripción como "el nombre de la cuenta" podría ser redundante y se puede omitir.
• Editar metadatos de columna en el espacio de Genie: vea Editar metadatos de columna para obtener información sobre cómo editar descripciones y proporcionar sinónimos en los metadatos de columna.
• Recorte de ejemplos de consultas SQL: Se incluya una amplia gama de ejemplos de consultas SQL para cubrir varios tipos de preguntas, pero se quiten las consultas SQL superpuestas o redundantes.
• Simplificar instrucciones: compruebe que las instrucciones sean claras y concisas. Evite palabras innecesarias.

La cuenta no está habilitada para el procesamiento entre regiones geográficas

Genie es un Servicio designado administrado por Azure Databricks. Los servicios designados usan Databricks Geos para administrar la residencia de datos. Los datos no se pueden procesar en la misma ubicación geográfica que el espacio de trabajo para algunas regiones. Si su área de trabajo se encuentra en una de esas regiones, el administrador de su cuenta debe habilitar el procesamiento cross-Geo 2.

Alcanzar los límites de rendimiento

Al acceder a espacios de Genie a través de la interfaz de usuario de Azure Databricks, el rendimiento se limita a 20 preguntas por minuto por área de trabajo, en todos los espacios de Genie.

Al acceder a espacios de Genie mediante el nivel gratuito (Public Preview) de la API de Conversación, el rendimiento se limita a un máximo de cinco preguntas por minuto por espacio de trabajo, en todos los espacios de Genie. Consulte Uso de Genie API para integrar Genie en sus aplicaciones.