Qlik narzędzia MCP

Serwer Qlik MCP zawiera narzędzia, które umożliwiają Twojemu LLM wykonywanie działań w Twojej Qlik Cloud dzierżawie. Możesz dostosować swoje środowisko, wybierając, które Qlik narzędzia MCP chcesz mieć dostępne.

Dostęp i uprawnienia oraz Qlik narzędzia MCP

Dostęp do narzędzi MCP jest kontrolowany przez Twoje uprawnienia. Wymagasz uprawnienia Qlik MCP: Allowed w roli niestandardowej, aby uzyskać dostęp do Qlik narzędzi MCP z klienta LLM.

Dodatkowo, ponieważ narzędzie Qlik MCP jest autoryzowane jako użytkownik łączący się, wykorzystuje ono Twoją istniejącą rolę użytkownika i uprawnienia do przestrzeni. Musisz również mieć uprawnienia w Qlik Cloud, aby korzystać z możliwości lub typu zawartości używanego przez narzędzia. Na przykład, jeśli nie masz uprawnień do dostępu do pochodzenia w Qlik Cloud, nie możesz użyć narzędzia Qlik MCP Qlik pobierz pochodzenie. W zależności od Twoich uprawnień, niektóre narzędzia mogą odpowiedzieć brakiem dostępu, jeśli nie możesz użyć możliwości lub cechy w Qlik Cloud.

Dostępność narzędzi może być również ograniczona przez licencjonowanie Twojej dzierżawy.

Wybieranie Qlik narzędzi MCP

Narzędzia Qlik MCP to katalog specjalnie stworzonych akcji, które LLM może wywołać w celu wykonania działań w Twojej dzierżawie Qlik Cloud. Działania te obejmują:

• Znajdowanie aplikacji i zestawów danych

• Inspekcja pól i metadanych wykresu

• Stosowanie i czyszczenie filtrów

• Tworzenie arkuszy i wykresów

• Zarządzanie zarządzanymi zasobami, takimi jak terminy słownikowe i produkty danych.

Każde narzędzie reprezentuje określoną funkcjonalność z dobrze zdefiniowanymi danymi wejściowymi i wyjściowymi.

Dostępne Narzędzia Qlik MCP

Poniższa tabela przedstawia przegląd bieżących kategorii narzędzi Qlik MCP i nazw narzędzi.

Co każde z narzędzi może osiągnąć

Odkrywanie aplikacji i metadane

Użyj tych narzędzi, aby znaleźć odpowiednią Qlik aplikację analityczną i szybko zrozumieć, co się w niej znajduje, zanim zbudujesz wykresy lub zastosujesz filtry. Ta kategoria obsługuje kompleksowy przepływ odnajdywania: wyszukiwanie w zasobach Qlik w celu zlokalizowania odpowiednich aplikacji.

Dostępne są następujące narzędzia:

• Qlik_search: Wyszukaj Qlik zasoby (aplikacje, zbiory danych, produkty danych, glosariusze) według nazwy lub zawartości.

• Qlik_describe_apps: Pobierz kompleksowe metadane dla aplikacji, w tym pola, właściciela, status publikacji.

• Qlik_get_fields: Wyświetla listę wszystkich pól danych dostępnych w aplikacji do użycia jako wymiary.

• Qlik_list_sheets: Wyświetla listę wszystkich arkuszy w aplikacji.

• Qlik_get_sheet_details: Pobierz szczegóły dotyczące konkretnego arkusza, w tym wszystkie wykresy i ich typy.

• Qlik_search_spaces: Wyszukaj przestrzenie na podstawie ciągu zapytania.

• Qlik_semantic_search_app: Wykonaj wyszukiwanie semantyczne dla odpowiednich zasobów w aplikacji Qlik.

Przykład monitu:

"Muszę przeanalizować rezygnację klientów." To proste zapytanie pozwala na:

• Użyj qlik_search, aby znaleźć aplikacje związane z „rezygnacją klientów” lub „utrzymaniem klientów”.

• Aby uzyskać najlepsze dopasowanie, uruchom qlik_describe_app, aby potwierdzić, że jest to właściwa aplikacja i wyświetlić jej metadane (właściciela i status publikacji).

