Qlik strumenti MCP

Il server Qlik MCP include strumenti che consentono al tuo LLM di eseguire azioni per te nel tuo Qlik Cloud tenant. Puoi personalizzare la tua esperienza selezionando quali strumenti Qlik MCP desideri disponibili.

Autorizzazioni di accesso e strumenti Qlik MCP

L'accesso agli strumenti MCP è controllato dalle tue autorizzazioni. È necessaria l'autorizzazione Qlik MCP: Consentito in un ruolo personalizzato per accedere agli strumenti Qlik MCP dal client LLM.

Inoltre, poiché lo strumento Qlik MCP è autorizzato come utente di connessione, utilizza il ruolo utente e le autorizzazioni di spazio esistenti. È inoltre necessario disporre dell'autorizzazione in Qlik Cloud per utilizzare le capacità o il tipo di contenuto utilizzati dagli strumenti. Ad esempio, se non si dispone dell'autorizzazione per accedere alla derivazione in Qlik Cloud, non è possibile utilizzare lo strumento Qlik MCP Qlik get lineage. A seconda delle autorizzazioni, alcuni strumenti potrebbero rispondere con nessun accesso se non è possibile utilizzare la capacità o la funzionalità in Qlik Cloud.

La disponibilità degli strumenti può anche essere limitata dalla licenza del tuo tenant.

Selezione di Qlik strumenti MCP

Gli strumenti Qlik MCP sono un catalogo di azioni appositamente create che un LLM può richiamare per eseguire azioni nel tuo tenant Qlik Cloud. Le azioni includono:

• Ricerca di applicazioni e set di dati

• Ispezione di campi e metadati del grafico

• Applicazione e cancellazione di filtri

• Creazione di fogli e grafici

• Gestione di risorse governate come termini del glossario e prodotti di dati.

Ogni strumento rappresenta una capacità specifica con input e output ben definiti.

Strumenti Qlik MCP disponibili

La tabella seguente mostra una panoramica delle attuali categorie di strumenti Qlik MCP e dei nomi degli strumenti.

Cosa possono realizzare i singoli strumenti

Rilevamento app e metadati

Usa questi strumenti per trovare la giusta Qlik applicazione di analisi e comprendere rapidamente cosa contiene prima di creare grafici o applicare filtri. Questa categoria supporta un flusso di rilevamento end-to-end: cerca tra le risorse Qlik per individuare le applicazioni pertinenti.

Sono disponibili i seguenti strumenti:

• Qlik_search: Cerca Qlik risorse (applicazioni, set di dati, prodotti di dati, glossari) per nome o contenuto.

• Qlik_describe_apps: Ottieni metadati completi per un'applicazione, inclusi campi, proprietario, stato di pubblicazione.

• Qlik_get_fields: Elenca tutti i campi dati disponibili in un'applicazione da utilizzare come dimensioni.

• Qlik_list_sheets: Elenca tutti i fogli in un'app.

• Qlik_get_sheet_details: Ottieni i dettagli su un foglio specifico, inclusi tutti i grafici e i loro tipi.

• Qlik_search_spaces: Cerca spazi in base a una stringa di query.

• Qlik_semantic_search_app: Esegui una ricerca semantica per risorse pertinenti nell'app Qlik.

Esempio di prompt:

"Devo analizzare il churn dei clienti." Questo semplice prompt consente di:

• Usa qlik_search per trovare applicazioni relative a “churn” o “customer retention”.

• Per la migliore corrispondenza, esegui qlik_describe_app per confermare che sia l'applicazione corretta e visualizzare i suoi metadati (proprietario e stato di pubblicazione).

• Usa qlik_get_fields per elencare i campi disponibili e identificare dimensioni e misure candidate come Customer, ChurnFlag, SubscriptionType, Region e ChurnDate.

• Usa qlik_list_sheets per vedere quali dashboard esistono già.

• Per qualsiasi foglio promettente, ad esempio, “Churn Overview,” chiama qlik_get_sheet_details e riassumi quali grafici sono già disponibili e quali lacune rimangono.

Glossario aziendale

Questo set di strumenti consente a un utente di configurare e gestire un glossario aziendale governato end-to-end:

• Può creare un glossario

• Organizzarlo con le categorie

• Aggiungere e curare i termini (inclusa la modifica, la rimozione e la gestione dello stato del ciclo di vita come bozza -verificato-deprecato)

• Connettere tali termini a risorse di analisi reali (applicazioni, set di dati, campi, voci principali).

