Narzędzia MCP Qlik

Serwer MCP Qlik zawiera narzędzia, które pozwalają Twojemu LLM wykonywać działania w Twojej dzierżawie Qlik Cloud. Możesz dostosować swoje środowisko, wybierając, które narzędzia MCP Qlik mają być dostępne.

Uprawnienia dostępu i narzędzia MCP Qlik

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

Dodatkowo, ponieważ narzędzie MCP Qlik jest autoryzowane jako łączący się użytkownik, korzysta z Twojej istniejącej roli użytkownika i uprawnień do przestrzeni. Musisz również mieć uprawnienia w Qlik Cloud, aby korzystać z możliwości lub typu zawartości używanych przez narzędzia. Na przykład, jeśli nie masz uprawnień dostępu do pochodzenia w Qlik Cloud, nie możesz użyć narzędzia MCP Qlik Qlik get lineage. 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 narzędzi MCP Qlik

Narzędzia MCP Qlik to katalog specjalnie zbudowanych działań, 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

• Sprawdzanie pól i metadanych wykresów

• Stosowanie i czyszczenie filtrów

• Tworzenie arkuszy i wykresów

• Zarządzanie nadzorowanymi zasobami, takimi jak terminy słownika i produkty danych.

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

Dostępne narzędzia MCP Qlik

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

Co mogą osiągnąć poszczególne narzędzia

Wykrywanie aplikacji i metadane

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

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

• Qlik_search: Wyszukiwanie zasobów Qlik (aplikacje, zestawy danych, produkty danych, słowniki) według nazwy lub zawartości.

• Qlik_describe_apps: Pobieranie kompleksowych metadanych dla aplikacji, w tym pól, właściciela, statusu publikacji.

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

• Qlik_list_sheets: Wyświetlanie listy wszystkich arkuszy w aplikacji.

• Qlik_get_sheet_details: Pobieranie szczegółów dotyczących określonego arkusza, w tym wszystkich wykresów i ich typów.

• Qlik_search_spaces: Wyszukiwanie przestrzeni na podstawie ciągu zapytania.

Przykład monitu:

"Muszę przeanalizować rezygnację klientów." Ten prosty monit pozwala na:

• Użycie qlik_search w celu znalezienia aplikacji związanych z „rezygnacją” lub „utrzymaniem klientów”.

• W przypadku najlepszego dopasowania, uruchomienie qlik_describe_app, aby potwierdzić, że jest to właściwa aplikacja i zobaczyć jej metadane (właściciela i status publikacji).

• Użycie qlik_get_fields w celu wyświetlenia listy dostępnych pól i zidentyfikowania kandydujących wymiarów i miar, takich jak Customer, ChurnFlag, SubscriptionType, Region i ChurnDate.

• Użycie qlik_list_sheets w celu sprawdzenia, jakie pulpity nawigacyjne już istnieją.

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

Słownik biznesowy

Ten zestaw narzędzi pozwala użytkownikowi na kompleksowe konfigurowanie i utrzymywanie nadzorowanego słownika biznesowego:

• Tworzenie słownika

• Organizowanie go za pomocą kategorii

• Dodawanie i selekcjonowanie terminów (w tym edytowanie, usuwanie i zarządzanie statusem cyklu życia, takim jak wersja robocza - zweryfikowany - przestarzały)

• Łączenie tych terminów z rzeczywistymi zasobami analitycznymi (aplikacje, zestawy danych, pola, elementy główne).

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

• Qlik_create_glossary: Tworzenie nowego słownika biznesowego

• Qlik_get_full_glossary_export: Pobieranie kompletnego słownika ze wszystkimi terminami, kategoriami, łączami (kosztowna operacja)

• Qlik_get_glossary_categories: Pobieranie wszystkich kategorii dla słownika

• Qlik_create_glossary_category: Tworzenie nowej kategorii w słowniku

• Qlik_search_glossary_terms: Wyszukiwanie terminów w słowniku

• Qlik_get_glossary_term: Pobieranie określonego terminu ze słownika

• Qlik_create_glossary_term: Tworzenie nowego terminu słownika z opisem, tagami, relacjami

• Qlik_update_glossary_term: Modyfikowanie istniejącego terminu słownika

• Qlik_delete_glossary_term: Usuwanie terminu słownika

• Qlik_update_term_status: Aktualizowanie statusu terminu (wersja robocza, zweryfikowany, przestarzały). Tylko opiekun może zweryfikować termin. Po zweryfikowaniu terminu tylko opiekun może go modyfikować

  Informacja

  Ta operacja ma trzy statusy:

  • draft: Termin jest w stanie wersji roboczej.

  • verified: Termin został zweryfikowany przez opiekuna.

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

  Nazwy statusów uwzględniają wielkość liter i muszą być podane dokładnie tak, jak powyżej.

