Strumenti MCP di Qlik

Il server MCP di Qlik include strumenti che consentono al LLM di eseguire azioni per conto dell'utente nel tenant di Qlik Cloud. È possibile personalizzare l'esperienza selezionando quali strumenti MCP di Qlik rendere disponibili.

Autorizzazioni di acesso e strumenti MCP di Qlik

L'accesso agli strumenti MCP è controllato dalle autorizzazioni dell'utente. Per accedere agli strumenti MCP di Qlik dal client LLM, è necessaria l'autorizzazione Qlik MCP: Consentito in un ruolo personalizzato.

Inoltre, poiché lo strumento MCP di Qlik è autorizzato come utente connesso, 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 utilizzati 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 un messaggio di mancato accesso se non è possibile utilizzare la capacità o la funzionalità in Qlik Cloud.

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

Selezione degli strumenti MCP di Qlik

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

• Ricerca di applicazioni e set di dati

• Ispezione dei campi e dei metadati dei grafici

• Applicazione e cancellazione dei filtri

• Creazione di fogli e grafici

• Gestione di risorse gestite 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 e dei nomi degli strumenti MCP Qlik.

Cosa può realizzare ciascuno strumento

Individuazione app e metadati

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

Sono disponibili i seguenti strumenti:

• Qlik_search: consente di cercare risorse Qlik (applicazioni, set di dati, prodotti dati, glossari, knowledge base) per nome o contenuto.

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

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

• Qlik_list_sheets: consente di elencare tutti i fogli in un'app.

• Qlik_get_sheet_details: consente di ottenere dettagli su un foglio specifico, inclusi tutti i grafici e i relativi tipi.

• Qlik_search_spaces: consente di cercare 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 correlate a "churn" o "customer retention".

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

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

• Utilizzare qlik_list_sheets per vedere quali dashboard esistono già.

• Per qualsiasi foglio promettente, ad esempio "Churn Overview", 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 controllato 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: consente di creare un nuovo glossario aziendale

• Qlik_get_full_glossary_export: consente di ottenere il glossario completo con tutti i termini, le categorie e i collegamenti (operazione costosa)

• Qlik_get_glossary_categories: consente di recuperare tutte le categorie per un glossario

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

• Qlik_search_glossary_terms: consente di cercare termini all'interno di un glossario

• Qlik_get_glossary_term: consente di ottenere un termine specifico da un glossario

• Qlik_create_glossary_term: consente di creare un nuovo termine del glossario con descrizione, tag e relazioni

• Qlik_update_glossary_term: consente di modificare un termine del glossario esistente

• Qlik_delete_glossary_term: consente di rimuovere un termine del glossario

• Qlik_update_term_status: consente di aggiornare 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 prevede tre stati:

  • draft: il termine è nello 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: consente di ottenere le risorse collegate a un termine del glossario

  Questa funzione supporta due modalità:

  • Modalità collegamento singolo: fornire parametri individuali, ad esempio resource_id o resource_type.

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

  Nota informatica

  Quando si effettua il collegamento 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: consente di collegare un termine ad app, set di dati, campi, voci principali

Esempio di prompt:

"Aiutami a creare e gestire un glossario aziendale per il nostro dominio Sales. Crea un glossario chiamato "Sales Glossary", aggiungi le categorie "Revenue", "Customers" e "Pipeline". Quindi crea i termini per "Annual Recurring Revenue (ARR)" e "Customer Churn" con definizioni chiare e tag, ad esempio finance e sales-ops, 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 l'utente a comprendere, convalidare e gestire i set di dati ispezionando la natura del set di dati (metadati e appartenenze a prodotti dati), il suo contenuto (schema) e l'aspetto dei 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: consente di caricare i metadati di un set di dati, incluso il punteggio di attendibilità

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

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

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

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

• Qlik_get_dataset_trust_score: consente di ottenere il punteggio di attendibilità di un set di dati

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

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

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

• Qlik_get_dataset_quality_computation_status: consente di verificare lo stato di un calcolo della qualità

