Compartir vía

Adición de un recurso de espacio de Genie a una aplicación de Databricks

Agregue espacios de AI/BI Genie como recursos de Databricks Apps para habilitar consultas en lenguaje natural en las aplicaciones. Los espacios de Genie proporcionan una interfaz conversacional para la exploración de datos, lo que permite a los usuarios formular preguntas empresariales en inglés sin formato y recibir información basada en SQL de los conjuntos de datos mantenidos.

Al agregar un espacio de Genie como recurso, la aplicación puede hacer lo siguiente:

  • Conversión de consultas de lenguaje natural de usuarios en SQL
  • Acceso al contexto empresarial preconfigurado y los metadatos
  • Uso de consultas de ejemplo seleccionadas y definiciones de datos
  • Generar respuestas basadas en los conjuntos de datos de la organización

Adición de un recurso de espacio de Genie

Antes de agregar un espacio de Genie como recurso, revise los requisitos previos del recurso de la aplicación.

  1. Al crear o editar una aplicación, vaya al paso Configurar .
  2. En la sección Recursos de la aplicación, haga clic en + Agregar recurso.
  3. Seleccione Genie space (Espacio de Genie ) como tipo de recurso.
  4. Elija un espacio de Genie en la lista de espacios disponibles en el área de trabajo.
  5. Seleccione el nivel de permiso de la aplicación:
    • Puede ver: Concede permiso a la aplicación para leer la configuración y los metadatos del espacio de Genie.
    • Se puede ejecutar: Concede permiso a la aplicación para enviar consultas al espacio de Genie y recibir respuestas.
    • Puede editar: Concede permiso a la aplicación para modificar la configuración del espacio de Genie.
    • Puede administrar: Concede a la aplicación acceso administrativo completo al espacio de Genie.
  6. (Opcional) Especifique una clave de recurso personalizada, que es cómo se hace referencia al espacio de Genie en la configuración de la aplicación. La clave predeterminada es genie-space.

Al agregar un recurso de espacio de Genie:

  • Azure Databricks concede a la entidad de servicio de la aplicación los permisos especificados en el espacio de Genie seleccionado.
  • La aplicación puede enviar consultas de lenguaje natural al espacio y recibir respuestas estructuradas con consultas SQL y resultados.
  • La aplicación accede al contexto empresarial mantenido del espacio, incluidos los metadatos, las consultas de ejemplo y las definiciones de datos.
  • El acceso solo tiene como ámbito el espacio seleccionado. La aplicación no puede acceder a otros espacios de Genie a menos que los agregue como recursos independientes.

Nota:

La entidad de servicio de la aplicación también necesita los permisos adecuados en los orígenes de datos subyacentes que consulta el espacio de Genie. Normalmente se incluyen USE CATALOGlos permisos , USE SCHEMAy SELECT en las vistas y tablas de Catálogo de Unity pertinentes.

Variables de entorno

Al implementar una aplicación con un recurso de espacio de Genie, Azure Databricks expone el identificador de espacio a través de variables de entorno a las que puede hacer referencia mediante el campo de la valueFromapp.yaml configuración.

Configuración de ejemplo:

env:
  - name: GENIE_SPACE_ID
    valueFrom: genie-space # Use your custom resource key if different

Con el identificador de espacio de la aplicación:

import os
from databricks.sdk import WorkspaceClient

# Access the Genie space using the injected environment variable
space_id = os.getenv("GENIE_SPACE_ID")

# Initialize the workspace client
w = WorkspaceClient()

# Start a conversation with a natural language query
response = w.genie.start_conversation_and_wait(
    space_id=space_id,
    content="What were our top-selling products last quarter?"
)

# Process the response (responses contain attachments with text, queries, and so on)
for attachment in response.attachments:
    print(f"Genie response: {attachment.text.content}")

# Continue the conversation with additional questions
follow_up = w.genie.create_message_and_wait(
    space_id=space_id,
    conversation_id=response.conversation_id,
    content="Can you break that down by product category?"
)

Para obtener más información, consulte Access environment variables from resources (Acceso a variables de entorno desde recursos).

Eliminación de un recurso de espacio de Genie

Al quitar un recurso de espacio de Genie de una aplicación, la entidad de servicio de la aplicación pierde el acceso al espacio. El espacio de Genie permanece sin cambios y sigue estando disponible para otros usuarios y aplicaciones que tienen los permisos adecuados.

Combinar espacios de Genie con otros recursos de la aplicación

Combine espacios de Genie con otros recursos de Databricks Apps para crear aplicaciones de datos más sofisticadas. Entre los patrones de integración comunes se incluyen:

Panel de análisis de lenguaje natural

Use los siguientes recursos juntos para ejecutar análisis interactivos:

  • Espacio de Genie: Convierte las preguntas del usuario en consultas SQL.
  • SQL Warehouse: Ejecuta las consultas y devuelve resultados para la visualización.
  • Secretos: Almacena claves de API para herramientas de visualización externas

Configuración de ejemplo:

env:
  - name: GENIE_SPACE_ID
    valueFrom: genie-space
  - name: SQL_WAREHOUSE_ID
    valueFrom: sql-warehouse
  - name: EXTERNAL_API_KEY
    valueFrom: viz-secret

Inteligencia empresarial mejorada con inteligencia artificial

Use los siguientes recursos para integrarse con los modelos de IA:

  • Espacio de Genie: Genera la consulta inicial y el contexto de datos.
  • Punto de conexión de servicio del modelo: Devuelve resúmenes y recomendaciones generados por IA.
  • SQL Warehouse: Ejecuta consultas analíticas complejas

Permisos de entidad de servicio

Conceda a la entidad de servicio de la aplicación los permisos siguientes al integrar con otros recursos de la aplicación:

  • CAN RUN en el espacio de Genie
  • CAN USE en el almacén de SQL (si usa uno independiente del espacio Genie)
  • CAN QUERY en los puntos de conexión de servicio del modelo
  • USE CATALOG y USE SCHEMA en los objetos de catálogo de Unity pertinentes
  • SELECT en tablas, las consultas de la aplicación directamente

Procedimientos recomendados

Siga estos procedimientos recomendados al trabajar con recursos espaciales de Genie:

  • Conceda permisos mínimos. Solo proporciona acceso a los espacios específicos de Genie que la aplicación necesita para funcionar.
  • Asegúrese de que el espacio de Genie contiene conjuntos de datos y metadatos bien mantenidos para mejorar la calidad de las respuestas de consulta de lenguaje natural.
  • Pruebe las consultas de la aplicación en el espacio de Genie para validar que puede generar resultados precisos para las preguntas esperadas del usuario.
  • Supervise el rendimiento de las consultas y ajuste los patrones de interacción de la aplicación con el espacio de Genie para optimizar los tiempos de respuesta.
  • Implemente el control de errores en los casos en los que el espacio de Genie no pueda interpretar ni responder a las consultas de usuario de forma eficaz.
  • Last updated on