Strumenti MCP Qlik

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

Autorizzazioni di accesso e strumenti MCP Qlik

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

Inoltre, poiché lo strumento MCP Qlik è autorizzato come utente che si connette, utilizza il ruolo utente e le autorizzazioni dello spazio esistenti. È inoltre necessario disporre dell'autorizzazione in Qlik Cloud per utilizzare le funzionalità o il tipo di contenuto utilizzato dagli strumenti. Ad esempio, se non si dispone dell'autorizzazione per accedere alla derivazione in Qlik Cloud, non è possibile utilizzare lo strumento MCP Qlik 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 dalle licenze del tuo tenant.

Selezione degli strumenti MCP Qlik

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

• Ricerca di applicazioni e set di dati

• Ispezione dei campi e dei metadati del grafico

• Applicazione e cancellazione dei filtri

• Creazione di fogli e grafici

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

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

Strumenti MCP Qlik disponibili

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

Cosa può realizzare ciascuno strumento

Individuazione app e metadati

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

Sono disponibili i seguenti strumenti:

• Qlik_search: Cerca risorse Qlik (applicazioni, set di dati, prodotti 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 dettagli su un foglio specifico, inclusi tutti i grafici e i relativi tipi.

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

Esempio di prompt:

"Devo analizzare l'abbandono dei clienti." Questo semplice prompt consente di:

• Utilizzare qlik_search per trovare applicazioni relative a "abbandono" o "fidelizzazione dei clienti".

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

• Utilizzare qlik_get_fields per elencare i campi disponibili e identificare dimensioni e misure candidate come Cliente, ChurnFlag, TipoAbbonamento, Regione e DataAbbandono.

• Utilizzare qlik_list_sheets per vedere quali dashboard esistono già.

• Per qualsiasi foglio promettente, ad esempio "Panoramica abbandono", chiamare qlik_get_sheet_details e riepilogare 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:

• Creare un glossario

• Organizzarlo con categorie

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

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

Sono disponibili i seguenti strumenti:

• 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 verificato il termine, solo uno steward può modificarlo

  Nota informatica

  Questa operazione ha tre stati:

  • draft: Il termine è in stato di bozza.

  • verified: Il termine è stato verificato da uno steward.

  • deprecated: 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: Fornisci parametri individuali, ad esempio resource_id o resource_type.

  • Modalità batch: Fornisci un elenco di dizionari di collegamenti tramite il parametro 'links'

  Nota informatica

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

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

Esempio di prompt:

"Aiutami a creare e governare un glossario aziendale per il nostro dominio Vendite. Crea un glossario chiamato 'Glossario vendite', aggiungi le categorie 'Entrate', 'Clienti' e 'Pipeline'. Quindi crea termini per 'Entrate ricorrenti annuali (ARR)' e 'Abbandono clienti' con definizioni chiare e tag, ad esempio finanza e operazioni di vendita, impostali su bozza e collega ciascun termine ai campi del set di dati pertinenti e alle voci principali KPI."

Set di dati e qualità dei dati

Questi strumenti aiutano un utente a comprendere, convalidare e governare i set di dati ispezionando cos'è il set di dati (metadati e appartenenze ai prodotti dati), cosa contiene (schema), come si presentano i dati (statistiche-distribuzioni di profilazione e un rapido campione di righe). Gli strumenti supportano anche i flussi di lavoro di stewardship: miglioramento della documentazione del set di dati (nome-descrizione) e attivazione e monitoraggio dei 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 set di dati, incluso il punteggio di affidabilità

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

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

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

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

• Qlik_get_dataset_trust_score: Ottieni il punteggio di affidabilità di un set di dati

• Qlik_get_dataset_memberships: Ottieni le appartenenze ai prodotti dati per un set di dati

• Qlik_update_dataset_metadata: Aggiorna il nome e la descrizione di un set di dati

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

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

Esempio di prompt:

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

Esplorazione e analisi dei dati

Questi strumenti supportano un'indagine rapida e ad hoc dei dati e dei contenuti di analisi esistenti senza richiedere all'utente di creare in modo permanente nuove visualizzazioni. È possibile creare calcoli temporanei o interrogare oggetti per rispondere a domande "what-if", ispezionare i campi elencando valori distinti o cercare valori specifici.

Sono disponibili i seguenti strumenti:

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

  Nota informatica

  Utilizzare 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 eseguire calcoli sui dati restituiti: i valori sono definitivi.

  • Per calcoli diversi, chiamare nuovamente lo strumento con nuove espressioni.

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

• Qlik_get_field_values: Ottieni valori distinti per un campo specifico (utilizzare prima del filtraggio)

  Nota informatica

  Per i campi ad alta cardinalità, utilizzare sempre qlik_search_field_values()

  Nota di avviso

  Utilizzare questo strumento o qlik_search_field_values() PRIMA di creare selezioni-filtri per verificare che i valori esistano. Ciò aiuta a evitare errori durante l'applicazione di filtri con valori inesistenti.

• Qlik_search_field_values: Cerca valori specifici nei campi (verificare prima della set analysis)

  Nota di avviso

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

  Esempio di flusso di lavoro di best practice:

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

  2. Verificare che "2022" esista nei risultati

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

• Qlik_get_chart_data: Recupera i dati impaginati da una visualizzazione del grafico esistente

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

Esempio di prompt:

“Aiutami a indagare sul motivo per cui le entrate della regione Nord sono diminuite il mese scorso. Innanzitutto, controlla il grafico 'Entrate per regione' esistente: mostrami i suoi metadati (dimensioni, misure, filtri, conteggio delle righe) e quindi 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 'Nord', 'NORD' o 'Settentrionale'. Quindi crea un calcolo temporaneo per confrontare le entrate e il margine mese su mese per il Nord rispetto ad altre regioni ed evidenzia quali categorie di prodotti hanno contribuito maggiormente alla modifica.”

Prodotti dati

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

1. Crearlo.

2. Ispezionarne i metadati e la documentazione.

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

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

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

Sono disponibili i seguenti strumenti:

• Qlik_create_data_product: Crea un nuovo prodotto dati

• Qlik_get_data_product: Ottieni i metadati per un prodotto dati specifico

• Qlik_get_data_product_documentation: Ottieni la documentazione markdown di un prodotto dati

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

• Qlik_update_data_product_space: Sposta un prodotto dati in uno spazio diverso

• Qlik_update_activate_data_product: Attiva un prodotto dati in uno spazio specifico

• Qlik_update_deactivate_data_product: Disattiva un prodotto dati

• Qlik_delete_data_product: Elimina un prodotto dati

Esempio di prompt:

“Crea un prodotto dati chiamato 'Analisi delle vendite – Curato' con una descrizione chiara e includi questi set di dati: Ordini, Clienti e Prodotti. Quindi mostrami i metadati del prodotto dati ed estrai la sua documentazione markdown in modo che io possa rivedere ciò che vedranno i consumatori. Aggiorna la descrizione per aggiungere indicazioni sull'utilizzo e aggiungi anche il set di dati Resi. Sposta il prodotto dati nel nostro spazio 'Analisi' condiviso, attivalo lì per un accesso più ampio e, se in seguito lo sostituiamo con una nuova versione, disattiva quella vecchia. 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 fluiscono recuperando la derivazione a monte per un set di dati o un'app. Poiché ogni chiamata restituisce solo un passaggio indietro, in genere la si ripete in modo ricorsivo per creare l'intera catena. Questo è utile per:

• Analisi dell'impatto.

• Risoluzione dei problemi relativi a numeri imprevisti.

• Governance o auditing.

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

Sono disponibili i seguenti strumenti:

• Qlik_get_lineage: Carica la cronologia della derivazione di un set di dati o di un'app (chiama in modo ricorsivo per l'intera catena)