Esempio di prompt:

“Valuta l'idoneità del nostro set di dati Customer Orders pentru una nuova dashboard. Mostrami i relativi metadati e il punteggio di attendibilità 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 verificare la correttezza 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, avvia un calcolo della qualità dei dati e continua a controllare lo stato del processo fino al 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 l'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 ipotetiche, ispezionare i campi elencando valori distinti o cercare valori specifici.

Sono disponibili i seguenti strumenti:

• Qlik_create_data_object: consente di creare 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 la dimensione dei dati e migliorare le prestazioni.

• Qlik_get_field_values: consente di ottenere 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ò consente di evitare errori durante l'applicazione di filtri con valori inesistenti.

• Qlik_search_field_values: consente di cercare valori specifici tra i 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 dovuti a valori di filtro inesistenti, particolarmente importante per: anni, date, codici valuta, nomi di prodotti.

  Esempio di flusso di lavoro basato sulle 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: consente di recuperare dati impaginati da una visualizzazione di grafico esistente

• Qlik_get_chart_info: consente di ottenere metadati su un grafico senza recuperarne i dati

Esempio di prompt:

“Aiutami a indagare sul motivo per cui i ricavi della regione North sono diminuiti il mese scorso. Innanzitutto, controlla il grafico esistente "Revenue by Region": mostrami i relativi metadati (dimensioni, misure, filtri, conteggio righe) e quindi estrai i dati del grafico per gli ultimi due mesi. Prima di applicare qualsiasi selezione, elenca i valori distinti per Region e cerca i valori dei campi 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 North rispetto ad altre regioni ed evidenzia quali categorie di prodotti hanno contribuito maggiormente alla variazione.”

Prodotti dati

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

1. Crearlo.

2. Ispezionarne i metadati e la documentazione.

3. Gestirne la definizione (nome, descrizione e set di dati in esso contenuti)

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

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

Sono disponibili i seguenti strumenti:

• Qlik_create_data_product: consente di creare un nuovo prodotto dati

• Qlik_get_data_product: consente di ottenere i metadati per un prodotto dati specifico

• Qlik_get_data_product_documentation: consente di ottenere la documentazione markdown di un prodotto dati

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

• Qlik_update_data_product_space: consente di spostare un prodotto dati in uno spazio diverso

• Qlik_update_activate_data_product: consente di attivare un prodotto dati in uno spazio specifico

• Qlik_update_deactivate_data_product: consente di disattivare un prodotto dati

• Qlik_delete_data_product: consente di eliminare un prodotto dati

Esempio di prompt:

“Crea un prodotto dati chiamato "Sales Analytics – Curated" con una descrizione chiara e includi questi set di dati: Orders, Customers e Products. Quindi mostrami i metadati del prodotto dati ed estrai la relativa documentazione markdown in modo che io possa esaminare ciò che vedranno i consumatori. Aggiorna la descrizione per aggiungere linee guida sull'uso e aggiungi anche il set di dati 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 viene più fatto riferimento ad esso, eliminalo.”

Derivazione

Questo strumento consente a un utente di tracciare la provenienza dei dati e il modo in cui 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 la catena completa. Questo è utile per:

• Analisi dell'impatto.

• Risoluzione dei problemi relativi a numeri imprevisti.

• Governance o controllo.

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

Sono disponibili i seguenti strumenti:

• Qlik_get_lineage: consente di caricare la cronologia della derivazione di un set di dati o di un'app (chiamare in modo ricorsivo per la catena completa)

Esempio di prompt:

“Mostrami la derivazione a monte completa per il set di dati Customer Orders. Partendo dal set di dati, torna indietro in modo ricorsivo fino a raggiungere i sistemi di origine originali. Per ogni passaggio, riepiloga qual è il genitore immediato e prendi nota di eventuali trasformazioni chiave o set di dati o app intermedi coinvolti. Quindi dimmi quale sorgente a monte ha maggiori probabilità di influire sul campo net_amount in caso di modifica.”

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 (di libreria). È possibile inventariare ciò che è già disponibile (per evitare duplicati e incoraggiare la coerenza) e 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 perfezionamenti rapidi. È inoltre possibile eliminare le voci principali. Ad esempio, è possibile chiedere al client LLM di ripulire qualsiasi voce principale che non sia in uso in un'applicazione.