• Qlik_get_glossary_term_links: Pobieranie zasobów powiązanych z terminem słownika

  Ta funkcja obsługuje dwa tryby:

  • Tryb pojedynczego łącza: Podaj poszczególne parametry, na przykład resource_id lub resource_type.

  • Tryb wsadowy: Podaj listę słowników łączy za pomocą parametru „links”

  Informacja

  W przypadku łączenia z zasobem podrzędnym wszystkie trzy pola zasobu podrzędnego (subResourceId, subResourceName i subResourceType) muszą być podane razem dla każdego łącza.

• Qlik_create_glossary_term_links: Łączenie terminu z aplikacjami, zestawami danych, polami, elementami głównymi

Przykład monitu:

"Pomóż mi zbudować i nadzorować słownik biznesowy dla naszej domeny sprzedaży. Utwórz słownik o nazwie „Słownik sprzedaży”, dodaj kategorie „Przychody”, „Klienci” i „Lejek sprzedaży”. Następnie utwórz terminy dla „Rocznych powtarzalnych przychodów (ARR)” i „Rezygnacji klientów” z jasnymi definicjami i tagami, na przykład finanse i operacje sprzedaży, ustaw je jako wersje robocze i połącz każdy termin z odpowiednimi polami zestawu danych i elementami głównymi wskaźników KPI."

Zestawy danych i jakość danych

Te narzędzia pomagają użytkownikowi zrozumieć, zweryfikować i nadzorować zestawy danych poprzez sprawdzanie, czym jest zestaw danych (metadane i członkostwo w produktach danych), co zawiera (schemat), jak wyglądają dane (statystyki profilowania-rozkłady i szybka próbka wierszy). Narzędzia obsługują również przepływy pracy związane z zarządzaniem: ulepszanie dokumentacji zestawu 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: Ładowanie metadanych zestawu danych, w tym wskaźnika zaufania

• Qlik_get_dataset_schema: Ładowanie schematu (definicji kolumn) zestawu danych

• Qlik_get_dataset_profile: Ładowanie danych profilu (statystyk, rozkładów) zestawu danych

• Qlik_get_dataset_sample: Ładowanie pierwszych 10 wierszy zestawu danych do podglądu

• Qlik_get_dataset_freshness: Pobieranie znacznika czasu ostatniej aktualizacji zestawu danych

• Qlik_get_dataset_trust_score: Pobieranie wskaźnika zaufania zestawu danych

• Qlik_get_dataset_memberships: Pobieranie członkostwa w produktach danych dla zestawu danych

• Qlik_update_dataset_metadata: Aktualizowanie nazwy i opisu zestawu danych

• Qlik_update_dataset_quality: Żądanie obliczenia jakości danych dla zestawu danych

• Qlik_get_dataset_quality_computation_status: Sprawdzanie statusu obliczania jakości

Przykład monitu:

„Oceń gotowość naszego zestawu danych Zamówienia klientów dla nowego pulpitu nawigacyjnego. Pokaż mi jego metadane i bieżący wskaźnik zaufania, potwierdź czas ostatniego odświeżenia i wymień, do jakich produktów danych należy. Następnie załaduj schemat i 10-wierszową próbkę, aby sprawdzić poprawność pól klucza, takich 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 wyglądają na nieaktualne, wyzwól obliczanie jakości danych i sprawdzaj status zadania, aż do jego zakończenia. Na koniec zaktualizuj opis zestawu danych, aby udokumentować znane ograniczenia i zalecane użycie.”

Eksploracja i analiza danych

Te narzędzia obsługują szybkie i doraźne badanie danych i istniejącej zawartości analitycznej bez konieczności trwałego budowania nowych wizualizacji przez użytkownika. Możesz tworzyć tymczasowe obliczenia lub obiekty zapytań, aby odpowiadać na pytania typu „co by było, gdyby”, sprawdzać pola, wyświetlając listę unikalnych wartości lub wyszukiwać określone wartości.

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