Esempio di prompt:

“Mostrami l'intera derivazione a monte per il set di dati Ordini clienti. Inizia dal set di dati e torna indietro in modo ricorsivo fino a raggiungere i sistemi di origine originali. Per ogni passaggio, riepiloga qual è il genitore immediato e annota eventuali trasformazioni chiave o set di dati intermedi o app coinvolte. Quindi dimmi quale origine a monte ha maggiori probabilità di influenzare il campo net_amount se cambia.”

Voci principali (Dimensioni e Misure)

Questi strumenti aiutano gli utenti a standardizzare e riutilizzare la logica aziendale chiave in un'app lavorando con dimensioni e misure principali (libreria). È possibile inventariare ciò che è già disponibile (per evitare duplicati e incoraggiare la coerenza) ed è possibile 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.

È possibile aggiornare le voci principali con nuove definizioni, consentendo rapidi perfezionamenti. È inoltre possibile eliminare le voci principali. Ad esempio, è possibile chiedere al client LLM di ripulire qualsiasi voce principale che non è in uso in un'applicazione.

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 della libreria disponibili nell'app

• Qlik_create_measure: Crea una misura della libreria riutilizzabile con espressione

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

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

Esempio di prompt:

“Aiutami a standardizzare le metriche nella nostra app Prestazioni di vendita. Innanzitutto, elenca le dimensioni e le misure della libreria esistenti in modo da non duplicare nulla. Quindi crea una nuova dimensione della libreria 'Segmento di clientela' basata sul campo del segmento appropriato e crea una misura riutilizzabile 'Margine lordo %' utilizzando la nostra definizione standard (margine lordo diviso per le entrate, formattato come percentuale). Dopo averli creati, dimmi i nomi esatti delle voci principali a cui dovrei fare riferimento durante la creazione dei grafici in modo che tutte le dashboard utilizzino la stessa logica.”