• Użyj qlik_get_fields, aby wyświetlić dostępne pola i zidentyfikować kandydatów na wymiary i miary, takie jak Customer, ChurnFlag, SubscriptionType, Region i ChurnDate.

• Użyj qlik_list_sheets , aby zobaczyć, jakie pulpity nawigacyjne już istnieją.

• Dla każdego obiecującego arkusza, na przykład „Przegląd rezygnacji”, wywołaj qlik_get_sheet_details i podsumuj, jakie wykresy są już dostępne i jakie luki pozostają.

Słownik biznesowy

Ten zestaw narzędzi umożliwia użytkownikowi kompleksowe skonfigurowanie i utrzymywanie zarządzanego słownika biznesowego:

• Tworzenie słownika

• Uporządkuj to za pomocą kategorii

• Dodawaj i zarządzaj terminami (w tym edytowanie, usuwanie i zarządzanie statusem cyklu życia, takim jak roboczy -zweryfikowany-przestarzały)

• Połącz te terminy z rzeczywistymi zasobami analitycznymi (aplikacjami, zbiorami danych, polami, elementami głównymi).

Dostępne są następujące narzędzia:

• Qlik_create_glossary: Utwórz nowy słownik biznesowy

• Qlik_get_full_glossary_export: Pobierz kompletny słownik ze wszystkimi terminami, kategoriami, linkami (kosztowna operacja)

• Qlik_get_glossary_categories: Pobierz wszystkie kategorie dla glosariusza

• Qlik_create_glossary_category: Utwórz nową kategorię w glosariuszu

• Qlik_search_glossary_terms: Wyszukaj terminy w glosariuszu

• Qlik_get_glossary_term: Pobierz konkretny termin z glosariusza

• Qlik_create_glossary_term: Utwórz nowy termin słownika z opisem, tagami, relacjami

• Qlik_update_glossary_term: Modyfikuj istniejący termin słownika

• Qlik_delete_glossary_term: Usuń termin słownikowy

• Qlik_update_term_status: Zaktualizuj status terminu (roboczy, zweryfikowany, przestarzały). Tylko steward może zweryfikować termin. Po zweryfikowaniu terminu tylko steward może zmodyfikować termin.

  Informacja

  Ta operacja ma trzy statusy:

  • wersja robocza: Termin jest w stanie roboczym.

  • zweryfikowano: Termin został zweryfikowany przez zarządcę.

  • przestarzałe: Termin jest przestarzały i nie powinien być używany.

  Nazwy statusów są wrażliwe na wielkość liter i muszą być podane dokładnie tak, jak powyżej.

• Qlik_get_glossary_term_links: Pobierz zasoby połączone z terminem słownikowym

  Ta funkcja obsługuje dwa tryby:

  • Tryb pojedynczego łącza: Podaj pojedyncze parametry dla instancji resource_id lub resource_type.

  • Tryb wsadowy: Podaj listę słowników linków za pośrednictwem parametru 'links'

  Informacja

  Podczas łączenia z podzasobem wszystkie trzy pola podzasobu (subResourceId, subResourceName i subResourceType) muszą być podane razem dla każdego linku.

• Qlik_create_glossary_term_links: Połącz termin z aplikacjami, zestawami danych, polami, elementami głównymi

Przykład monitu:

Pomóż mi zbudować Słownik Biznesowy i zarządzać nim dla naszej domeny Sprzedaży. Utwórz słownik o nazwie „Słownik Sprzedaży”, dodaj kategorie „Przychody”, „Klienci” i „Potok Sprzedaży”. Następnie utwórz terminy dla „Rocznych Przychodów Powtarzalnych (ARR)” i „Odpływu Klientów” z jasnymi definicjami i tagami, na przykład finanse i sales-ops, ustaw je jako wersje robocze i połącz każdy termin z odpowiednimi polami zestawu danych oraz elementami głównymi wskaźników KPI."

Zestawy danych i jakość danych

