Инструменты MCP Qlik

Сервер MCP Qlik включает инструменты, которые позволяют вашей LLM выполнять действия за вас в вашем клиенте Qlik Cloud. Вы можете настроить свой опыт, выбрав, какие инструменты MCP Qlik вы хотите сделать доступными.

Права доступа и инструменты MCP Qlik

Доступ к инструментам MCP контролируется вашими правами. Вам требуется разрешение MCP Qlik: Разрешено в пользовательской роли для доступа к инструментам MCP Qlik из вашего клиента LLM.

Кроме того, поскольку инструмент MCP Qlik авторизуется как подключающийся пользователь, он использует вашу существующую роль пользователя и права доступа к пространству. Вам также необходимо иметь разрешение в Qlik Cloud на использование возможностей или типа контента, используемых инструментами. Например, если у вас нет разрешения на доступ к происхождению в Qlik Cloud, вы не можете использовать инструмент MCP Qlik Qlik get lineage. В зависимости от ваших прав некоторые инструменты могут отвечать отказом в доступе, если вы не можете использовать возможность или функциональность в Qlik Cloud.

Доступность инструментов также может быть ограничена лицензированием вашего клиента.

Выбор инструментов MCP Qlik

Инструменты MCP Qlik — это каталог специально созданных действий, которые LLM может вызывать для выполнения действий в вашем клиенте Qlik Cloud. Эти действия включают:

• Поиск приложений и наборов данных

• Проверка полей и метаданных диаграмм

• Применение и очистка фильтров

• Создание листов и диаграмм

• Управление управляемыми ресурсами, такими как термины глоссария и продукты данных.

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

Доступные инструменты MCP Qlik

В таблице ниже представлен обзор текущих категорий инструментов MCP Qlik и их названий.

Чего может достичь каждый из инструментов

Обнаружение приложений и метаданные

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

Доступны следующие инструменты:

• Qlik_search: Поиск ресурсов Qlik (приложений, наборов данных, продуктов данных, глоссариев) по имени или содержимому.

• Qlik_describe_apps: Получение полных метаданных для приложения, включая поля, владельца, статус публикации.

• Qlik_get_fields: Вывод списка всех полей данных, доступных в приложении для использования в качестве измерений.

• Qlik_list_sheets: Вывод списка всех листов в приложении.

• Qlik_get_sheet_details: Получение сведений о конкретном листе, включая все диаграммы и их типы.

• Qlik_search_spaces: Поиск пространств на основе строки запроса.

Пример промпта:

"Мне нужно проанализировать отток клиентов." Этот простой промпт позволяет:

• Использовать qlik_search для поиска приложений, связанных с «оттоком» или «удержанием клиентов».

• Для наилучшего совпадения запустить qlik_describe_app, чтобы подтвердить, что это правильное приложение, и просмотреть его метаданные (владелец и статус публикации).

• Использовать qlik_get_fields для вывода списка доступных полей и определения возможных измерений и мер, таких как Customer, ChurnFlag, SubscriptionType, Region и ChurnDate.

• Использовать qlik_list_sheets , чтобы увидеть, какие информационные панели уже существуют.

• Для любого многообещающего листа, например, «Обзор оттока», вызвать qlik_get_sheet_details и обобщить, какие диаграммы уже доступны и какие пробелы остаются.

Бизнес-глоссарий

Этот набор инструментов позволяет пользователю настраивать и поддерживать управляемый бизнес-глоссарий от начала до конца:

• Создание глоссария

• Организация его с помощью категорий

• Добавление и курирование терминов (включая редактирование, удаление и управление статусом жизненного цикла, таким как черновик - проверено - устарело)

• Связывание этих терминов с реальными аналитическими ресурсами (приложениями, наборами данных, полями, основными элементами).

Доступны следующие инструменты:

• Qlik_create_glossary: Создание нового бизнес-глоссария

• Qlik_get_full_glossary_export: Получение полного глоссария со всеми терминами, категориями, ссылками (ресурсоемкая операция)

• Qlik_get_glossary_categories: Извлечение всех категорий для глоссария

• Qlik_create_glossary_category: Создание новой категории в глоссарии

• Qlik_search_glossary_terms: Поиск терминов в глоссарии

• Qlik_get_glossary_term: Получение конкретного термина из глоссария

• Qlik_create_glossary_term: Создание нового термина глоссария с описанием, тегами, связями

• Qlik_update_glossary_term: Изменение существующего термина глоссария

• Qlik_delete_glossary_term: Удаление термина глоссария