• Qlik_create_data_object: Tworzenie tymczasowych obiektów obliczeniowych dla doraźnych zapytań analitycznych

  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 wykonuj obliczeń na zwróconych danych: wartości są ostateczne.

  • W przypadku innych obliczeń wywołaj narzędzie ponownie z nowymi wyrażeniami.

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

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

  Informacja

  W przypadku pól o dużej liczności zawsze używaj zamiast tego qlik_search_field_values()

  Ostrzeżenie

  Użyj tego narzędzia lub qlik_search_field_values() PRZED utworzeniem zaznaczeń-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: Wyszukiwanie określonych wartości w polach (sprawdź przed analizą zestawów)

  Ostrzeżenie

  Przed utworzeniem obiektów danych z analizą zestawów lub zaznaczeniami: Użyj qlik_search_field_values, aby sprawdzić, czy wartości istnieją. Zapobiega to błędom wynikającym z nieistniejących wartości filtrów, co jest szczególnie ważne w przypadku: lat, dat, kodów walut, nazw produktów.

  Przykładowy przepływ pracy zgodny z najlepszymi praktykami:

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

  2. Sprawdź, czy „2022” istnieje w wynikach

  3. Utwórz obiekt danych za pomocą {payment_year={2022}.

• Qlik_get_chart_data: Pobieranie stronicowanych danych z istniejącej wizualizacji wykresu

• Qlik_get_chart_info: Pobieranie metadanych o wykresie bez pobierania jego danych

Przykład monitu:

„Pomóż mi zbadać, dlaczego przychody w regionie 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, wyświetl listę unikalnych wartości dla regionu i przeszukaj wartości pól, aby potwierdzić, czy używane jest „North”, „NORTH” czy „Northern”. Następnie utwórz tymczasowe obliczenie, aby porównać przychody i marżę miesiąc do miesiąca dla regionu Północ w porównaniu z innymi regionami, i zaznacz, 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 nadzorowanego, udostępnianego pakietu zestawów danych:

1. Tworzenie go.

2. Sprawdzanie jego metadanych i dokumentacji.

3. Utrzymywanie jego definicji (nazwa, opis i jakie zestawy danych zawiera)

4. Kontrolowanie, gdzie i czy jest dostępny, poprzez przenoszenie go między przestrzeniami i aktywowanie lub dezaktywowanie go.

Obsługują one 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: Tworzenie nowego produktu danych

• Qlik_get_data_product: Pobieranie metadanych dla określonego produktu danych

• Qlik_get_data_product_documentation: Pobieranie dokumentacji markdown produktu danych

• Qlik_update_data_product: Aktualizowanie właściwości (nazwa, opis, zestawy danych) produktu danych

• Qlik_update_data_product_space: Przenoszenie produktu danych do innej przestrzeni

• Qlik_update_activate_data_product: Aktywowanie produktu danych w określonej przestrzeni

• Qlik_update_deactivate_data_product: Dezaktywowanie produktu danych

• Qlik_delete_data_product: Usuwanie produktu danych

Przykład monitu:

„Utwórz produkt danych o nazwie „Analityka sprzedaży – wyselekcjonowane” z jasnym opisem i uwzględnij te zestawy danych: Zamówienia, Klienci i Produkty. 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, a także dodaj zestaw danych Zwroty. Przenieś produkt danych do naszej udostępnionej przestrzeni „Analityka”, aktywuj go tam w celu uzyskania szerszego dostępu, a jeśli później zastąpimy go nową wersją, dezaktywuj starą. 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ą, pobierając pochodzenie nadrzędne 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:

• Analizy wpływu.

• Rozwiązywania problemów z nieoczekiwanymi liczbami.

• Nadzoru lub audytu.

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

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

• Qlik_get_lineage: Ładowanie historii pochodzenia zestawu danych lub aplikacji (wywołaj rekurencyjnie dla pełnego łańcucha)

Przykład monitu:

„Pokaż mi pełne pochodzenie nadrzędne dla zestawu 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 przekształcenia lub pośrednie zestawy danych lub aplikacje. Następnie powiedz mi, które źródło nadrzędne najprawdopodobniej wpłynie na pole net_amount, jeśli ulegnie zmianie.”

Elementy główne (wymiary i miary)

Te narzędzia pomagają użytkownikom standaryzować i ponownie wykorzystywać kluczową logikę biznesową w aplikacji poprzez pracę z głównymi (bibliotecznymi) wymiarami i miarami. Możesz zinwentaryzować to, co jest już dostępne (aby uniknąć duplikatów i zachęcić do spójności), a także 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 nadzór, łatwość konserwacji i wyrównanie metryk.

Możesz aktualizować swoje elementy główne za pomocą nowych definicji, co pozwala na szybkie udoskonalenia. Możesz również usuwać elementy główne. Na przykład możesz poprosić klienta LLM o wyczyszczenie dowolnego elementu głównego, który nie jest używany w aplikacji.

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

• Qlik_list_dimensionst: Wyświetlanie listy wszystkich wymiarów biblioteki dostępnych w aplikacji

• Qlik_create_dimension: Tworzenie wymiaru biblioteki wielokrotnego użytku

• Qlik_update_dimension: Aktualizowanie istniejącego wymiaru biblioteki w aplikacji Qlik

• Qlik_delete_dimension: Usuwanie wymiaru biblioteki z aplikacji Qlik

• Qlik_list_measures: Wyświetlanie listy wszystkich miar biblioteki dostępnych w aplikacji

• Qlik_create_measure: Tworzenie miary biblioteki wielokrotnego użytku z wyrażeniem

• Qlik_update_measure: Aktualizowanie istniejącej miary biblioteki w aplikacji Qlik

• Qlik_delete_measure: Usuwanie miary biblioteki z aplikacji Qlik

Przykład monitu:

„Pomóż mi ustandaryzować metryki w naszej aplikacji Wyniki sprzedaży. Najpierw wyświetl listę istniejących wymiarów i miar biblioteki, abyśmy niczego nie duplikowali. Następnie utwórz nowy wymiar biblioteki „Segment klientów” na podstawie odpowiedniego pola segmentu i utwórz miarę wielokrotnego użytku „Marża brutto %” przy użyciu naszej standardowej definicji (marża brutto podzielona przez przychody, sformatowana jako wartość procentowa). Po ich utworzeniu podaj mi dokładne nazwy elementów głównych, do których powinienem się odwoływać podczas budowania wykresów, aby wszystkie pulpity nawigacyjne używały tej samej logiki.”

Zaznaczenia i filtrowanie

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

• Stosowanie zaznaczeń do jednego lub więcej pól (przy użyciu dokładnych wartości lub dopasowywania w stylu wzorca-predykatu).

• Sprawdzanie, jakie filtry są obecnie aktywne.

• Czyszczenie zaznaczeń globalnie lub dla określonego pola.

Razem obsługują one kierowane przepływy analizy, powtarzalne kroki badania.

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

• Qlik_select_values: Stosowanie zaznaczeń (filtrów) do pól - obsługuje dokładne wartości i dopasowywanie wzorców

  Informacja

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

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

  • Jeśli potrzebujesz jednorazowego filtru dla określonego obliczenia, użyj analizy zestawów w wyrażeniach

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

  Ostrzeżenie

  • Najpierw użyj qlik_get_field_values() lub qlik_search_field_values(), aby sprawdzić, czy wartości, które chcesz zaznaczyć, istnieją. Zaznaczenie nieistniejących wartości zakończy się niepowodzeniem bez powiadomienia.

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

• Qlik_clear_selections: Czyszczenie zaznaczeń - wszystkich lub określonego pola

  OstrzeżenieZwrócone zaznaczenia to rzeczywiste, aktualnie zastosowane zaznaczenia i są one prawdziwe. Wszelkie pola, w których zaznaczenie nie powiodło się, na przykład wartości nie istniały, nie pojawią się na zwróconej liście.

• Qlik_get_current_selections: Pobieranie aktualnie aktywnych zaznaczeń lub filtrów w aplikacji

Przykład monitu:

„Skonfiguruj mój kontekst analizy dla aplikacji Sprzedaż dla kadry kierowniczej: wybierz Rok = 2025 i Region = EMEA, a następnie zastosuj zaznaczenie oparte na wzorcu w kategorii produktów, 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 zaznaczenie kategorii produktów (zachowaj rok i region), a na koniec wyczyść wszystkie zaznaczenia, aby zresetować aplikację z powrotem do stanu niefiltrowanego.”

Wizualizacja i arkusze

Te narzędzia pozwalają użytkownikom na składanie pulpitów nawigacyjnych w aplikacji Qlik:

• Tworzenie nowego arkusza jako płótna.

• Dodawanie wizualizacji (wykresów, tabel, wskaźników KPI) skonfigurowanych z wymiarami, miarami i opcjami wyświetlanania.

• Umieszczanie paneli filtrowania w arkuszu, aby użytkownicy mogli interaktywnie dzielić analizę.

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

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

• Qlik_create_sheet: Tworzenie nowego pustego arkusza (pulpitu nawigacyjnego) w aplikacji

• Qlik_add_chart: Dodawanie wizualizacji (słupek, linia, koło, tabela, wskaźnik KPI itp.) do arkusza

  Informacja

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

  • Najpierw przetestuj istnienie wartości daty za pomocą qlik_search_field_values lub qlik_get_field_values

  • Użyj analizy zestawów zamiast zaznaczeń na poziomie aplikacji dla jednorazowych zapytań

• Qlik_add_filter: Dodawanie panelu filtrowania do arkusza w celu filtrowania sterowanego przez użytkownika

Przykład monitu:

„Utwórz nowy arkusz o nazwie „Przegląd sprzedaży” w naszej aplikacji analitycznej. Dodaj wskaźnik KPI dla całkowitych przychodów i całkowitych 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ą produktów, aby użytkownicy mogli dostosować widok. Upewnij się, że wizualizacje są wyraźnie zatytułowane, a arkusz jest gotowy dla kadry kierowniczej.”