Добавление ресурса пространства Genie в приложение Databricks

Добавьте пространства AI/BI Genie в качестве ресурсов Databricks Apps, чтобы включить запросы на естественном языке в приложениях. Пространства Genie предоставляют диалоговый интерфейс для изучения данных, позволяя пользователям задавать бизнес-вопросы на обычном английском языке и получать аналитические сведения на основе SQL из проверенных наборов данных.

При добавлении пространства Genie в качестве ресурса приложение может:

Преобразование запросов естественного языка от пользователей в SQL
Доступ к предварительно настроенной бизнес-контексту и метаданным
Использование проверенных примеров запросов и определений данных
Создание ответов на основе наборов данных вашей организации

Добавление ресурса пространства Genie

Перед добавлением пространства Genie в качестве ресурса ознакомьтесь с предварительными условиями ресурса приложения.

При создании или изменении приложения перейдите к шагу "Настройка ".
В разделе "Ресурсы приложения" нажмите кнопку +Добавить ресурс.
Выберите место Genie в качестве типа ресурса.
Выберите пространство Genie из списка доступных пространств в рабочей области.
Выберите уровень разрешений для приложения:
- Может просматривать: Предоставляет приложению разрешение на чтение конфигурации пространства Genie и метаданных.
- Может выполняться: Предоставляет приложению разрешение на отправку запросов в пространство Genie и получение ответов.
- Может изменяться: Предоставляет приложению разрешение на изменение конфигурации пространства Genie.
- Может управлять: Предоставляет приложению полный административный доступ к пространству Genie.
(Необязательно) Укажите пользовательский ключ ресурса, который является ссылкой на пространство Genie в конфигурации приложения. Ключ по умолчанию — genie-space.

При добавлении ресурса пространства Genie:

Azure Databricks предоставляет субъекту-службе приложения указанные разрешения на выбранное пространство Genie.
Приложение может отправлять запросы естественного языка в пространство и получать структурированные ответы с помощью запросов и результатов SQL.
Приложение обращается к курированному бизнес-контексту пространства, включая метаданные, примеры запросов и определения данных.
Доступ ограничен только выбранным пространством. Приложение не может получить доступ к другим пространствам Genie, если вы не добавите их в качестве отдельных ресурсов.

Замечание

Субъект-служба приложения также нуждается в соответствующих разрешениях для базовых источников данных, запрашивающих пространство Genie. Обычно это включает USE CATALOGUSE SCHEMASELECT и разрешения для соответствующих таблиц и представлений каталога Unity.

Переменные среды

При развертывании приложения с ресурсом пространства Genie Azure Databricks предоставляет идентификатор пространства с помощью переменных среды, на которые можно ссылаться с помощью valueFrom поля в app.yaml конфигурации.

Пример конфигурации:

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

Использование идентификатора пространства в приложении:

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?"
)

Дополнительные сведения см. в разделе "Доступ к переменным среды" из ресурсов.

Удаление ресурса пространства Genie

При удалении ресурса пространства Genie из приложения субъект-служба приложения теряет доступ к пространству. Пространство Genie остается неизменным и по-прежнему доступно для других пользователей и приложений с соответствующими разрешениями.

Объединение пространств Genie с другими ресурсами приложения

Объединение пространств Genie с другими ресурсами Databricks Apps для создания более сложных приложений данных. К общим шаблонам интеграции относятся:

Панель мониторинга аналитики естественного языка

Используйте следующие ресурсы вместе для запуска интерактивной аналитики:

Genie space: Преобразует вопросы пользователей в запросы SQL
Хранилище SQL: Выполняет запросы и возвращает результаты для визуализации
Секреты: Хранит ключи API для внешних средств визуализации

Пример конфигурации:

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

Улучшенная бизнес-аналитика СИ

Используйте следующие ресурсы для интеграции с моделями ИИ:

Genie space: Создает исходный запрос и контекст данных
Конечная точка обслуживания модели: Возвращает сводки и рекомендации, созданные ИИ
Хранилище SQL: Выполняет сложные аналитические запросы

Разрешения субъекта-службы

Предоставьте субъекту-службе приложения следующие разрешения при интеграции с другими ресурсами приложения:

CAN RUN в пространстве Genie
CAN USE в хранилище SQL (если используется отдельный из пространства Genie)
CAN QUERY в конечных точках обслуживания модели
USE CATALOG и USE SCHEMA в соответствующих объектах каталога Unity
SELECT в таблицах запросы приложения напрямую

Обратная связь

Были ли сведения на этой странице полезными?

Last updated on 2025-12-16

Поделиться через

Добавление ресурса пространства Genie в приложение Databricks