• Qlik_update_term_status: Обновление статуса термина (черновик, проверено, устарело). Только стюард может проверить термин. После проверки термина только стюард может его изменить

  Примечание к информации

  Эта операция имеет три статуса:

  • draft: Термин находится в состоянии черновика.

  • verified: Термин был проверен стюардом.

  • deprecated: Термин устарел и не должен использоваться.

  Названия статусов чувствительны к регистру и должны быть указаны точно так, как указано выше.

• Qlik_get_glossary_term_links: Получение ресурсов, связанных с термином глоссария

  Эта функция поддерживает два режима:

  • Режим одиночной ссылки: Укажите отдельные параметры, например resource_id или resource_type.

  • Пакетный режим: Укажите список словарей ссылок через параметр 'links'

  Примечание к информации

  При связывании с подресурсом все три поля подресурса (subResourceId, subResourceName и subResourceType) должны быть указаны вместе для каждой ссылки.

• Qlik_create_glossary_term_links: Связывание термина с приложениями, наборами данных, полями, основными элементами

Пример промпта:

"Помогите мне создать и управлять бизнес-глоссарием для нашего домена продаж. Создайте глоссарий под названием «Глоссарий продаж», добавьте категории «Доход», «Клиенты» и «Воронка продаж». Затем создайте термины для «Годового регулярного дохода (ARR)» и «Оттока клиентов» с четкими определениями и тегами, например, финансы и операции продаж, установите для них статус черновика и свяжите каждый термин с соответствующими полями набора данных и основными элементами Ключевых показателей эффективности."

Наборы данных и качество данных

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

Доступны следующие инструменты:

• Qlik_get_dataset: Загрузка метаданных набора данных, включая оценку доверия

• Qlik_get_dataset_schema: Загрузка схемы (определений столбцов) набора данных

• Qlik_get_dataset_profile: Загрузка данных профиля (статистики, распределений) набора данных

• Qlik_get_dataset_sample: Загрузка первых 10 строк набора данных для предварительного просмотра

• Qlik_get_dataset_freshness: Получение последней обновленной Метки времени набора данных

• Qlik_get_dataset_trust_score: Получение оценки доверия набора данных

• Qlik_get_dataset_memberships: Получение членства в продуктах данных для набора данных

• Qlik_update_dataset_metadata: Обновление имени и описания набора данных

• Qlik_update_dataset_quality: Запрос вычисления качества данных для набора данных

• Qlik_get_dataset_quality_computation_status: Проверка статуса вычисления качества

Пример промпта:

“Оцените готовность нашего набора данных Customer Orders для новой информационной панели. Покажите мне его метаданные и текущую оценку доверия, подтвердите время последнего обновления и перечислите, к каким продуктам данных он относится. Затем загрузите схему и образец из 10 строк для проверки ключевых полей, таких как order_date, customer_id и net_amount. Запустите профиль набора данных, чтобы обнаружить пропущенные значения и выбросы, и если показатели качества выглядят устаревшими, запустите вычисление качества данных и продолжайте проверять статус задания до его завершения. Наконец, обновите описание набора данных, чтобы задокументировать известные ограничения и рекомендуемое использование.”

Исследование и анализ данных

Эти инструменты поддерживают быстрое и ситуативное исследование данных и существующего аналитического контента, не требуя от пользователя постоянного создания новых визуализаций. Вы можете создавать временные вычисления или объекты запросов для ответов на вопросы «что, если», проверять поля путем вывода списка уникальных значений или искать определенные значения.

Доступны следующие инструменты:

• Qlik_create_data_object: Создание временных объектов вычислений для ситуативных аналитических запросов

  Примечание к информации

  Используйте get_field_values() или search_field_values() перед применением выборок, чтобы убедиться в существовании значений.

  Примечание к предупреждению

  Qlik выполняет ВСЕ вычисления, поэтому:

  • Никогда не агрегируйте, не суммируйте, не усредняйте и не вычисляйте возвращаемые данные: значения являются окончательными.

  • Для других вычислений вызовите инструмент снова с новыми выражениями.

  • Всегда применяйте соответствующие фильтры-выборки для ограничения размера данных и повышения производительности.

• Qlik_get_field_values: Получение уникальных значений для определенного поля (используйте перед фильтрацией)

  Примечание к информации

  Для полей с высокой кардинальностью всегда используйте qlik_search_field_values() вместо этого

  Примечание к предупреждению

  Используйте этот инструмент или qlik_search_field_values() ПЕРЕД созданием выборок-фильтров, чтобы убедиться, что значения существуют. Это помогает избежать ошибок при применении фильтров с несуществующими значениями.

