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

Настройка пространства ИИ/BI Genie и управление ими

  • Статья

В этой статье объясняется, как настроить пространство Genie и управлять ими, интерфейс чата для бизнес-пользователей, чтобы задать вопросы о своих данных на естественном языке.

Технические требования и ограничения

При использовании пространств Genie применяются следующие требования и ограничения.

  • Unity Catalog: данные для пространства Genie должны быть зарегистрированы в каталоге Unity.
  • Compute: необходимо использовать хранилище SQL Pro или бессерверное SQL-хранилище.
  • Пропускная способность: каждое рабочее пространство может обрабатывать до 20 вопросов в минуту во всех пространствах Genie.

Необходимые разрешения

Для создания, редактирования и использования пространств Genie требуются следующие разрешения:

  • Разрешения на вычисления: Создателям, редакторам и пользователям пространства Genie требуется доступ уровня CAN USE к хранилищу SQL по умолчанию, назначенному для этого пространства. Создатели выбирают хранилище SQL по умолчанию при создании пространства. Они могут выбрать любое хранилище SQL, для которого у них есть разрешения CAN RUN.
  • разрешения на доступ к данным: любой пользователь, взаимодействующий с пространством, должен иметь по крайней мере SELECT уровня привилегии на данные, используемые в пространстве.
  • Разрешения для пространства Genie: пользователям необходимо право "CAN RUN" в пространстве Genie для взаимодействия с Genie и данными, используемыми в этом пространстве. Для полного сопоставления привилегий и возможностей в пространстве Genie см. ACLs пространства Genie.

Заметка

Для настройки данных и доступа к вычислительным ресурсам требуются повышенные разрешения, как правило, ограниченные администратором. См. Создание хранилища SQL и Управление привилегиями в каталоге Unity.

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

Genie использует вспомогательные функции ИИ, управляемые службами ИИ Azure, которые должны быть включены на уровне учетной записи. См. статью Использование помощника Databricks, чтобы узнать, как управлять этими функциями для вашей учетной записи.

Заметка

Для управления доступом к этой функции необходимо быть администратором учетной записи. Если вы отключаете функции с поддержкой искусственного интеллекта Azure, пользователи с правами SQL по-прежнему могут щелкнуть значок Genie на боковой панели, но они не могут получить доступ к каким-либо пространствам Genie.

Создайте новое пространство Genie

Genie spaces позволяют аналитикам данных создать опыт использования Genie, специфичный для домена, для бизнес-пользователей, выполнив следующие действия:

  1. Щелкните Genie на боковой панели.

  2. Щелкните Создать в правом верхнем углу экрана.

    диалог

  3. В диалоговом окне "Создать" выберите начальные параметры. Параметры описаны следующим образом:

  • заголовок: заголовок отображается в браузере рабочей области вместе с другими объектами. Выберите название, которое поможет конечным пользователям обнаружить пространство Genie.
  • Описание: Пользователи видят описание при открытии пространства Genie. Используйте эту текстовую область, чтобы описать назначение пространства. Поле описания поддерживает форматирование Markdown, чтобы вы могли оформлять текст и добавлять ссылки на полезный контекст и ресурсы. Дополнительные сведения о синтаксисе markdown см. в этом руководстве.
  • хранилище по умолчанию: этот вычислительный ресурс выполняет инструкции SQL, созданные в пространствах Genie. Конечные пользователи должны получить доступ к этому хранилищу для взаимодействия с пространством. Пространство Genie может использовать профессиональное или бессерверное хранилище SQL. Для оптимальной производительности Databricks рекомендует использовать бессерверное хранилище SQL.
  • таблицы: пространства Genie могут быть основаны на одной или нескольких таблицах. Кнопка Добавление таблиц открывает новое диалоговое окно, в котором можно выбрать таблицы каталога Unity, которые требуется включить.
  • Примеры вопросов: Примеры вопросов являются необязательными. Они отображаются в чатах, чтобы предоставить примеры типов вопросов, которые пользователи могут задавать. Их можно добавить во время создания или позже через настройки пространства.

Укажите инструкции

Инструкции помогают направлять ответы Genie, чтобы обрабатывать уникальный жаргон, логику и понятия в данной области. Комплексные инструкции крайне важны для обеспечения плавного и интуитивно понятного взаимодействия с пространством Genie. Чтобы ввести инструкции, щелкните значок инструкции на боковой панели Genie, чтобы открыть панель инструкций. Используйте эту область для добавления общих инструкций, примеров запросов SQLи функций SQL.

