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

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

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

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

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

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

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

Инструменты 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_semantic_search_app: Выполнить семантический поиск релевантных ресурсов в приложении Qlik.

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

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

• Используйте 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 и обобщите, какие диаграммы уже доступны и какие пробелы остаются.

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

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

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

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

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

• Connect those terms to real analytics assets (applications, datasets, fields, master items).

The following tools are available:

• 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: Обновить статус термина (черновик, проверенный, устаревший). Только стюард может проверить термин. Как только термин проверен, только стюард может изменить термин.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• 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_update_dataset_quality: Запросить вычисление качества данных для набора данных

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

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

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

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

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

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

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

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

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

• Анализ воздействия.

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

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

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

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

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

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

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

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

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

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

• 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 %’, используя наше стандартное определение (валовая прибыль, деленная на выручку, отформатированная как процент). После их создания сообщите мне точные названия основных элементов, на которые я должен ссылаться при построении диаграмм, чтобы все панели мониторинга использовали одну и ту же логику.”

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• Qlik_clear_selections: Очистить выборки — все или определенное поле

  Примечание к предупреждениюВозвращенные выборки — это фактически текущие примененные выборки, и они являются истиной. Any fields where selection failed for instance, values did not exist, will not appear in the returned list.

• Qlik_get_current_selections: Get currently active selections or filters in the app

• Qlik_update_filter: Обновить существующий Фильтр в приложении Qlik

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• Qlik_delete_object: Удалить объект из приложения Qlik (диаграмму, лист, фильтр и т. д.)

• Qlik_show_chart: Показать отрисованную визуализацию в виде снимка Qlik

• Qlik_update_chart: Обновить существующую визуализацию диаграммы в приложении Qlik

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

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