• Qlik_search_field_values: Поиск определенных значений по полями (проверьте перед анализом множеств)

  Примечание к предупреждению

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

  Пример рабочего процесса на основе передовых практик:

  1. qlik_search_field_values(fieldName="payment_year", searchTerms=["2022"])

  2. Убедитесь, что "2022" существует в результатах

  3. Создайте объект данных, используя {payment_year={2022}.

• Qlik_get_chart_data: Извлечение данных с разбивкой на страницы из существующей визуализации диаграммы

• Qlik_get_chart_info: Получение метаданных о диаграмме без извлечения ее данных

Пример промпта:

“Помогите мне выяснить, почему доход в Северном регионе упал в прошлом месяце. Сначала проверьте существующую диаграмму «Доход по регионам»: покажите мне ее метаданные (измерения, меры, фильтры, количество строк), а затем извлеките данные диаграммы за последние два месяца. Прежде чем я применю какие-либо выборки, выведите список уникальных значений для региона и выполните поиск по значениям полей, чтобы подтвердить, используется ли «North», «NORTH» или «Northern». Затем создайте временное вычисление для сравнения дохода и маржи по месяцам для Северного региона по сравнению с другими регионами и выделите, какие категории продуктов внесли наибольший вклад в изменение.”

Продукты данных

Эти инструменты управляют полным жизненным циклом продукта данных как управляемого, совместно используемого пакета наборов данных:

1. Создание.

2. Проверка его метаданных и документации.

3. Поддержание его определения (имя, описание и какие наборы данных он содержит)

4. Контроль того, где и доступен ли он, путем перемещения его между пространствами и его активации или деактивации.

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

Доступны следующие инструменты:

• Qlik_create_data_product: Создание нового продукта данных

• Qlik_get_data_product: Получение метаданных для конкретного продукта данных

• Qlik_get_data_product_documentation: Получение документации в формате markdown для продукта данных

• Qlik_update_data_product: Обновление свойств (имя, описание, наборы данных) продукта данных

• Qlik_update_data_product_space: Перемещение продукта данных в другое пространство

• Qlik_update_activate_data_product: Активация продукта данных в определенном пространстве

• Qlik_update_deactivate_data_product: Деактивация продукта данных

• Qlik_delete_data_product: Удаление продукта данных

Пример промпта:

“Создайте продукт данных под названием «Аналитика продаж — Курируемая» с четким описанием и включите эти наборы данных: Заказы, Клиенты и Продукты. Затем покажите мне метаданные продукта данных и извлеките его документацию в формате markdown, чтобы я мог просмотреть, что увидят потребители. Обновите описание, чтобы добавить руководство по использованию, а также добавьте набор данных Возвраты. Переместите продукт данных в наше общее пространство «Аналитика», активируйте его там для более широкого доступа, и если мы позже заменим его новой версией, деактивируйте старую. Наконец, если продукт полностью выведен из эксплуатации и на него больше нет ссылок, удалите его.”

Происхождение

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

• Анализа влияния.

• Устранения неполадок с неожиданными числами.

• Управления или аудита.

• Определения истинных источников, питающих отчет или набор данных.

Доступны следующие инструменты:

• Qlik_get_lineage: Загрузка истории происхождения набора данных или приложения (вызывайте рекурсивно для полной цепочки)

Пример промпта:

“Покажите мне полное восходящее происхождение для набора данных Customer Orders. Начните с набора данных и возвращайтесь рекурсивно, пока не достигнете исходных систем-источников. Для каждого шага обобщите, что является непосредственным родителем, и отметьте любые ключевые преобразования или промежуточные наборы данных или приложения. Затем скажите мне, какой восходящий источник с наибольшей вероятностью повлияет на поле net_amount, если оно изменится.”

Основные элементы (Измерения и Меры)

Эти инструменты помогают пользователям стандартизировать и повторно использовать ключевую бизнес-логику в приложении, работая с основными (библиотечными) измерениями и мерами. Вы можете провести инвентаризацию того, что уже доступно (чтобы избежать дубликатов и способствовать согласованности), и вы можете создавать новые повторно используемые измерения и меры, чтобы диаграммы на нескольких листах использовали одни и те же определения полей и выражения вычислений, улучшая управление, удобство обслуживания и выравнивание метрик.

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

Доступны следующие инструменты:

• Qlik_list_dimensionst: Вывод списка всех библиотечных измерений, доступных в приложении

• Qlik_create_dimension: Создание повторно используемого библиотечного измерения

• Qlik_update_dimension: Обновление существующего библиотечного измерения в приложении Qlik

• Qlik_delete_dimension: Удаление библиотечного измерения из приложения Qlik

• Qlik_list_measures: Вывод списка всех библиотечных мер, доступных в приложении

• Qlik_create_measure: Создание повторно используемой библиотечной меры с выражением

• Qlik_update_measure: Обновление существующей библиотечной меры в приложении Qlik

• Qlik_delete_measure: Удаление библиотечной меры из приложения Qlik

Пример промпта:

“Помогите мне стандартизировать метрики в нашем приложении Sales Performance. Сначала выведите список существующих библиотечных измерений и мер, чтобы мы ничего не дублировали. Затем создайте новое библиотечное измерение «Сегмент клиентов» на основе соответствующего поля сегмента и создайте повторно используемую меру «% валовой маржи», используя наше стандартное определение (валовая маржа, разделенная на доход, отформатированная в виде процента). После их создания скажите мне точные названия основных элементов, на которые я должен ссылаться при построении диаграмм, чтобы все информационные панели использовали одну и ту же логику.”

Выборки и фильтрация

Эти инструменты управляют состоянием интерактивного фильтра приложения Qlik:

• Применение выборок к одному или нескольким полям (с использованием точных значений или сопоставления в стиле шаблона-предиката).

• Проверка того, какие фильтры в настоящее время активны.

• Очистка выборок либо глобально, либо для определенного поля.

Вместе они поддерживают управляемые процессы анализа, воспроизводимые шаги исследования.

Доступны следующие инструменты:

• Qlik_select_values: Применение выборок (фильтров) к полям - поддерживает точные значения и сопоставление с шаблоном

  Примечание к информации

  Когда использовать выборки вместо анализа множеств:

  • Когда вы хотите отфильтровать все приложение или сеанс для нескольких последующих операций, используйте select_values().

  • Когда вам нужен одноразовый фильтр для конкретного вычисления, используйте анализ множеств в выражениях

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

  Примечание к предупреждению

  • Сначала используйте qlik_get_field_values() или qlik_search_field_values(), чтобы убедиться, что значения, которые вы хотите выбрать, существуют. Выбор несуществующих значений завершится ошибкой без уведомления.

  • Возвращаемые выборки являются фактической текущей примененной выборкой и являются истиной. Любые поля, в которых выборка не удалась, например: где значения не существовали, не появятся в возвращаемом списке.

• Qlik_clear_selections: Очистка выборок - всех или определенного поля

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

• Qlik_get_current_selections: Получение текущих активных выборок или фильтров в приложении

Пример промпта:

“Настройте мой контекст анализа для приложения Executive Sales: выберите Year = 2025 и Region = EMEA и примените выборку на основе шаблона к Product Category, чтобы включить только категории, начинающиеся с «Cloud». Затем покажите мне текущие выборки, чтобы я мог подтвердить, что активно. После того, как я просмотрю Ключевые показатели эффективности, очистите только выборку Product Category (оставьте Year и Region) и, наконец, очистите все выборки, чтобы сбросить приложение обратно в неотфильтрованное состояние.”

Визуализация и листы

Эти инструменты позволяют пользователям собирать информационные панели в приложении Qlik:

• Создание нового листа в качестве холста.

• Добавление визуализаций (диаграмм, таблиц, Ключевых показателей эффективности), настроенных с измерениями, мерами и параметрами отображения.

• Размещение панелей фильтров на листе, чтобы пользователи могли интерактивно срезать анализ.

Вместе они охватывают базовый рабочий процесс создания удобной страницы информационной панели самообслуживания.

Доступны следующие инструменты:

• Qlik_create_sheet: Создание нового пустого листа (информационной панели) в приложении

• Qlik_add_chart: Добавление визуализации (полоса, линия, круговая диаграмма, таблица, Ключевой показатель эффективности и т. д.) на лист

  Примечание к информации

  • Спланируйте структуру запроса перед выполнением вызовов инструментов.

  • Сначала проверьте существование значения даты с помощью qlik_search_field_values или qlik_get_field_values

  • Используйте анализ множеств вместо выборок на уровне приложения для одноразовых запросов

• Qlik_add_filter: Добавление панели фильтров на лист для фильтрации, управляемой пользователем

Пример промпта:

“Создайте новый лист под названием «Обзор продаж» в нашем аналитическом приложении. Добавьте Ключевой показатель эффективности для общего дохода и общего количества заказов, линейный график, показывающий доход по месяцам, и линейчатую диаграмму, показывающую доход по регионам (отсортированную по убыванию). Затем добавьте панель фильтров с Year, Region и Product Category, чтобы пользователи могли настроить представление. Убедитесь, что визуальные элементы имеют четкие названия, а лист готов для руководящей аудитории.”