Вы можете добавить до 100 инструкций в общей сложности для пространства Genie. Следующие элементы вносят вклад в общую сумму:

  • Весь блок текста в Общие инструкции засчитывается как одно целое.
  • Каждый пример SQL-запроса считается одним.
  • Каждая функция SQL считается одной.

панель инструкций

Общие инструкции

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

Ниже показан пример информации, которую можно включить в общие инструкции:

  • бизнес-информации для конкретной компании:
    • "Наш финансовый год начинается в феврале"
  • Задайте значения, псевдонимы или общие фильтры:
    • Всегда преобразуйте в нижний регистр и используйте оператор LIKE при применении фильтров.
    • "Используйте сокращенные выражения для состояний в значениях фильтра".
  • Укажите функции для ответа на вопросы и укажите инструкции по возвращаемым значениям:
    • Для кварталов используйте adventureworks.oneb.get_quarter(date) UDF. Результатом get_quarter() является квартал и составляет либо 1, 2, 3 или 4. Используйте это для фильтрации данных по мере необходимости.

Примеры запросов SQL

Примеры SQL-запросов — это SQL-запросы, которые вы подготавливаете, чтобы помочь обучить Genie. Genie интеллектуально выбирает соответствующие запросы, чтобы помочь создать ответ при ответе на вопросы. При добавлении примеров запросов вы показываете Genie, как использовать данные для ответа на вопросы. Вы также можете добавить примеры вопросов, чтобы научить Genie тем типам вопросов, на которые вы ожидаете, что примерный запрос будет отвечать. Если Genie получает соответствующий вопрос, он может использовать пример запроса непосредственно для предоставления ответа. Если он получает аналогичный вопрос, он может использовать подсказки из примера запроса, чтобы помочь структурировать SQL, предоставленный в ответе. Сосредоточьтесь на предоставлении примеров, которые выделяют логику, уникальную для вашей организации и данных, как показано в следующем примере:

  -- 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;

Добавление параметров в запросах SQL

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

В следующем фрагменте кода показан предыдущий пример, измененный путем добавления параметра для значения o.forecastcategory. Параметры используют тот же синтаксис, что и именованные маркеры параметров. См. маркеры именованных параметров .

-- 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;

Чтобы добавить параметр в запрос, выполните приведенные действия.

  1. Поместите курсор туда, где вы хотите разместить параметр в запросе.

  2. Щелкните Добавить параметр, чтобы вставить новый параметр.

    При этом создается новый параметр с именем по умолчанию parameter. Чтобы изменить имя по умолчанию, замените его в редакторе запросов. Можно также добавить параметры, введя двоеточие, за которым следует имя параметра (:parameter_name) в редактор.

Изменение параметра запроса

Чтобы изменить параметр, сделайте следующее:

  1. Щелкните значок шестеренки рядом с именем параметра. Диалоговое окно сведений о параметрах появляется и включает следующие параметры конфигурации:

    • Ключевое слово: ключевое слово, представляющее параметр в запросе. Ключевое слово можно изменить только путем непосредственного обновления текста в запросе.

    • отображаемое имя: понятное для человека имя, которое Genie использует в чате. Когда Genie генерирует ответ с помощью параметризованного запроса, он включает в ответ отображаемое имя и связанное значение.

    • типа : поддерживаемые типы включают строковый, дата, дата-времяи числовой.

      • Тип по умолчанию — string.
      • Тип данных Numeric позволяет выбрать между десятичным и целым числом. Числовой тип по умолчанию — десятичное.

      Заметка

      Если фактическое входное значение не соответствует выбранному типу параметра, Genie обрабатывает входное значение как неправильный тип, что может привести к неточным результатам.

  2. Щелкните другую часть пользовательского интерфейса, чтобы закрыть диалоговое окно.

Функции SQL

Функции SQL — это пользовательские функции, хранящиеся в каталоге Unity и используемые Genie для ответа на конкретные вопросы. Genie может вызывать эти функции и вставлять все пользовательские параметры, но не могут получить доступ к базовому содержимому SQL. Это означает, что функции SQL идеально подходят для ответов на распространенные специфические вопросы, которые включают сложные аргументы или вычисления и к которым Genie не может иметь доступ или редактировать. Инструкции по регистрации функции в каталоге Unity см. в разделе Создание SQL-функции для таблицы и Пользовательские функции (UDF) в каталоге Unity.

Тестируйте ваше пространство Genie

Большинство взаимодействий с пользователем происходят в окне чата. Лучший способ узнать, работает ли ваше пространство, как вы хотите, чтобы протестировать его с реалистичными вопросами, которые вы ожидаете, что ваши бизнес-пользователи будут задавать.

