Outils MCP Qlik

Le serveur MCP Qlik inclut des outils qui permettent à votre LLM d'effectuer des actions pour vous dans votre client Qlik Cloud. Vous pouvez personnaliser votre expérience en sélectionnant les outils MCP Qlik que vous souhaitez mettre à disposition.

Autorisations d'accès aux outils MCP Qlik

L'accès aux outils MCP dépend de vos autorisations. Vous devez être titulaire de l'autorisation Qlik MCP : Accordé dans un rôle personnalisé pour pouvoir accéder aux outils MCP Qlik depuis votre client LLM.

De plus, comme l'outil MCP Qlik est autorisé en tant qu'utilisateur de connexion, il utilise votre rôle d'utilisateur existant et vos autorisations d'espace. Vous devez également être autorisé dans Qlik Cloud à utiliser les fonctionnalités ou le type de contenu employés par les outils. Par exemple, si vous n'êtes pas autorisé à accéder à la traçabilité dans Qlik Cloud, vous ne pouvez pas utiliser l'outil MCP Qlik Qlik get lineage (Accéder à la traçabilité Qlik). Selon vos autorisations, certains outils peuvent vous refuser l'accès si vous ne pouvez pas utiliser la fonction ou la fonctionnalité dans Qlik Cloud.

La disponibilité des outils peut également être limitée par la licence de votre client.

Sélection d'outils MCP Qlik

Les outils MCP Qlik sont un catalogue d'actions conçues à des fins spécifiques qu'un LLM peut appeler pour effectuer des opérations dans votre client Qlik Cloud. Ces actions sont les suivantes :

• Recherche d'applications et de jeux de données

• Inspection des champs et des métadonnées des graphiques

• Application et effacement de filtres

• Création de feuilles et de graphiques

• Gestion des ressources régies comme les termes de glossaire et les produits de données

Chaque outil représente une fonctionnalité spécifique avec des entrées et des sorties bien définies.

Outils MCP Qlik disponibles

Le tableau ci-dessous présente une vue d'ensemble des catégories d'outils MCP Qlik actuelles et des noms des outils.

Ce que les outils peuvent accomplir

Découverte et métadonnées d'applications

Utilisez ces outils pour trouver la bonne application analytique Qlik et comprendre rapidement ce qu'elle contient avant de créer des graphiques ou d'appliquer des filtres. Cette catégorie supporte un flux de découverte de bout en bout : la recherche parmi les ressources Qlik pour localiser les applications pertinentes.

Les outils suivants sont disponibles :

• Qlik_search : rechercher des ressources Qlik (applications, jeux de données, produits de données, glossaires) par nom ou par contenu.

• Qlik_describe_apps : obtenir des métadonnées complètes pour une application, y compris les champs, le propriétaire et le statut de publication.

• Qlik_get_fields : répertorier tous les champs de données disponibles dans une application à utiliser comme dimensions.

• Qlik_list_sheets : répertorier toutes les feuilles d'une application.

• Qlik_get_sheet_details : obtenir les détails d'une feuille spécifique, y compris tous les graphiques et leurs types.

• Qlik_search_spaces : rechercher des espaces en fonction d'une chaîne de requête.

• Qlik_semantic_search_app : effectuer une recherche sémantique sur les ressources pertinentes dans l'application Qlik.

Exemple d'invite :

« Je dois analyser l'attrition de clientèle ». Cette simple invite permet d'effectuer les opérations suivantes :

• Utiliser qlik_search pour trouver des applications liées à « attrition » ou à « rétention client ».

• Pour une correspondance optimale, exécuter qlik_describe_app pour confirmer qu'il s'agit de la bonne application et voir ses métadonnées (propriétaire et statut de publication).

• Utiliser qlik_get_fields pour répertorier les champs disponibles et identifier les dimensions et mesures candidates comme Client, IndicateurAttrition, TypeAbonnement, Région et DateAttrition.

• Utiliser qlik_list_sheets pour voir quels sont les tableaux de bord qui existent déjà.

• Pour toute feuille prometteuse, par exemple, « Vue d'ensemble de l'attrition », appeler qlik_get_sheet_details et résumer les graphiques déjà disponibles et les lacunes restantes.

Glossaire métier

Cet ensemble d'outils permet à un utilisateur de configurer et de gérer un glossaire métier gouverné de bout en bout :

• Créer un glossaire

• L'organiser en catégories

• Ajouter et organiser des termes (y compris modifier, supprimer et gérer leur statut de cycle de vie tel que brouillon-vérifié-obsolète)

• Connecter ces termes à de véritables ressources analytiques (applications, jeux de données, champs, éléments principaux)