Te narzędzia pomagają użytkownikowi zrozumieć, walidować i zarządzać zbiorami danych poprzez sprawdzenie, czym jest zbiór danych (metadane i członkostwa w produktach danych), co zawiera (schemat), jak wyglądają dane (statystyki profilowania – rozkłady i szybka próbka wierszy). Narzędzia wspierają również procesy zarządzania danymi: ulepszanie dokumentacji zbioru danych (nazwa-opis) oraz wyzwalanie i monitorowanie obliczeń jakości danych w celu odświeżania metryk jakości w czasie.

Dostępne są następujące narzędzia:

• Qlik_get_dataset: Ładuje metadane zbioru danych, w tym wynik zaufania

• Qlik_get_dataset_schema: Wczytaj schemat (definicje kolumn) zbioru danych

• Qlik_get_dataset_profile: Wczytaj dane profilu (statystyki, rozkłady) zbioru danych

• Qlik_get_dataset_sample: Wczytaj pierwsze 10 wierszy zbioru danych do podglądu

• Qlik_get_dataset_freshness: Pobierz ostatnio zaktualizowany znacznik czasu zbioru danych

• Qlik_get_dataset_trust_score: Pobierz wynik zaufania zestawu danych

• Qlik_get_dataset_memberships: Pobierz członkostwa produktu danych dla zestawu danych

• Qlik_update_dataset_metadata: Zaktualizuj nazwę i opis zestawu danych

• Qlik_update_dataset_quality: Zażądaj obliczenia jakości danych dla zestawu danych

• Qlik_update_dataset_quality: Zleć obliczenie jakości danych dla zestawu danych

• Qlik_get_dataset_quality_computation_status: Sprawdź status obliczenia jakości

Przykład monitu:

„Oceń gotowość naszego zbioru danych Zamówienia Klientów do nowego pulpitu nawigacyjnego. Pokaż mi jego metadane i bieżący wynik zaufania, potwierdź czas ostatniego odświeżenia i wymień, do których produktów danych należy. Następnie załaduj schemat i 10-wierszową próbkę, aby sprawdzić pola klucza, takie jak order_date, customer_id i net_amount. Uruchom profil zestawu danych, aby wykryć brakujące wartości i wartości odstające, a jeśli metryki jakości wydają się nieaktualne, uruchom obliczanie jakości danych i sprawdzaj status zadania, aż zostanie ukończone. Na koniec, zaktualizuj opis zestawu danych, aby udokumentować znane ograniczenia i zalecane użycie.”

Eksploracja danych & Analiza

Narzędzia te wspierają szybką i doraźną analizę danych oraz istniejących treści analitycznych, bez konieczności trwałego tworzenia nowych wizualizacji przez użytkownika. Możesz tworzyć tymczasowe obliczenia lub obiekty zapytań, aby odpowiedzieć na pytania typu „co by było, gdyby”, sprawdzać pola, wyświetlając unikalne wartości, lub wyszukiwać określone wartości.

Dostępne są następujące narzędzia:

• Qlik_create_data_object: Tworzy tymczasowe obiekty obliczeniowe dla zapytań analitycznych ad hoc

  Informacja

  Użyj get_field_values() lub search_field_values() przed zastosowaniem zaznaczeń, aby sprawdzić, czy wartości istnieją.

  Ostrzeżenie

  Qlik wykonuje WSZYSTKIE obliczenia, dlatego:

  • Nigdy nie agreguj, nie sumuj, nie uśredniaj ani nie obliczaj na zwróconych danych: wartości są ostateczne.

  • Dla różnych obliczeń, wywołaj narzędzie ponownie z nowymi wyrażeniami.

  • Zawsze stosuj odpowiednie filtry-selekcje, aby ograniczyć rozmiar danych i poprawić wydajność.

• Qlik_get_field_values: Uzyskaj unikalne wartości dla określonego pola (użyj przed filtrowaniem)

  Informacja

  Dla pól o wysokiej kardynalności zawsze używaj qlik_search_field_values() zamiast tego

  Ostrzeżenie

  Użyj tego narzędzia lub qlik_search_field_values() PRZED utworzeniem selekcji-filtrów, aby sprawdzić, czy wartości istnieją. Pomaga to uniknąć błędów podczas stosowania filtrów z nieistniejącymi wartościami.