окно нового чата, как описано в следующем тексте.

Все примеры вопросов, введенных в параметрах, отображаются в окне чата. Эти примеры вопросов помогают пользователям понять, какие вопросы они могут задать в своем пространстве Genie. Текстовое поле, в котором пользователи вводит вопросы, находится в нижней части экрана.

Ответы отображаются над текстовым полем. После ввода вопроса он сохраняется в истории чата в левой панели.

Запуск нового чата:

  1. Щелкните значок чата чата, чтобы открыть окно чата.
  2. Введите свой вопрос в текстовое поле Задать свой вопрос.... Чтобы начать новый разговор, щелкните Новый чат.

Просмотр ответов

Ответы обычно предоставляются в виде ответа на вопросы в естественном языке и таблицы с соответствующим результирующим набором. Точная структура ответа зависит от вопроса. Все ответы включают SQL-запрос, созданный для ответа на этот вопрос. Щелкните Показать созданный код, чтобы просмотреть созданный запрос.

В правой нижней части ответа есть необязательные действия. Вы можете скопировать CSV-файл ответа в буфер обмена, скачать его в формате CSV-файла, добавить его как инструкцию для пространства Genie, а также поддержать или отклонить ответ.

Набор плиток быстрых действий появляется после ответов, включающих табличные данные. Их можно использовать для создания визуализаций.

плитки быстрого действия, которые предлагают различные варианты визуализации.

Вы также можете создать визуализацию, охарактеризовав ее словами после получения результата запроса. См. создание визуальных элементов.

Форматирование результатов

Чтобы отформатировать столбец в таблице в ответе, щелкните меню Кебаб меню кебаб в заголовке столбца, а затем щелкните Формат, чтобы просмотреть доступные параметры. Параметры форматирования зависят от типа данных столбца.

числовым столбцом с параметрами форматирования, такими как валюта и процент.

Скачать результаты

Пользователи пространства могут скачать до примерно 1 ГБ данных результатов в виде CSV- файла. Размер окончательного скачивания файла может быть немного больше или меньше 1 ГБ, так как ограничение на 1 ГБ применяется к предыдущему шагу, чем к окончательному скачиванию файла. Чтобы скачать результаты, щелкните значок скачивания в ответе.

Создание визуализаций

Пользователи могут явно запрашивать визуализацию с помощью окна чата или использовать одну из предлагаемых визуализаций, предоставляемых в разделе Быстрые действия, который следует ответу. Иногда Genie предлагает визуализацию в рамках ответа. Визуализации можно редактировать в окне чата.

Поддерживаются следующие типы диаграмм:

  • Площадь
  • Бар
  • Линия
  • Пирог
  • Разбрасывать

Изменение визуализации:

  • В правом верхнем углу визуализации щелкните значок редактирования . Откроется область редактирования справа от страницы.
  • Используйте раскрывающееся меню визуализации, чтобы выбрать другой тип диаграммы.
  • Для большинства типов диаграмм используйте раскрывающиеся меню оси X и оси Y, чтобы выбрать значения, представленные на каждой оси. Для диаграмм круговой используйте раскрывающееся меню угловой угол, чтобы выбрать столбец, который нужно представить.
  • (Необязательно) Чтобы настроить цветовую схему, щелкните + в категории Цвет.
  • (Необязательно) Чтобы выбрать данные для отображения в подсказке при наведении указателя мыши на визуализацию, щелкните + в разделе подсказки.

Предоставление обратной связи по ответу

Каждый ответ AI/BI Genie включает кнопку для обратной связи в виде пальца вверх или пальца вниз. Databricks рекомендует поощрять пользователей предоставлять отзывы о пространстве с помощью этого механизма.

Для ответа, включающего результаты запроса, пользователи могут запросить, чтобы он был проверен редактором пространства Genie, щелкнув значок значок проверки. Если у пользователя есть вопросы о качестве или точности созданного ответа, он может пометить его для проверки и, при необходимости, добавить свой комментарий или вопрос.

Бизнес-пользователи могут просматривать обновления по вопросам, которые они отметили на рассмотрение, на странице истории. Пользователи с разрешением CAN MANAGE в пространстве Genie могут просматривать конкретный обмен, комментировать запрос и подтвердить или исправить ответ. Они могут получать доступ к отзывам и просматривать запросы на странице мониторинга. Затем вы можете использовать эту обратную связь для настройки ответов и изменения вашей среды. См. журнал проверки и отзывы.

история обзоров и обратная связь