Les outils suivants sont disponibles :

• Qlik_create_glossary : créer un nouveau glossaire métier

• Qlik_get_full_glossary_export : obtenir le glossaire complet avec l'ensemble des termes, catégories et liens (opération coûteuse)

• Qlik_get_glossary_categories : récupérer toutes les catégories d'un glossaire

• Qlik_create_glossary_category : créer une nouvelle catégorie dans un glossaire

• Qlik_search_glossary_terms : rechercher des termes dans un glossaire

• Qlik_get_glossary_term : obtenir un terme spécifique d'un glossaire

• Qlik_create_glossary_term : créer un nouveau terme de glossaire avec une description, des balises et des relations

• Qlik_update_glossary_term : modifier un terme de glossaire existant

• Qlik_delete_glossary_term : supprimer un terme de glossaire

• Qlik_update_term_status : mettre à jour le statut d'un terme (brouillon, vérifié, obsolète). Seul un steward peut vérifier un terme. Une fois le terme vérifié, seul un steward peut modifier le terme.

  Note Informations

  Cette opération a trois statuts :

  • draft (brouillon) : le terme est à l'état de brouillon.

  • verified (vérifié) : le terme a été vérifié par un steward.

  • deprecated (obsolète) : Le terme est obsolète et ne doit pas être utilisé.

  Les noms de statut sont sensibles à la casse et doivent être fournis exactement comme ci-dessus.

• Qlik_get_glossary_term_links : obtenir les ressources liées à un terme de glossaire

  Cette fonction supporte deux modes :

  • Mode lien unique : fournir des paramètres individuels pour l'instance resource_id ou resource_type.

  • Mode par lots : fournir une liste de dictionnaires de liens via le paramètre « links » (liens)

  Note Informations

  Lors de la liaison à une sous-ressource, les trois champs de sous-ressource (subResourceId, subResourceName et subResourceType) doivent être fournis ensemble pour chaque lien.

• Qlik_create_glossary_term_links : lier un terme à des applications, des jeux de données, des champs et des éléments principaux

Exemple d'invite :

« Aidez-moi à créer et à gérer un glossaire métier pour notre domaine Ventes. Créez un glossaire appelé « Glossaire Ventes », ajoutez les catégories « Revenus », « Clients » et « Pipeline ». Créez ensuite des termes pour « Revenu annuel récurrent (ARR) » et « Taux d'attrition client » avec des définitions claires et des balises (par exemple, finance et opérations commerciales), définissez-les comme brouillons et liez chaque terme aux champs de jeu de données pertinents et aux éléments principaux d'ICP. »

Qualité des jeux de données et des données

Ces outils aident un utilisateur à comprendre, valider et gouverner les jeux de données en inspectant ce qu'est le jeu de données (métadonnées et appartenances à des produits de données), ce qu'il contient (schéma), ce à quoi ressemblent les données (statistiques de profilage-distributions et un échantillon rapide de lignes). Les outils supportent également les flux de travail de stewardship : l'amélioration de la documentation des jeux de données (nom-description) et le déclenchement et le suivi des calculs de qualité des données pour actualiser les métriques de qualité au fil du temps.

Les outils suivants sont disponibles :

• Qlik_get_dataset : charger les métadonnées d'un jeu de données, y compris le score de confiance

• Qlik_get_dataset_schema : charger le schéma (définitions des colonnes) d'un jeu de données

• Qlik_get_dataset_profile : charger les données de profil (statistiques, distributions) d'un jeu de données

• Qlik_get_dataset_sample : charger les 10 premières lignes d'un jeu de données pour les prévisualiser

• Qlik_get_dataset_freshness : obtenir l'horodatage de la dernière mise à jour d'un jeu de données

• Qlik_get_dataset_trust_score : obtenir le score de confiance d'un jeu de données

• Qlik_get_dataset_memberships : obtenir les appartenances à des produits de données d'un jeu de données

• Qlik_update_dataset_metadata : mettre à jour le nom et la description d'un jeu de données

• Qlik_update_dataset_quality : demander un calcul de la qualité des données d'un jeu de données

• Qlik_update_dataset_quality : demander un calcul de la qualité des données d'un jeu de données

• Qlik_get_dataset_quality_computation_status : vérifier le statut d'un calcul de la qualité

Exemple d'invite :