Sono disponibili i seguenti strumenti:

• Qlik_list_dimensionst: consente di elencare tutte le dimensioni di libreria disponibili nell'app

• Qlik_create_dimension: consente di creare una dimensione di libreria riutilizzabile

• Qlik_update_dimension: consente di aggiornare una dimensione di libreria esistente in un'app Qlik

• Qlik_delete_dimension: consente di eliminare una dimensione di libreria da un'app Qlik

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

• Qlik_create_measure: consente di creare una misura di libreria riutilizzabile con espressione

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

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

Esempio di prompt:

“Aiutami a standardizzare le metriche nella nostra app Sales Performance. Innanzitutto, elenca le dimensioni e le misure di libreria esistenti in modo da non duplicare nulla. Quindi crea una nuova dimensione di libreria "Customer Segment" basata sul campo del segmento appropriato e crea una misura riutilizzabile "Gross Margin %" utilizzando la nostra definizione standard (margine lordo diviso per i ricavi, formattato come percentuale). Dopo averle create, indicami i nomi esatti delle voci principali a cui fare riferimento durante la creazione dei grafici, in modo che tutte le dashboard utilizzino la stessa logica.”

Selezioni e filtraggio

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

• Applicare selezioni a uno o più campi (utilizzando valori esatti o corrispondenze in stile pattern-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: consente di applicare selezioni (filtri) ai campi; supporta valori esatti e corrispondenza di pattern

  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 finché non vengono cancellate e influiscono su TUTTI i recuperi di dati successivi. Come best practice, per le singole query analitiche, preferire la set analysis 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 avrà esito negativo senza segnalazioni.

  • Le selezioni restituite sono l'effettiva selezione corrente applicata. Qualsiasi campo in cui la selezione non è riuscita, ad esempio dove i valori non esistevano, non apparirà nell'elenco restituito.

• Qlik_clear_selections: consente di cancellare le selezioni, tutte o per un campo specifico

  Nota di avvisoLe selezioni restituite sono l'effettiva selezione corrente applicata. Qualsiasi campo in cui la selezione non è riuscita, ad esempio se i valori non esistevano, non apparirà nell'elenco restituito.

• Qlik_get_current_selections: consente di ottenere le selezioni o i filtri attualmente attivi nell'app

Esempio di prompt:

“Imposta il mio contesto di analisi per l'app Executive Sales: seleziona Year = 2025 e Region = EMEA, e applica una selezione basata su pattern su Product Category per includere solo le categorie che iniziano con "Cloud". Quindi mostrami le selezioni correnti in modo che possa confermare cosa è attivo. Dopo aver esaminato i KPI, cancella solo la selezione Product Category (mantieni Year e Region) e infine cancella tutte le selezioni per ripristinare l'app allo 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 di filtro sul foglio in modo che gli utenti possano analizzare l'analisi in modo interattivo.

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

Sono disponibili i seguenti strumenti:

• Qlik_create_sheet: consente di creare un nuovo foglio vuoto (dashboard) nell'app

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

  Nota informatica

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

  • Verificare 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: consente di aggiungere un pannello di filtro a un foglio per il filtraggio guidato dall'utente

Esempio di prompt:

“Crea un nuovo foglio chiamato "Sales Overview" nella nostra app di analisi. Aggiungi un KPI per Total Revenue e Total Orders, un grafico lineare che mostra Revenue by Month e un grafico a barre che mostra Revenue by Region (ordinato in modo decrescente). Quindi aggiungi un pannello di filtro con Year, Region e Product Category in modo che gli utenti possano regolare la visualizzazione. Assicurati che gli elementi visivi abbiano titoli chiari e che il foglio sia pronto per un pubblico di dirigenti.”