I seguenti strumenti sono disponibili:

• Qlik_create_glossary: Crea un nuovo glossario aziendale

• Qlik_get_full_glossary_export: Ottieni il glossario completo con tutti i termini, le categorie, i collegamenti (operazione costosa)

• Qlik_get_glossary_categories: Recupera tutte le categorie per un glossario

• Qlik_create_glossary_category: Crea una nuova categoria all'interno di un glossario

• Qlik_search_glossary_terms: Cerca termini all'interno di un glossario

• Qlik_get_glossary_term: Ottieni un termine specifico da un glossario

• Qlik_create_glossary_term: Crea un nuovo termine del glossario con descrizione, tag, relazioni

• Qlik_update_glossary_term: Modifica un termine del glossario esistente

• Qlik_delete_glossary_term: Rimuovi un termine del glossario

• Qlik_update_term_status: Aggiorna lo stato del termine (bozza, verificato, deprecato). Solo uno steward può verificare un termine. Una volta che il termine è verificato, solo uno steward può modificare il termine

  Nota informatica

  Questa operazione ha tre stati:

  • bozza: Il termine è in stato di bozza.

  • verificato: Il termine è stato verificato da un amministratore.

  • deprecato: Il termine è deprecato e non deve essere utilizzato.

  I nomi degli stati fanno distinzione tra maiuscole e minuscole e devono essere forniti esattamente come sopra.

• Qlik_get_glossary_term_links: Ottieni le risorse collegate a un termine del glossario

  Questa funzione supporta due modalità:

  • Modalità collegamento singolo: Fornire parametri individuali per l'istanza resource_id o resource_type.

  • Modalità batch: Fornire un elenco di dizionari di collegamento tramite il parametro 'links'

  Nota informatica

  Quando si collega a una sottorisorsa, tutti e tre i campi della sottorisorsa (subResourceId, subResourceName e subResourceType) devono essere forniti insieme per ogni collegamento.

• Qlik_create_glossary_term_links: Collegare un termine ad app, set di dati, campi, voci principali

Esempio di prompt:

Aiutami a costruire e governare un Glossario aziendale per il nostro dominio Vendite. Crea un glossario chiamato ‘Glossario Vendite’, aggiungi le categorie ‘Ricavi’, ‘Clienti’ e ‘Pipeline’. Quindi crea termini per ‘Ricavo Ricorrente Annuo (ARR)’ e ‘Abbandono Clienti’ con definizioni cancella e tag, ad esempio finanza e sales-ops, impostali come bozza e collega ogni termine ai campi del dataset pertinenti e alle voci principali dei KPI."

Dataset e Qualità dei Dati

Questi strumenti aiutano un utente a comprendere, convalidare e governare i dataset ispezionando cos'è il dataset (metadati e appartenenze ai prodotti dati), cosa contiene (schema), come appaiono i dati (statistiche di profilazione-distribuzioni e un rapido campione di righe). Gli strumenti supportano anche i flussi di lavoro di gestione: migliorando la documentazione del dataset (nome-descrizione) e attivando e monitorando i calcoli della qualità dei dati per aggiornare le metriche di qualità nel tempo.

Sono disponibili i seguenti strumenti:

• Qlik_get_dataset: Carica i metadati di un dataset, incluso il punteggio di affidabilità

• Qlik_get_dataset_schema: Carica lo schema (definizioni delle colonne) di un dataset

• Qlik_get_dataset_profile: Carica i dati del profilo (statistiche, distribuzioni) di un dataset

• Qlik_get_dataset_sample: Carica le prime 10 righe di un dataset per l'anteprima

• Qlik_get_dataset_freshness: Ottieni il timestamp dell'ultimo aggiornamento di un dataset

• Qlik_get_dataset_trust_score: Ottieni il punteggio di affidabilità di un dataset

• Qlik_get_dataset_memberships: Ottieni le appartenenze al prodotto dati per un dataset

• Qlik_update_dataset_metadata: Aggiorna nome e descrizione di un dataset

• Qlik_update_dataset_quality: Richiedi un calcolo della qualità dei dati per un dataset

• Qlik_update_dataset_quality: Richiedi un calcolo della qualità dei dati per un dataset

• Qlik_get_dataset_quality_computation_status: Verifica lo stato di un calcolo della qualità

Esempio di prompt:

“Valuta la prontezza del nostro dataset Ordini Cliente per una nuova dashboard. Mostrami i suoi metadati e il punteggio di affidabilità attuale, conferma l'ora dell'ultimo aggiornamento ed elenca a quali prodotti di dati appartiene. Quindi carica lo schema e un campione di 10 righe per un controllo di coerenza dei campi chiave come order_date, customer_id e net_amount. Esegui un profilo del dataset per individuare i valori mancanti e gli outlier, e se le metriche di qualità sembrano obsolete, attiva un calcolo della qualità dei dati e continua a controllare lo stato del lavoro finché non è completato. Infine, aggiorna la descrizione del dataset per documentare i vincoli noti e l'uso consigliato.”

Esplorazione & Analisi dei Dati

Questi strumenti supportano l'indagine rapida e ad hoc dei dati e dei contenuti analitici esistenti senza richiedere all'utente di creare permanentemente nuove visualizzazioni. È possibile creare calcoli temporanei o oggetti di query per rispondere a domande “what-if”, ispezionare i campi elencando valori distinti o cercare valori specifici.

I seguenti strumenti sono disponibili:

• Qlik_create_data_object: Crea oggetti di calcolo temporanei per query analitiche ad hoc

  Nota informatica

  Usa get_field_values() o search_field_values() prima di applicare le selezioni per verificare che i valori esistano.

  Nota di avviso

  Qlik esegue TUTTI i calcoli, pertanto:

  • Non aggregare, sommare, calcolare la media o elaborare i dati restituiti: i valori sono definitivi.

  • Per calcoli diversi, richiamare lo strumento con nuove espressioni.

  • Applicare sempre filtri-selezioni appropriati per limitare la dimensione dei dati e migliorare le prestazioni.

• Qlik_get_field_values: Ottieni valori distinti per un campo specifico (usa prima del filtro)

  Nota informatica

  Per i campi ad alta cardinalità, usa sempre qlik_search_field_values() invece.

  Nota di avviso

  Usa questo strumento o qlik_search_field_values() PRIMA di creare selezioni-filtri per verificare che i valori esistano. Questo aiuta a evitare errori quando si applicano filtri con valori inesistenti.