« Évaluez l'état de préparation de notre jeu de données Commandes clients pour un nouveau tableau de bord. Montrez-moi ses métadonnées et son score de confiance actuel, confirmez l'heure de la dernière actualisation et répertoriez les produits de données auxquels il appartient. Ensuite, chargez le schéma et un échantillon de 10 lignes pour vérifier l'intégrité des champs clés comme date_commande, id_client et montant_net. Exécutez un profil de jeu de données pour repérer les valeurs manquantes et les valeurs hors norme, et, si les métriques de qualité semblent obsolètes, déclenchez un calcul de la qualité des données et continuez à vérifier le statut du Job jusqu'à ce qu'il soit terminé. Pour finir, mettez à jour la description du jeu de données pour documenter les contraintes connues et l'utilisation recommandée. »

Exploration et analyse de données

Ces outils permettent une investigation rapide et ad hoc des données et du contenu analytique existant sans obliger l'utilisateur à créer de nouvelles visualisations de manière permanente. Vous pouvez créer des calculs temporaires ou interroger des objets pour répondre à des questions hypothétiques, inspecter des champs en répertoriant les valeurs distinctes ou rechercher des valeurs spécifiques.

Les outils suivants sont disponibles :

• Qlik_create_data_object : créer des objets de calcul temporaires pour les requêtes d'analyse ad hoc

  Note Informations

  Utilisez get_field_values() ou search_field_values() avant d'appliquer des sélections pour vérifier que les valeurs existent.

  Note Avertissement

  Qlik effectue TOUS les calculs, par conséquent :

  • N'agrégez pas, n'additionnez pas, ne calculez pas la moyenne ou n'effectuez aucun calcul sur les données renvoyées : les valeurs sont finales.

  • Pour des calculs différents, appelez de nouveau l'outil à l'aide de nouvelles expressions.

  • Appliquez toujours les filtres-sélections appropriés pour limiter la taille des données et améliorer les performances.

• Qlik_get_field_values : obtenir les valeurs distinctes d'un champ spécifique (à utiliser avant le filtrage)

  Note Informations

  Pour les champs à forte cardinalité, utilisez toujours qlik_search_field_values() à la place.

  Note Avertissement

  Utilisez cet outil ou qlik_search_field_values() AVANT de créer des sélections-filtres pour vérifier que les valeurs existent. Cela permet d'éviter les erreurs lors de l'application de filtres avec des valeurs inexistantes.