Пространство Genie предназначено в качестве инструмента для непрерывного сотрудничества команд по работе с данными и бизнес-пользователей, чтобы накапливать знания, а не для однократного развертывания. Понимание новых вопросов, на которые бизнес-пользователи нуждаются в ответах, является важным для создания знаний. На странице истории можно просмотреть задаваемые вопросы и ответы, оценки "палец вверх" или "палец вниз," предоставленные пользователями, а также вопросы, помеченные для проверки. Чтобы открыть страницу истории, щелкните значок истории истории в боковой панели Genie space.

пример страницы мониторинга с описанием описанных функций.

На странице журнала отображаются все вопросы и ответы, которые были заданы в пространстве. Вы можете фильтровать вопросы по времени, рейтингу, пользователю или состоянию. Отслеживая пространство, редакторы пространства Genie могут заранее понять запросы, поднятые бизнес-пользователями, и как пространство Genie ответило.

Определив вопросы, с которыми борется Genie, вы можете обновить пространство Genie с конкретными инструкциями, чтобы улучшить свои ответы. Щелкните вопрос, чтобы открыть текст вопроса и ответа. Вы также можете получить доступ к полной истории чата в этом представлении.

Редактировать сгенерированный SQL

Вы можете просмотреть и изменить созданный SQL в любом ответе. Авторы пространства Genie обычно знают домен и данные, которые позволяют им распознавать, когда Genie создает неправильный ответ. Часто ошибки можно исправить с небольшим количеством ручной настройки в созданном SQL-запросе. Чтобы просмотреть созданный SQL для любого ответа, щелкните Показать созданный код для проверки запроса.

Вы можете изменить сгенерированное выражение SQL, чтобы исправить его, если у вас есть привилегии уровня ИЗМЕНЕНИЕ или выше в пространстве Genie. После внесения исправлений выполните запрос. Затем вы можете сохранить его в качестве инструкции для обучения Genie, как ответить в будущем. Чтобы сохранить измененный запрос, щелкните значок инструкции Сохранить как инструкциюСохранить как инструкцию.

Поделиться пространством Genie

Важный

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

Пользователи пространства Genie должны иметь разрешения CAN USE на складе, подключенном к пространству Genie, и разрешения на доступ к объектам каталога Unity, размещенным в пространстве. См. Какие данные мне следует использовать?.

Новые пространства Genie сохраняются в папке пользователя по умолчанию. Как и другие объекты рабочей области, они наследуют разрешения от их включающей папки. Структуру папок рабочей области можно использовать для совместного использования с другими пользователями. См. раздел Упорядочивание объектов рабочей области в папки.

Вы также можете указать определенных пользователей или групп для совместного использования на определенном уровне разрешений: CAN MANAGE, CAN EDIT, CAN RUN и CAN VIEW.

Чтобы предоставить общий доступ определенным пользователям или группам, выполните указанные действия.

  1. Щелкните Поделиться.
  2. Введите пользователей или группы, с которыми вы хотите поделиться пространством. Затем нажмите Добавить и задайте соответствующие уровни разрешений.
  3. Нажмите кнопку Копировать ссылку в нижней части диалогового окна "Поделиться", чтобы получить доступную ссылку к пространству Genie. Привилегированные пользователи могут щелкнуть ссылку, чтобы открыть пространство Genie на новой вкладке и задать вопросы.

Клонировать пространство Genie

Клонирование пространства Genie создает копию, включая все контексты установки и инструкции. Это полезно, если у вас есть хорошо разработанное пространство и хотите создать новое пространство для дополнительного тестирования или повторно использовать контекст из исходного пространства. После клонирования пространства новое пространство не зависит от исходного, что позволяет вносить изменения и корректировки без влияния на исходный.

Следующие элементы копируются в клонированное пространство Genie:

  • Таблицы и параметры
  • Общие инструкции
  • Примеры запросов SQL
  • Функции SQL

Существующие потоки чата и журнальные данные не копируются в новое место.

Чтобы клонировать пространство Genie, сделайте следующее:

  1. Откройте пространство Genie, которое вы хотите клонировать.
  2. Щелкните меню Кебаб меню кебаб в правом верхнем углу пространства.
  3. Щелкните Клонировать.
  4. (Необязательно) В диалоговом окне Клонирование укажите новое имя и расположение папки рабочей области для пространства Genie, которое будет клонировано.
  5. Нажмите Создать копию, чтобы создать новое пространство.

Рекомендации по подготовке пространства

Рекомендации по устранению неполадок см. в статье Курировать эффективное пространство Genie.

Мониторинг использования

Журналы аудита можно использовать для мониторинга использования пространства Genie. См. события AI/BI Genie