• Qlik_search_field_values: Wyszukaj określone wartości w polach (zweryfikuj przed analizą zbioru)

  Ostrzeżenie

  Przed utworzeniem obiektów danych za pomocą analizy zbioru lub selekcji: Użyj qlik_search_field_values, aby zweryfikować istnienie wartości. Zapobiega to błędom wynikającym z nieistniejących wartości filtrów, szczególnie ważne dla: lat, dat, kodów walut, nazw produktów.

  Najlepsza praktyka, przykładowy przepływ pracy:

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

  2. Zweryfikuj, czy "2022" istnieje w wynikach

  3. Utwórz obiekt danych, używając {payment_year={2022}.

• Qlik_get_chart_data: Pobierz stronicowane dane z istniejącej wizualizacji wykresu

• Qlik_get_chart_info: Pobierz metadane o wykresie bez pobierania jego danych

Przykład monitu:

„Pomóż mi zbadać, dlaczego przychody regionu Północ spadły w zeszłym miesiącu. Najpierw sprawdź istniejący wykres „Przychody według regionu”: pokaż mi jego metadane (wymiary, miary, filtry, liczbę wierszy), a następnie pobierz dane wykresu za ostatnie dwa miesiące. Zanim zastosuję jakiekolwiek zaznaczenia, wymień unikalne wartości dla Regionu i przeszukaj wartości pól, aby potwierdzić, czy użyto „North”, „NORTH” lub „Northern”. Następnie utwórz tymczasowe obliczenie, aby porównać przychody i marże miesiąc do miesiąca dla Północy w porównaniu z innymi regionami, i wyróżnij, które kategorie produktów najbardziej przyczyniły się do zmiany.”

Produkty danych

Te narzędzia zarządzają pełnym cyklem życia produktu danych jako zarządzany, możliwy do udostępniania pakiet zbiorów danych:

1. Utwórz go.

2. Sprawdź jego metadane i dokumentację.

3. Utrzymaj jego definicję (nazwa, opis i które zestawy danych zawiera)

4. Kontroluj, gdzie i czy jest dostępny, przenosząc go między przestrzeniami oraz aktywując lub dezaktywując go.

Obsługują również czyszczenie po zakończeniu cyklu życia poprzez usunięcie produktu danych, gdy nie jest już potrzebny.

Dostępne są następujące narzędzia:

• Qlik_create_data_product: Utwórz nowy produkt danych

• Qlik_get_data_product: Pobierz metadane dla określonego produktu danych

• Qlik_get_data_product_documentation: Pobierz dokumentację w formacie Markdown produktu danych

• Qlik_update_data_product: Zaktualizuj właściwości (nazwę, opis, zbiory danych) produktu danych

• Qlik_update_data_product_space: Przenieś produkt danych do innej przestrzeni

• Qlik_update_activate_data_product: Aktywuj produkt danych w określonej przestrzeni

• Qlik_update_deactivate_data_product: Dezaktywuj produkt danych

• Qlik_delete_data_product: Usuń produkt danych

Przykład monitu:

„Utwórz produkt danych o nazwie „Sales Analytics – Curated” z jasnym opisem i uwzględnij następujące zestawy danych: Orders, Customers i Products. Następnie pokaż mi metadane produktu danych i pobierz jego dokumentację markdown, abym mógł przejrzeć, co zobaczą konsumenci. Zaktualizuj opis, aby dodać wskazówki dotyczące użytkowania i dodaj również zestaw danych Returns. Przenieś produkt danych do naszej wspólnej przestrzeni „Analytics”, aktywuj go tam, aby uzyskać szerszy dostęp, a jeśli później zastąpimy go nową wersją, dezaktywuj stary. Na koniec, jeśli produkt zostanie całkowicie wycofany i nie będzie już do niego odwołań, usuń go.”

Pochodzenie

To narzędzie pozwala użytkownikowi śledzić, skąd pochodzą dane i jak przepływają, poprzez pobieranie pochodzenia danych nadrzędnych dla zestawu danych lub aplikacji. Ponieważ każde wywołanie zwraca tylko jeden krok wstecz, zazwyczaj powtarza się je rekurencyjnie, aby zbudować pełny łańcuch. Jest to przydatne do:

• Analiza wpływu.

• Rozwiązywanie problemów z nieoczekiwanymi liczbami.

• Zarządzanie lub audyt.

• Identyfikowanie prawdziwych źródeł zasilających raport lub zestaw danych.

Dostępne są następujące narzędzia:

• Qlik_get_lineage: Wczytaj historię pochodzenia zbioru danych lub aplikacji (wywołaj rekurencyjnie dla pełnego łańcucha)

Przykład monitu:

“Pokaż mi pełne pochodzenie w górę strumienia dla zbioru danych Zamówienia klientów. Zacznij od zestawu danych i cofaj się rekurencyjnie, aż dotrzesz do oryginalnych systemów źródłowych. Dla każdego kroku podsumuj, co jest bezpośrednim elementem nadrzędnym, i zanotuj wszelkie kluczowe transformacje, pośrednie zestawy danych lub zaangażowane aplikacje. W takim razie powiedz mi, które źródło nadrzędne najprawdopodobniej wpłynie na pole net_amount, jeśli się zmieni.”

Elementy główne (Wymiary & Miary)

Te narzędzia pomagają użytkownikom standaryzować i ponownie wykorzystywać kluczową logikę biznesową w aplikacji, pracując z głównymi wymiarami (biblioteki) i miarami. Możesz zinwentaryzować to, co jest już dostępne (aby uniknąć duplikowania i zachęcić do spójności), i możesz tworzyć nowe wymiary i miary wielokrotnego użytku, aby wykresy w wielu arkuszach używały tych samych definicji pól i wyrażeń obliczeniowych, poprawiając zarządzanie, łatwość konserwacji i wyrównanie metryk.

Dostępne są następujące narzędzia:

• Qlik_list_dimensionst: Wyświetl wszystkie wymiary biblioteki dostępne w aplikacji

• Qlik_create_dimension: Utwórz wymiar biblioteki wielokrotnego użytku

• Qlik_update_dimension: Zaktualizuj istniejący wymiar biblioteki w aplikacji Qlik

• Qlik_delete_dimension: Usuń wymiar biblioteki z aplikacji Qlik

• Qlik_list_measures: Wyświetl wszystkie miary biblioteki dostępne w aplikacji

• Qlik_create_measure: Utwórz miarę biblioteczną wielokrotnego użytku z wyrażeniem

• Qlik_update_measure: Zaktualizuj istniejącą miarę biblioteczną w aplikacji Qlik

• Qlik_delete_measure: Usuń miarę z biblioteki z aplikacji Qlik

Przykład monitu:

„Pomóż mi ustandaryzować metryki w naszej aplikacji Sales Performance. Najpierw wymień istniejące wymiary i miary biblioteki, abyśmy niczego nie duplikowali. Następnie utwórz nowy wymiar biblioteki „Segment klienta” na podstawie odpowiedniego pola segmentu i utwórz miarę wielokrotnego użytku „Marża brutto %” korzystając z naszej standardowej definicji (marża brutto podzielona przez przychód, sformatowana jako procent). Po ich utworzeniu, podaj mi dokładne nazwy elementów głównych, do których powinienem się odwoływać podczas tworzenia wykresów, aby wszystkie pulpity nawigacyjne używały tej samej logiki.”

Wybory & filtrowanie

Te narzędzia kontrolują interaktywny stan filtra aplikacji Qlik:

• Zastosuj zaznaczenia do jednego lub większej liczby pól (używając dokładnych wartości lub dopasowania w stylu predykatu wzorca).

• Sprawdź, jakie filtry są obecnie aktywne.

• Wyczyść zaznaczenia globalnie albo dla określonego pola.

Razem wspierają kierowane przepływy analizy, powtarzalne kroki dochodzeniowe.

Dostępne są następujące narzędzia:

• Qlik_select_values: Zastosuj zaznaczenia (filtry) do pól - obsługuje dokładne wartości i dopasowywanie wzorców

  Informacja

  Kiedy używać zaznaczeń zamiast analizy zbiorów:

  • Gdy chcesz filtrować całą aplikację lub sesję dla wielu kolejnych operacji, użyj select_values().

  • Gdy potrzebujesz jednorazowego filtra dla konkretnego obliczenia, użyj set analysis w wyrażeniach

  Zaznaczenia utrzymują się we wszystkich operacjach, dopóki nie zostaną wyczyszczone; wpływają na WSZYSTKIE kolejne pobierania danych. Zgodnie z najlepszymi praktykami, w przypadku pojedynczych zapytań analitycznych, preferuj analizę zbiorów zamiast zaznaczeń, aby uniknąć narzutu zarządzania stanem.

  Ostrzeżenie

  • Użyj qlik_get_field_values() lub qlik_search_field_values() najpierw, aby sprawdzić, czy wartości, które chcesz wybrać, istnieją. Wybranie nieistniejących wartości spowoduje cichą awarię.

  • Zwrócone zaznaczenia są faktycznie aktualnie zastosowanymi zaznaczeniami i są prawdziwe. Wszelkie pola, w których zaznaczenie nie powiodło się, na przykład: gdzie wartości nie istniały, nie pojawią się na zwróconej liście.

• Qlik_clear_selections: Czyść zaznaczenia - wszystkie lub określone pole

  OstrzeżenieZwrócone zaznaczenia są rzeczywistym aktualnie zastosowanym zaznaczeniem i są prawdą. 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: Zaktualizuj istniejący panel filtrowania w aplikacji Qlik

Przykład monitu:

„Skonfiguruj mój kontekst analizy dla aplikacji Executive Sales: wybierz Rok = 2025 i Region = EMEA, i zastosuj wybór oparty na wzorcu dla Kategorii Produktu, aby uwzględnić tylko kategorie zaczynające się od „Cloud”. Następnie pokaż mi bieżące zaznaczenia, abym mógł potwierdzić, co jest aktywne. Po przejrzeniu wskaźników KPI, wyczyść tylko wybór kategorii produktu (zachowaj Rok i Region), a na koniec wyczyść wszystkie wybory, aby zresetować aplikację do stanu niefiltrowanego.”

Wizualizacja & Arkusze

Te narzędzia pozwalają użytkownikom tworzyć pulpity nawigacyjne w aplikacji Qlik:

• Utwórz nowy arkusz jako płótno.

• Dodaj wizualizacje (wykresy, tabele, wskaźniki KPI.) skonfigurowane z wymiarami, miarami i opcjami wyświetlania.

• Umieść panele filtrowania na arkuszu, aby użytkownicy mogli interaktywnie segmentować analizę.

Razem obejmują podstawowy przepływ pracy tworzenia użytecznej, samoobsługowej strony pulpitu nawigacyjnego.

Dostępne są następujące narzędzia:

• Qlik_create_sheet: Utwórz nowy pusty arkusz (pulpit nawigacyjny) w aplikacji

• Qlik_add_chart: Dodaj wizualizację (słupek, liniowy, kołowy, tabela, wskaźnik KPI itp.) do arkusza

  Informacja

  • Zaplanuj strukturę zapytania przed wykonaniem wywołań narzędzi.

  • Sprawdź istnienie wartości daty za pomocą qlik_search_field_values lub qlik_get_field_values najpierw

  • Użyj analizy zbiorów na wyborach na poziomie aplikacji dla jednorazowych zapytań

• Qlik_add_filter: Dodaj panel filtrowania do arkusza dla filtrowania sterowanego przez użytkownika

• Qlik_delete_object: Usuń obiekt z aplikacji Qlik (wykres, arkusz, filtr itd.)

• Qlik_show_chart: Pokaż wyrenderowaną wizualizację jako migawkę Qlik

• Qlik_update_chart: Zaktualizuj istniejącą wizualizację wykresu w aplikacji Qlik

Przykład monitu:

„Utwórz nowy arkusz o nazwie „Przegląd sprzedaży” w naszej aplikacji analitycznej. Dodaj wskaźnik KPI dla całkowitego przychodu i całkowitej liczby zamówień, wykres liniowy pokazujący przychody według miesiąca oraz wykres słupkowy pokazujący przychody według regionu (posortowane malejąco). Następnie dodaj panel filtrowania z rokiem, regionem i kategorią produktu, aby użytkownicy mogli dostosować widok. Upewnij się, że wizualizacje są jasno zatytułowane, a arkusz jest gotowy dla odbiorców z kadry kierowniczej.”