• Qlik_search_field_values: Cerca valori specifici tra i campi (verifica prima dell'analisi del set)

  Nota di avviso

  Prima di creare oggetti dati con set analysis o selezioni: usa qlik_search_field_values per verificare che i valori esistano. Ciò previene errori da valori di filtro inesistenti, particolarmente importante per: anni, date, codici valuta, nomi prodotto.

  Esempio di flusso di lavoro di migliore pratica:

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

  2. Verificare che "2022" esista nei risultati

  3. Creare oggetto dati utilizzando {payment_year={2022}.

• Qlik_get_chart_data: Recupera dati impaginati da una visualizzazione grafico esistente

• Qlik_get_chart_info: Ottieni metadati su un grafico senza recuperarne i dati

Esempio di prompt:

“Aiutami a indagare perché i ricavi della regione Nord sono diminuiti il mese scorso. Innanzitutto, controlla il grafico esistente 'Ricavi per regione': mostrami i suoi metadati (dimensioni, misure, filtri, conteggio righe) e poi estrai i dati del grafico per gli ultimi due mesi. Prima di applicare qualsiasi selezione, elenca i valori distinti per Regione e cerca i valori del campo per confermare se viene utilizzato 'North', 'NORTH' o 'Northern'. Quindi crea un calcolo temporaneo per confrontare i ricavi e il margine mese su mese per il Nord rispetto ad altre regioni, ed evidenzia quali categorie di prodotti hanno contribuito maggiormente al cambiamento.”

Prodotti di dati

Questi strumenti gestiscono l'intero ciclo di vita di un prodotto di dati come un pacchetto di dataset governato e condivisibile:

1. Crealo.

2. Ispeziona i suoi metadati e la documentazione.

3. Mantieni la sua definizione (nome, descrizione e quali set di dati contiene)

4. Controlla dove e se è disponibile spostandolo tra gli spazi e attivandolo o disattivandolo.

Supportano anche la pulizia di fine vita eliminando un prodotto di dati quando non è più necessario.

I seguenti strumenti sono disponibili:

• Qlik_create_data_product: Crea un nuovo prodotto di dati

• Qlik_get_data_product: Ottieni i metadati per un prodotto di dati specifico

• Qlik_get_data_product_documentation: Ottieni la documentazione markdown di un prodotto di dati

• Qlik_update_data_product: Aggiorna le proprietà (nome, descrizione, set di dati) di un prodotto di dati

• Qlik_update_data_product_space: Sposta un prodotto di dati in uno spazio diverso

• Qlik_update_activate_data_product: Attiva un prodotto di dati in uno spazio specifico

• Qlik_update_deactivate_data_product: Disattiva un prodotto di dati

• Qlik_delete_data_product: Elimina un prodotto di dati

Esempio di prompt:

“Crea un prodotto di dati chiamato 'Sales Analytics – Curated' con una descrizione chiara e includi questi set di dati: Ordini, Clienti e Prodotti. Poi mostrami i metadati del prodotto dati e recupera la sua documentazione markdown così posso rivedere ciò che i consumatori vedranno. Aggiorna la descrizione per aggiungere indicazioni sull'utilizzo e aggiungi anche il dataset Returns. Sposta il prodotto dati nel nostro spazio condiviso 'Analytics', attivalo lì per un accesso più ampio e, se in seguito lo sostituiamo con una nuova versione, disattiva quello vecchio. Infine, se il prodotto è completamente ritirato e non più referenziato, eliminalo.”

Derivazione

Questo strumento consente a un utente di tracciare da dove provengono i dati e come scorrono recuperando la derivazione a monte per un dataset o un'app. Poiché ogni chiamata restituisce un solo passo indietro, tipicamente la si ripete ricorsivamente per costruire la catena completa. Questo è utile per:

• Analisi impatto.

• Risoluzione dei problemi relativi a numeri imprevisti.

• Governance o auditing.

• Identificazione delle vere fonti che alimentano un report o un set di dati.

I seguenti strumenti sono disponibili:

• Qlik_get_lineage: Carica il rendiconto della derivazione di un dataset o di un'app (chiama ricorsivamente per la catena completa)

Esempio di prompt:

“Mostrami la derivazione completa a monte per il dataset Ordini Cliente. Parti dal dataset e risali ricorsivamente fino a raggiungere i sistemi sorgente originali. Per ogni passaggio, riassumi qual è il genitore immediato e annota eventuali trasformazioni chiave o set di dati o app intermedi coinvolti. Poi dimmi quale flusso a monte ha maggiori probabilità di influenzare il campo net_amount se cambia.”

Elementi master (Dimensioni & Misure)

Questi strumenti aiutano gli utenti a standardizzare e riutilizzare la logica di business chiave in un'app lavorando con dimensioni e misure master (di libreria). Puoi inventariare ciò che è già disponibile (per evitare duplicati e incoraggiare la coerenza), e puoi creare nuove dimensioni e misure riutilizzabili in modo che i grafici su più fogli utilizzino le stesse definizioni di campo ed espressioni di calcolo, migliorando la governance, la manutenibilità e l'allineamento delle metriche.

Sono disponibili i seguenti strumenti:

• Qlik_list_dimensionst: Elenca tutte le dimensioni della libreria disponibili nell'app

• Qlik_create_dimension: Crea una dimensione della libreria riutilizzabile

• Qlik_update_dimension: Aggiorna una dimensione della libreria esistente in un'app Qlik

• Qlik_delete_dimension: Elimina una dimensione della libreria da un'app Qlik

• Qlik_list_measures: Elenca tutte le misure di libreria disponibili nell'app

• Qlik_create_measure: Crea una misura di libreria riutilizzabile con espressione

• Qlik_update_measure: Aggiorna una misura di libreria esistente in un'app Qlik

• Qlik_delete_measure: Elimina una misura di libreria da un'app Qlik

Esempio di prompt:

“Aiutami a standardizzare le metriche nella nostra app Sales Performance. Per prima cosa, elenca le dimensioni e le misure della libreria esistenti in modo da non duplicare nulla. Quindi crea una nuova dimensione della libreria 'Segmento cliente' basata sul campo segmento appropriato e crea una misura riutilizzabile 'Margine lordo %' utilizzando la nostra definizione standard (margine lordo diviso per i ricavi, formattato come percentuale). Dopo averli creati, dimmi i nomi esatti delle voci principali a cui dovrei fare riferimento quando creo i grafici in modo che tutti i dashboard utilizzino la stessa logica.”

Selezioni e filtro

Questi strumenti controllano lo stato del filtro interattivo di un'app Qlik:

• Applica selezioni a uno o più campi (utilizzando valori esatti o corrispondenze in stile pattern-predicate).

• Ispeziona quali filtri sono attualmente attivi.

• Cancella selezioni a livello globale o per un campo specifico.

Insieme supportano flussi di analisi guidati, passaggi di indagine riproducibili.

I seguenti strumenti sono disponibili:

• Qlik_select_values: Applica selezioni (filtri) ai campi - supporta valori esatti e corrispondenza di pattern

  Nota informatica

  Quando usare le selezioni rispetto all'analisi set:

  • Quando si desidera filtrare l'intera app o sessione per più operazioni successive, usa select_values().

  • Quando è necessario un filtro una tantum per un calcolo specifico, usa l'analisi set nelle espressioni

  Le selezioni persistono in tutte le operazioni finché non vengono cancellate e influenzano TUTTI i recuperi di dati successivi. Come buona pratica, per singole query analitiche, preferire l'analisi set rispetto alle selezioni per evitare il sovraccarico di gestione dello stato.

  Nota di avviso

  • Utilizzare prima qlik_get_field_values() o qlik_search_field_values() per verificare che i valori che si desidera selezionare esistano. La selezione di valori inesistenti fallirà silenziosamente.

  • Le selezioni restituite sono le selezioni effettive attualmente applicate e corrispondono alla realtà. Eventuali campi in cui la selezione è fallita, ad esempio dove i valori non esistevano, non appariranno nell'elenco restituito.

• Qlik_clear_selections: Cancella selezioni - tutte o un campo specifico

  Nota di avvisoLe selezioni restituite sono la selezione applicata effettiva corrente e rappresentano la verità. Eventuali campi in cui la selezione è fallita, ad esempio, i valori non esistevano, non appariranno nell'elenco restituito.

• Qlik_get_current_selections: Ottieni le selezioni o i filtri attualmente attivi nell'app

• Qlik_update_filter: Aggiorna una casella di filtro esistente in un'app Qlik

Esempio di prompt:

“Imposta il mio contesto di analisi per l'app Executive Sales: seleziona Anno = 2025 e Regione = EMEA, e applica una selezione basata su pattern sulla Categoria prodotto per includere solo le categorie che iniziano con 'Cloud'. Poi mostrami le selezioni attuali così posso confermare cosa è attivo. Dopo aver esaminato i KPI, cancella solo la selezione Categoria prodotto (mantieni Anno e Regione), e infine cancella tutte le selezioni per ripristinare l'app a uno stato non filtrato.”

Visualizzazione & Fogli

Questi strumenti consentono agli utenti di assemblare dashboard in un'applicazione Qlik:

• Crea un nuovo foglio come area di lavoro.

• Aggiungi visualizzazioni (grafici, tabelle, KPI) configurate con dimensioni, misure e opzioni di visualizzazione.

• Posiziona caselle di filtro sul foglio in modo che gli utenti possano sezionare interattivamente l'analisi.

Insieme, coprono il flusso di lavoro di base per la creazione di una pagina dashboard utilizzabile e self-service.

I seguenti strumenti sono disponibili:

• Qlik_create_sheet: Crea un nuovo foglio vuoto (dashboard) nell'app

• Qlik_add_chart: Aggiungi una visualizzazione (barra, linea, torta, tabella, KPI, ecc.) a un foglio

  Nota informatica

  • Pianifica la struttura della tua query prima di effettuare chiamate agli strumenti.

  • Verifica l'esistenza del valore data con qlik_search_field_values o qlik_get_field_values prima

  • Usa l'analisi set sulle selezioni a livello di app per query una tantum

• Qlik_add_filter: Aggiungi una casella di filtro a un foglio per il filtro guidato dall'utente

• Qlik_delete_object: Elimina un oggetto da un'app Qlik (grafico, foglio, filtro, ecc.)

• Qlik_show_chart: Mostra una visualizzazione renderizzata come uno snapshot Qlik

• Qlik_update_chart: Aggiorna una visualizzazione grafico esistente in un'app Qlik

Esempio di prompt:

“Crea un nuovo foglio chiamato 'Panoramica vendite' nella nostra app di analisi. Aggiungi un KPI per Ricavo totale e Ordini totali, un grafico lineare che mostri il Ricavo per Mese e un grafico a barre che mostri il Ricavo per Regione (ordinato in ordine decrescente). Quindi aggiungi una casella di filtro con Anno, Regione e Categoria prodotto in modo che gli utenti possano regolare la visualizzazione. Assicurati che gli elementi visivi siano intitolati chiaramente e che il foglio sia pronto per un pubblico esecutivo.”