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

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

Разрешения доступа и инструменты MCP Qlik

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Поиск приложений и метаданные

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

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

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

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

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

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

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

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

Пример запроса:

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

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

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

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

• Использовать qlik_list_sheets для просмотра уже существующих дашбордов.

• Для любого перспективного листа, например «Churn Overview», вызвать 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: связывание термина с приложениями, наборами данных, полями, основными элементами

Пример запроса:

«Помоги мне создать и настроить контроль для бизнес-глоссария для нашего домена продаж. Создай глоссарий с именем «Sales Glossary», добавь категории «Revenue», «Customers» и «Pipeline». Затем создай термины для «Annual Recurring Revenue (ARR)» и «Customer Churn» с четкими определениями и тегами, например finance и sales-ops, установи для них статус draft и свяжи каждый термин с соответствующими полями набора данных и основными элементами KPI.»

Datasets and Data Quality

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

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

• 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. Запусти профилирование набора данных, чтобы обнаружить пропущенные значения и выбросы, и, если показатели качества кажутся устаревшими, запусти вычисление качества данных и проверяй статус задачи, пока она не завершится. Наконец, обнови описание набора данных, чтобы задокументировать известные ограничения и рекомендуемое использование.»

Data Exploration & Analysis

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

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

• 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. Сначала проверь существующую диаграмму «Revenue by Region»: покажи мне ее метаданные (измерения, меры, фильтры, количество строк), а затем извлеки данные диаграммы за последние два месяца. Прежде чем я применю какие-либо выборки, выведи список уникальных значений для Region и выполни поиск по значениям полей, чтобы подтвердить, используется ли «North», «NORTH» или «Northern». Затем создай временное вычисление для сравнения выручки и маржи по месяцам для региона North по сравнению с другими регионами и выдели, какие категории продуктов внесли наибольший вклад в это изменение.»

Data Products

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

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: удаление продукта данных

Пример запроса:

«Создай продукт данных с именем «Sales Analytics – Curated» и понятным описанием, включив в него следующие наборы данных: Orders, Customers и Products. Затем покажи мне метаданные продукта данных и извлеки его документацию в формате markdown, чтобы я мог просмотреть, что увидят потребители. Обнови описание, добавив руководство по использованию, а также добавь набор данных Returns. Перемести продукт данных в наше общее пространство «Analytics», активируй его там для более широкого доступа, и, если мы позже заменим его новой версией, деактивируй старую. Наконец, если продукт полностью выведен из эксплуатации и на него больше нет ссылок, удали его.»

Lineage

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

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

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

• Контроля или аудита.

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

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

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

Пример запроса:

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

Master Items (Dimensions & Measures)

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

Вы можете обновлять свои основные элементы новыми определениями, что позволяет быстро вносить изменения. Вы также можете удалять основные элементы. Например, вы можете попросить своего клиента 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. Сначала выведи список существующих библиотечных измерений и мер, чтобы мы ничего не дублировали. Затем создай новое библиотечное измерение «Customer Segment» на основе соответствующего поля сегмента и создай повторно используемую меру «Gross Margin %» с использованием нашего стандартного определения (валовая маржа, деленная на выручку, в процентах). После их создания сообщи мне точные имена основных элементов, на которые мне следует ссылаться при создании диаграмм, чтобы все дашборды использовали одну и ту же логику.»

Selections & Filtering

Эти инструменты управляют интерактивным состоянием фильтра приложения 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». Затем покажи мне текущие выборки, чтобы я мог подтвердить, что активно. После того как я просмотрю KPI, очисти только выборку Product Category (сохрани Year и Region) и, наконец, очисти все выборки, чтобы вернуть приложение в исходное неотфильтрованное состояние.»

Visualization & Sheets

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

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

• Добавление визуализаций (диаграмм, таблиц, KPI), настроенных с использованием измерений, мер и параметров отображения.

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

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

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

• Qlik_create_sheet: создание нового пустого листа (дашборда) в приложении

• Qlik_add_chart: добавление визуализации (линейчатой диаграммы, линейного графика, круговой диаграммы, таблицы, KPI и т. д.) на лист

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

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

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

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

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

Пример запроса:

«Создай новый лист с именем «Sales Overview» в нашем аналитическом приложении. Добавь KPI для Total Revenue и Total Orders, линейный график, показывающий Revenue by Month, и линейчатую диаграмму, показывающую Revenue by Region (отсортированную по убыванию). Затем добавь панель фильтров с Year, Region и Product Category, чтобы пользователи могли настраивать представление. Убедись, что визуальные элементы имеют четкие названия, а лист готов для руководства.»