Selezioni e filtri

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

• Applicare selezioni a uno o più campi (utilizzando valori esatti o corrispondenza in stile modello-predicato).

• Ispezionare quali filtri sono attualmente attivi.

• Cancellare le selezioni a livello globale o per un campo specifico.

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

Sono disponibili i seguenti strumenti:

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

  Nota informatica

  Quando utilizzare le selezioni rispetto alla set analysis:

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

  • Quando è necessario un filtro una tantum per un calcolo specifico, utilizzare la set analysis nelle espressioni

  Le selezioni persistono in tutte le operazioni fino a quando non vengono cancellate e influiscono su TUTTI i successivi recuperi di dati. Come best practice, per singole query analitiche, preferire la set analysis alle selezioni per evitare l'overhead 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à in modo invisibile all'utente.

  • Le selezioni restituite sono l'effettiva selezione corrente applicata e sono la verità. Eventuali campi in cui la selezione non è riuscita, ad esempio: dove i valori non esistevano, non appariranno nell'elenco restituito.

• Qlik_clear_selections: Cancella le selezioni - tutte o un campo specifico

  Nota di avvisoLe selezioni restituite sono l'effettiva selezione corrente applicata e sono la verità. Eventuali campi in cui la selezione non è riuscita, 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

Esempio di prompt:

“Imposta il mio contesto di analisi per l'app Vendite esecutive: seleziona Anno = 2025 e Regione = EMEA e applica una selezione basata su modello alla Categoria prodotto per includere solo le categorie che iniziano con 'Cloud'. Quindi mostrami le selezioni correnti in modo da poter 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 e fogli

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

• Creare un nuovo foglio come area di disegno.

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

• Posizionare i pannelli dei filtri sul foglio in modo che gli utenti possano suddividere l'analisi in modo interattivo.

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

Sono disponibili i seguenti strumenti:

• 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

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

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

  • Utilizzare la set analysis rispetto alle selezioni a livello di app per query una tantum

• Qlik_add_filter: Aggiungi un pannello dei filtri a un foglio per il filtraggio guidato dall'utente

Esempio di prompt:

“Crea un nuovo foglio chiamato 'Panoramica delle vendite' nella nostra app di analisi. Aggiungi un KPI per Entrate totali e Ordini totali, un grafico lineare che mostra le Entrate per mese e un grafico a barre che mostra le Entrate per regione (ordinato in modo decrescente). Quindi aggiungi un pannello dei filtri con Anno, Regione e Categoria prodotto in modo che gli utenti possano regolare la visualizzazione. Assicurati che gli elementi visivi abbiano un titolo chiaro e che il foglio sia pronto per un pubblico esecutivo.”