• Qlik_search_field_values : rechercher des valeurs spécifiques dans les champs (vérifier avant l'analyse d'ensembles)

  Note Avertissement

  Avant de créer des objets de données avec une analyse d'ensembles ou des sélections : utilisez qlik_search_field_values pour vérifier que les valeurs existent. Cela évite les erreurs dues à des valeurs de filtre inexistantes. Cela s'avère particulièrement important pour : les années, les dates, les codes de devise et les noms de produit.

  Exemple de flux de travail recommandé :

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

  2. Vérifier que "2022" existe dans les résultats

  3. Créer un objet de données en utilisant {payment_year={2022}.

• Qlik_get_chart_data : récupérer les données paginées d'une visualisation de graphique existante

• Qlik_get_chart_info : obtenir les métadonnées d'un graphique sans récupérer ses données

Exemple d'invite :

« Aidez-moi à comprendre pourquoi les revenus de la région Nord ont chuté le mois dernier. Commencez par vérifier le graphique existant « Revenu par région » : montrez-moi ses métadonnées (dimensions, mesures, filtres, nombre de lignes), puis extrayez les données du graphique des deux derniers mois. Avant d'appliquer des sélections, répertoriez les valeurs distinctes pour Région et recherchez les valeurs de champ pour confirmer si « Nord », « NORD » ou « Nordique » est utilisé. Ensuite, créez un calcul temporaire pour comparer le revenu et la marge d'un mois à l'autre pour Nord par rapport aux autres régions, et mettez en évidence les catégories de produits qui ont le plus contribué au changement. »

Produits de données

Ces outils gèrent le cycle de vie complet d'un produit de données sous forme de package de jeux de données gouverné et partageable :

1. Créez-le.

2. Inspectez ses métadonnées et sa documentation.

3. Gérez sa définition (nom, description et les jeux de données qu'il contient).

4. Contrôlez où et s'il est disponible en le déplaçant entre des espaces et en l'activant ou le désactivant.

Ils supportent également le nettoyage en fin de vie en supprimant un produit de données lorsqu'il n'est plus nécessaire.

Les outils suivants sont disponibles :

• Qlik_create_data_product : créer un nouveau produit de données

• Qlik_get_data_product : obtenir les métadonnées d'un produit de données spécifique

• Qlik_get_data_product_documentation : obtenir la documentation Markdown d'un produit de données

• Qlik_update_data_product : mettre à jour les propriétés (nom, description, jeux de données) d'un produit de données

• Qlik_update_data_product_space : déplacer un produit de données vers un espace différent

• Qlik_update_activate_data_product : activer un produit de données dans un espace spécifique

• Qlik_update_deactivate_data_product : désactiver un produit de données

• Qlik_delete_data_product : supprimer un produit de données

Exemple d'invite :

« Créez un produit de données appelé « Analyse commerciale – Organisée » avec une description claire et incluez ces jeux de données : Commandes, Clients et Produits. Ensuite, montrez-moi les métadonnées du produit de données et extrayez sa documentation Markdown afin que je puisse examiner ce que les consommateurs verront. Mettez à jour la description pour ajouter des conseils d'utilisation et ajoutez également le jeu de données Retours. Déplacez le produit de données vers notre espace partagé « Analyses », activez-le là-bas pour un accès plus large et, si nous le remplaçons plus tard par une nouvelle version, désactivez l'ancienne. Pour finir, si le produit est entièrement retiré et n'est plus référencé, supprimez-le. »

Traçabilité

Cet outil permet à un utilisateur de suivre l'origine des données et leur circulation en récupérant la traçabilité en amont d'un jeu de données ou d'une application. Étant donné que chaque appel ne renvoie qu'une seule étape en arrière, vous le répétez généralement de manière récursive pour construire la chaîne complète. Cela s'avère utile aux fins suivantes :

• Analyse de l'impact.

• Résolution des problèmes liés aux nombres imprévus.

• Gouvernance ou audit.

• Identification des sources réelles alimentant un rapport ou un jeu de données.

Les outils suivants sont disponibles :

• Qlik_get_lineage : charger l'historique de traçabilité d'un jeu de données ou d'une application (appeler récursivement pour former la chaîne complète)

Exemple d'invite :

« Montrez-moi la traçabilité complète en amont du jeu de données Commandes clients. Commencez par le jeu de données et revenez récursivement en arrière jusqu'à atteindre les systèmes sources d'origine. Pour chaque étape, résumez le parent immédiat et notez toutes les transformations clés ou les jeux de données ou applications intermédiaires impliqués. Ensuite, dites-moi quelle source en amont est la plus susceptible d'affecter le champ montant_net s'il change. »

Éléments principaux (Dimensions et mesures)

Ces outils aident les utilisateurs à standardiser et à réutiliser la logique métier clé d'une application en employant des dimensions et des mesures principales (de bibliothèque). Vous pouvez établir un inventaire ce qui est déjà disponible (pour éviter les doublons et encourager la cohérence) et créer de nouvelles dimensions et mesures réutilisables afin que les graphiques sur plusieurs feuilles utilisent les mêmes définitions de champ et expressions de calcul, améliorant ainsi la gouvernance, la maintenabilité et l'alignement des métriques.

Les outils suivants sont disponibles :

• Qlik_list_dimensionst : répertorier toutes les dimensions de bibliothèque disponibles dans l'application

• Qlik_create_dimension : créer une dimension de bibliothèque réutilisable

• Qlik_update_dimension : mettre à jour une dimension de bibliothèque existante dans une application Qlik

• Qlik_delete_dimension : supprimer une dimension de bibliothèque d'une application Qlik

• Qlik_list_measures : répertorier toutes les mesures de bibliothèque disponibles dans l'application

• Qlik_create_measure : créer une mesure de bibliothèque réutilisable avec une expression

• Qlik_update_measure : mettre à jour une mesure de bibliothèque existante dans une application Qlik

• Qlik_delete_measure : supprimer une mesure de bibliothèque d'une application Qlik

Exemple d'invite :

« Aidez-moi à standardiser les métriques dans notre application Performances commerciales. Pour commencer, répertoriez les dimensions et mesures de bibliothèque existantes afin de ne rien dupliquer. Ensuite, créez une nouvelle dimension de bibliothèque « Segment client » basée sur le champ de segment approprié et une mesure réutilisable « % de marge brute » en utilisant notre définition standard (marge brute divisée par le chiffre d'affaires, exprimée sous forme de pourcentage). Après les avoir créés, indiquez-moi les noms exacts des éléments principaux que je devrais référencer lors de la création de graphiques afin que tous les tableaux de bord utilisent la même logique. »

Sélections et filtrage

Ces outils contrôlent l'état du filtre interactif d'une application Qlik :

• Appliquez des sélections à un ou plusieurs champs (en utilisant des valeurs exactes ou une correspondance modèle-prédicat-style).

• Inspectez pour savoir quels filtres sont actuellement actifs.

• Effacez les sélections soit globalement, soit pour un champ spécifique.

Ensemble, ils supportent des flux d'analyse guidés, des étapes d'investigation reproductibles.

Les outils suivants sont disponibles :

• Qlik_select_values : appliquer des sélections (filtres) aux champs – supporte les valeurs exactes et la correspondance de modèles

  Note Informations

  Quand utiliser des sélections plutôt qu'une analyse d'ensembles :

  • Lorsque vous souhaitez filtrer l'intégralité de l'application ou de la session pour plusieurs opérations ultérieures, utilisez select_values().

  • Lorsque vous avez besoin d'un filtre ponctuel pour un calcul spécifique, utilisez une analyse d'ensembles dans des expressions.

  Les sélections persistent pour toutes les opérations jusqu'à ce qu'elles soient effacées ; elles affectent TOUTES les récupérations de données ultérieures. Comme bonne pratique, pour les requêtes analytiques uniques, préférez l'analyse d'ensembles aux sélections afin d'éviter la surcharge de gestion de l'état.

  Note Avertissement

  • Commencez par utiliser qlik_get_field_values() ou qlik_search_field_values() pour vérifier que les valeurs que vous souhaitez sélectionner existent. La sélection de valeurs inexistantes échouera en silence.

  • Les sélections renvoyées sont la sélection réelle appliquée actuelle et sont vraies. Tous les champs dans lesquels la sélection a échoué, par exemple : dans lesquels les valeurs n'existaient pas, n'apparaîtront pas dans la liste renvoyée.

• Qlik_clear_selections : effacer les sélections - tous les champs ou un champ spécifique

  Note AvertissementLes sélections renvoyées sont la sélection réelle appliquée actuelle et sont vraies. Tous les champs dans lesquels la sélection a échoué, par exemple : dans lesquels les valeurs n'existaient pas, n'apparaîtront pas dans la liste renvoyée.

• Qlik_get_current_selections : obtenir les sélections ou filtres actuellement actifs dans l'application

• Qlik_update_filter : mettre à jour un volet de filtre existant dans une application Qlik

Exemple d'invite :

« Configurez mon contexte analytique pour l'application Ventes exécutives : sélectionnez Année = 2025 et Région = EMEA, et appliquez une sélection basée sur un modèle à Catégorie de produit pour inclure uniquement les catégories commençant par « Cloud ». Ensuite, montrez-moi les sélections actuelles afin que je puisse confirmer ce qui est actif. Après avoir examiné les ICP, effacez uniquement la sélection Catégorie de produit (conservez Année et Région), puis effacez toutes les sélections pour réinitialiser l'application à un état non filtré. »

Visualisation et feuilles

Ces outils permettent aux utilisateurs d'assembler des tableaux de bord dans une application Qlik :

• Créez une nouvelle feuille comme canevas.

• Ajoutez des visualisations (graphiques, tableaux, ICP) configurées avec des dimensions, des mesures et des options d'affichage.

• Placez des volets de filtre sur la feuille afin que les utilisateurs puissent segmenter l'analyse de manière interactive.

Ensemble, ils couvrent le flux de travail de base pour la création d'une page de tableau de bord utilisable en libre-service.

Les outils suivants sont disponibles :

• Qlik_create_sheet : créer une nouvelle feuille (un nouveau tableau de bord) vide dans l'application

• Qlik_add_chart : ajouter une visualisation (barre, courbe, secteur, tableau, ICP, etc.) à une feuille

  Note Informations

  • Planifiez la structure de votre requête avant d'effectuer des appels d'outil.

  • Commencez par tester l'existence date-valeur avec qlik_search_field_values ou qlik_get_field_values

  • Utilisez l'analyse d'ensembles plutôt que des sélections au niveau de l'application pour les requêtes ponctuelles.

• Qlik_add_filter : ajouter un volet de filtre à une feuille pour un filtrage piloté par l'utilisateur

• Qlik_delete_object : supprimer un objet d'une application Qlik (graphique, feuille, filtre, etc.)

• Qlik_show_chart : afficher une visualisation rendue sous forme d'instantané Qlik

• Qlik_update_chart : mettre à jour une visualisation de graphique existante dans une application Qlik

Exemple d'invite :

« Créez une nouvelle feuille appelée « Vue d'ensemble des ventes » dans notre application analytique. Ajoutez un ICP pour Chiffre d'affaires total et Nombre total de commandes, un graphique en courbes affichant Chiffre d'affaires par mois et un graphique à barres affichant Chiffre d'affaires par région (trié dans l'ordre décroissant). Ajoutez ensuite un volet de filtre avec Année, Région et Catégorie de produit afin que les utilisateurs puissent ajuster la vue. Assurez-vous que les visuels sont clairement intitulés et que la feuille est prête pour un public de cadres supérieurs. »