Ferramentas do Qlik MCP

O servidor Qlik MCP inclui ferramentas que permitem que seu LLM execute ações para você em seu locatário do Qlik Cloud. Você pode personalizar sua experiência selecionando quais ferramentas do Qlik MCP você deseja ter disponíveis.

Permissões de acesso e ferramentas do Qlik MCP

O acesso às ferramentas do MCP é controlado por suas permissões. Você precisa da permissão Qlik MCP: Permitido em uma função personalizada para acessar as ferramentas do Qlik MCP do seu cliente de LLM.

Além disso, como a ferramenta Qlik MCP é autorizada como o usuário de conexão, ela usa sua função de usuário e as permissões de espaço existentes. Você também precisa ter permissão no Qlik Cloud para utilizar os recursos ou o tipo de conteúdo usado pelas ferramentas. Por exemplo, se você não tiver permissão para acessar a linhagem no Qlik Cloud, não poderá usar a ferramenta Qlik MCP: obter linhagem Qlik. Dependendo das suas permissões, algumas ferramentas podem responder com sem acesso se você não puder usar a capacidade ou o recurso no Qlik Cloud.

A disponibilidade da ferramenta também pode ser limitada pelo licenciamento do seu locatário.

Selecionando as ferramentas Qlik MCP

As ferramentas Qlik MCP são um catálogo de ações criadas especificamente que um LLM pode chamar para executar ações em seu locatário do Qlik Cloud. Essas ações incluem:

• Localizando aplicativos e conjuntos de dados

• Inspecionando campos e metadados de gráficos

• Aplicando e limpando filtros

• Criando pastas e gráficos

• Gerenciando ativos governados como termos de glossário e produtos de dados.

Cada ferramenta representa uma capacidade específica com entradas e saídas bem definidas.

Ferramentas Qlik MCP disponíveis

A tabela abaixo mostra uma visão geral das categorias e nomes de ferramentas Qlik MCP atuais.

O que cada ferramenta pode realizar

Descoberta de Aplicativos e Metadados

Use estas ferramentas para encontrar o aplicativo de análise Qlik correto e entender rapidamente o que há nele antes de criar gráficos ou aplicar filtros. Esta categoria oferece suporte a um fluxo de descoberta de ponta a ponta: pesquise em recursos Qlik para localizar aplicativos relevantes.

As seguintes ferramentas estão disponíveis:

• Qlik_search: pesquise recursos Qlik (aplicativos, conjuntos de dados, produtos de dados, glossários) por nome ou conteúdo.

• Qlik_describe_apps: obtenha metadados abrangentes para um aplicativo, incluindo campos, proprietário, status de publicação.

• Qlik_get_fields: liste todos os campos de dados disponíveis em um aplicativo para uso como dimensões.

• Qlik_list_sheets: liste todas as pastas em um aplicativo.

• Qlik_get_sheet_details: obtenha detalhes sobre uma pasta específica, incluindo todos os gráficos e seus tipos.

• Qlik_search_spaces: pesquise espaços com base em uma string de consulta.

• Qlik_semantic_search_app: realize pesquisa semântica por ativos relevantes no aplicativo Qlik.

Exemplo de prompt:

"Preciso analisar a rotatividade de clientes." Este prompt simples permite:

• Use qlik_search para encontrar aplicativos relacionados a “rotatividade” ou “retenção de clientes”.

• Para a melhor correspondência, execute qlik_describe_app para confirmar se é o aplicativo correto e ver seus metadados (proprietário e status de publicação).

• Use qlik_get_fields para listar os campos disponíveis e identifique as dimensões e medidas candidatas como Customer, ChurnFlag, SubscriptionType, Region e ChurnDate.

• Use qlik_list_sheets para ver quais painéis já existem.

• Para qualquer pasta promissora, por exemplo, “Visão Geral de Rotatividade”, chame qlik_get_sheet_details e resuma quais gráficos já estão disponíveis e quais lacunas permanecem.

Glossário de Negócios

Este conjunto de ferramentas permite que um usuário configure e mantenha um glossário de negócios governado de ponta a ponta:

• Criar um glossário

• Organize-o com categorias

• Adicione e organize termos (incluindo edição, remoção e gerenciamento do status do ciclo de vida, como rascunho, verificado, obsoleto)

• Conecte esses termos a ativos de análise reais (aplicativos, conjuntos de dados, campos, itens mestre).

As seguintes ferramentas estão disponíveis:

• Qlik_create_glossary: crie um novo glossário de negócios

• Qlik_get_full_glossary_export: obtenha glossário completo com todos os termos, categorias, links (operação cara)

• Qlik_get_glossary_categories: recupere todas as categorias para um glossário

• Qlik_create_glossary_category: crie uma nova categoria dentro de um glossário

• Qlik_search_glossary_terms: pesquise termos em um glossário

• Qlik_get_glossary_term: obtenha um termo específico de um glossário

• Qlik_create_glossary_term: crie um novo termo de glossário com descrição, tags, relacionamentos

• Qlik_update_glossary_term: modifique um termo de glossário existente

• Qlik_delete_glossary_term: remova um termo de glossário

• Qlik_update_term_status: atualize o status do termo (rascunho, verificado, obsoleto). Apenas um administrador pode verificar um termo. Uma vez que o termo é verificado, apenas um administrador pode modificar o termo

  Nota informativa

  Esta operação tem três status:

  • rascunho: o termo está em estado de rascunho.

  • verificado: o termo foi verificado por um administrador.

  • obsoleto: o termo está obsoleto e não deve ser usado.

  Os nomes de status diferenciam maiúsculas de minúsculas e devem ser fornecidos exatamente como acima.

• Qlik_get_glossary_term_links: obtenha os recursos vinculados a um termo de glossário

  Esta função suporta dois modos:

  • Modo de link único: forneça parâmetros individuais para resource_id ou resource_type da instância.

  • Modo em lote: forneça uma lista de dicionários de link por meio do parâmetro 'links'

  Nota informativa

  Ao vincular a um subrecurso, todos os três campos de subrecurso (subResourceId, subResourceName e subResourceType) devem ser fornecidos juntos para cada link.

• Qlik_create_glossary_term_links: vincule um termo a aplicativos, conjuntos de dados, campos, itens mestre

Exemplo de prompt:

"Ajude-me a construir e governar um glossário de negócios para o nosso domínio de vendas. Crie um glossário chamado "Glossário de vendas", adicione as categorias "Receita", "Clientes" e "Pipeline". Em seguida, crie termos para "Receita Recorrente Anual (ARR)" e "Rotatividade de Clientes" com definições claras e tags, por exemplo, finanças e operações de vendas, defina-os como rascunho e vincule cada termo aos campos de conjunto de dados relevantes e aos itens mestre de KPI."

Conjuntos de Dados e Qualidade de Dados

Essas ferramentas ajudam o usuário a entender, validar e governar conjuntos de dados, inspecionando o que o conjunto de dados é (metadados e associações de produtos de dados), o que ele contém (esquema) e qual a aparência dos dados (estatísticas de perfil - distribuições e uma amostra rápida de linhas). As ferramentas também dão suporte a fluxos de trabalho de gestão de dados: aprimorando a documentação do conjunto de dados (nome-descrição) e acionando e monitorando cálculos de qualidade de dados para atualizar as métricas de qualidade ao longo do tempo.

As seguintes ferramentas estão disponíveis:

• Qlik_get_dataset: carregue metadados de um conjunto de dados, incluindo pontuação de confiança

• Qlik_get_dataset_schema: carregue o esquema (definições de coluna) de um conjunto de dados

• Qlik_get_dataset_profile: carregue dados de perfil (estatísticas, distribuições) de um conjunto de dados

• Qlik_get_dataset_sample: carregue as 10 primeiras linhas de um conjunto de dados para visualização

• Qlik_get_dataset_freshness: obtenha o carimbo de data/hora da última atualização de um conjunto de dados

• Qlik_get_dataset_trust_score: obtenha a pontuação de confiança de um conjunto de dados

• Qlik_get_dataset_memberships: obtenha associações de produtos de dados para um conjunto de dados

• Qlik_update_dataset_metadata: atualize nome e descrição de um conjunto de dados

• Qlik_update_dataset_quality: solicite um cálculo de qualidade de dados para um conjunto de dados

• Qlik_update_dataset_quality: solicite um cálculo de qualidade de dados para um conjunto de dados

• Qlik_get_dataset_quality_computation_status: verifique o status de um cálculo de qualidade

Exemplo de prompt:

“Avaliar a prontidão do nosso conjunto de dados de pedidos de clientes para um novo painel. Mostre-me seus metadados e pontuação de confiança atual, confirme a última hora de atualização e liste a quais produtos de dados ele pertence. Em seguida, carregue o esquema e uma amostra de 10 linhas para verificar campos chave como order_date, customer_id e net_amount. Execute um perfil do conjunto de dados para identificar valores ausentes e discrepâncias e, se as métricas de qualidade parecerem desatualizadas, acione um cálculo de qualidade de dados e continue verificando o status da tarefa até que ela seja concluída. Finalmente, atualize a descrição do conjunto de dados para documentar restrições conhecidas e uso recomendado.”

Exploração e Análise de Dados

Essas ferramentas suportam investigação rápida e ad-hoc de dados e conteúdo analítico existente sem exigir que o usuário crie permanentemente novas visualizações. Você pode criar cálculos temporários ou consultar objetos para responder a perguntas “hipotéticas”, inspecionar campos listando valores distintos ou pesquisar valores específicos.

As seguintes ferramentas estão disponíveis:

• Qlik_create_data_object: crie objetos de cálculo temporários para consultas de análise ad-hoc

  Nota informativa

  Use get_field_values() ou search_field_values() antes de aplicar seleções para verificar se os valores existem.

  Nota de advertência

  O Qlik executa TODOS os cálculos, portanto:

  • Nunca agregue, some, calcule a média ou compute sobre os dados retornados: os valores são finais.

  • Para cálculos diferentes, chame a ferramenta novamente com novas expressões.

  • Sempre aplique filtros-seleções apropriados para limitar o tamanho dos dados e melhorar o desempenho.

• Qlik_get_field_values: obtenha valores distintos para um campo específico (usar antes da filtragem)

  Nota informativa

  Para campos de alta cardinalidade, sempre use qlik_search_field_values() em vez disso.

  Nota de advertência

  Use esta ferramenta ou qlik_search_field_values() ANTES de criar seleções-filtros para verificar se os valores existem. Isso ajuda a evitar erros ao aplicar filtros com valores inexistentes.

• Qlik_search_field_values: pesquise valores específicos em campos (verificar antes da análise de conjunto)

  Nota de advertência

  Antes de criar objetos de dados com análise de conjunto ou seleções: use qlik_search_field_values para verificar se os valores existem. Isso evita erros de valores de filtro inexistentes, especialmente importante para: anos, datas, códigos de moeda, nomes de produtos.

  Exemplo de fluxo de trabalho de práticas recomendadas:

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

  2. Verifique se "2022" existe nos resultados

  3. Criar objeto de dados usando {payment_year={2022}.

• Qlik_get_chart_data: recupere dados paginados de uma visualização de gráfico existente

• Qlik_get_chart_info: obtenha metadados sobre um gráfico sem recuperar seus dados

Exemplo de prompt:

“Ajude-me a investigar por que a receita da região Norte caiu no mês passado. Primeiro, verifique o gráfico existente de "Receita por Região": mostre-me seus metadados (dimensões, medidas, filtros, contagem de linhas) e, em seguida, extraia os dados do gráfico dos últimos dois meses. Antes de aplicar quaisquer seleções, liste os valores distintos para Região e pesquise os valores do campo para confirmar se "North", "NORTH" ou "Northern" é usado. Em seguida, crie um cálculo temporário para comparar a receita e a margem mês a mês para o Norte versus outras regiões, e destaque quais categorias de produtos mais contribuíram para a mudança.”

Produtos de Dados

Essas ferramentas gerenciam o ciclo de vida completo de um produto de dados como um pacote governado e compartilhável de conjuntos de dados:

1. Crie-o.

2. Inspecione seus metadados e documentação.

3. Mantenha sua definição (nome, descrição e quais conjuntos de dados ele contém)

4. Controle onde e se ele está disponível, movendo-o entre espaços e ativando-o ou desativando-o.

Eles também suportam a limpeza de fim de vida útil, excluindo um produto de dados quando ele não é mais necessário.

As seguintes ferramentas estão disponíveis:

• Qlik_create_data_product: crie um novo produto de dados

• Qlik_get_data_product: obtenha metadados para um produto de dados específico

• Qlik_get_data_product_documentation: obtenha documentação de marcação de um produto de dados

• Qlik_update_data_product: atualize as propriedades (nome, descrição, conjuntos de dados) de um produto de dados

• Qlik_update_data_product_space: mova um produto de dados para um espaço diferente

• Qlik_update_activate_data_product: ative um produto de dados em um espaço específico

• Qlik_update_deactivate_data_product: desative um produto de dados

• Qlik_delete_data_product: exclua um produto de dados

Exemplo de prompt:

“Crie um produto de dados chamado "Análise de Vendas – Selecionada" com uma descrição clara e inclua estes conjuntos de dados: Pedidos, Clientes e Produtos. Em seguida, mostre-me os metadados do produto de dados e extraia sua documentação de marcação para que eu possa revisar o que os consumidores verão. Atualize a descrição para adicionar orientações de uso e inclua também o conjunto de dados de retornos. Mova o produto de dados para o nosso espaço compartilhado de "Análises", ative-o lá para acesso mais amplo e, se posteriormente o substituirmos por uma nova versão, desative a versão antiga. Finalmente, se o produto for totalmente desativado e não for mais referenciado, exclua-o.”

Linhagem

Esta ferramenta permite que um usuário rastreie a origem dos dados e como eles fluem, recuperando a linhagem upstream para um conjunto de dados ou aplicativo. Como cada chamada retorna apenas um passo para trás, você geralmente a repete recursivamente para construir a cadeia completa. Isso é útil para:

• Análise de impacto.

• Solução de problemas de números inesperados.

• Governança ou auditoria.

• Identifique as reais fontes que alimentam um relatório ou conjunto de dados.

As seguintes ferramentas estão disponíveis:

• Qlik_get_lineage: carregue o histórico de linhagem de um conjunto de dados ou aplicativo (chamar recursivamente para a cadeia completa)

Exemplo de prompt:

“Mostre-me a linhagem completa a montante para o conjunto de dados Pedidos de clientes. Comece a partir do conjunto de dados e retroceda recursivamente até chegar aos sistemas de origem originais. Para cada etapa, resuma qual é o pai imediato e anote quaisquer transformações importantes, conjuntos de dados intermediários ou aplicativos envolvidos. Então me diga qual fonte a montante é mais provável que afete o campo net_amount se ele mudar.”

Itens Mestre (Dimensões e Medidas)

Essas ferramentas ajudam os usuários a padronizar e reutilizar a lógica de negócios principal em um aplicativo, trabalhando com dimensões e medidas mestras (de biblioteca). Você pode inventariar o que já está disponível (para evitar duplicatas e promover a consistência) e pode criar novas dimensões e medidas reutilizáveis para que os gráficos em várias pastas usem as mesmas definições de campo e expressões de cálculo, melhorando a governança, a manutenção e o alinhamento de métricas.

As seguintes ferramentas estão disponíveis:

• Qlik_list_dimensionst: liste todas as dimensões de biblioteca disponíveis no aplicativo

• Qlik_create_dimension: crie uma dimensão de biblioteca reutilizável

• Qlik_update_dimension: atualize uma dimensão de biblioteca existente em um aplicativo Qlik

• Qlik_delete_dimension: exclua uma dimensão de biblioteca de um aplicativo Qlik

• Qlik_list_measures: liste todas as medidas de biblioteca disponíveis no aplicativo

• Qlik_create_measure: crie uma medida de biblioteca reutilizável com expressão

• Qlik_update_measure: atualize uma medida de biblioteca existente em um aplicativo Qlik

• Qlik_delete_measure: exclua uma medida da biblioteca de um aplicativo Qlik

Exemplo de prompt:

“Ajude-me a padronizar as métricas em nosso aplicativo de Desempenho de Vendas. Primeiro, liste as dimensões e medidas da biblioteca existentes para que não dupliquemos nada. Em seguida, crie uma nova dimensão de biblioteca chamada "Segmento de Clientes" com base no campo de segmento apropriado e crie uma medida reutilizável chamada "% de Margem Bruta" usando nossa definição padrão (margem bruta dividida pela receita, formatada como uma porcentagem). Depois de criá-los, diga-me os nomes exatos dos itens mestre que devo referenciar ao criar gráficos para que todos os painéis usem a mesma lógica.”

Seleções e Filtragem

Essas ferramentas controlam o estado do filtro interativo de um aplicativo Qlik:

• Aplique as seleções a um ou mais campos (usando valores exatos ou correspondência no estilo de predicado de padrão).

• Inspecione quais filtros estão atualmente ativos.

• Limpe seleções globalmente ou para um campo específico.

Juntos, eles oferecem suporte a fluxos de análise guiada, etapas de investigação reproduzíveis.

As seguintes ferramentas estão disponíveis:

• Qlik_select_values: aplique as seleções (filtros) a campos - oferece suporte a valores exatos e correspondência de padrão

  Nota informativa

  Quando usar seleções em vez de análise de conjunto:

  • Quando você quiser filtrar o aplicativo ou a sessão inteira para várias operações subsequentes, use select_values().

  • Quando precisar de um filtro único para um cálculo específico, use a análise de conjunto em expressões

  As seleções persistem em todas as operações até serem limpas; elas afetam TODAS as recuperações de dados subsequentes. Como prática recomendada, para consultas analíticas únicas, prefira a análise de conjunto em vez de seleções para evitar a sobrecarga de gerenciamento de estado.

  Nota de advertência

  • Use qlik_get_field_values() ou qlik_search_field_values() primeiro para verificar se os valores que você deseja selecionar existem. A seleção de valores inexistentes falhará silenciosamente.

  • As seleções retornadas são a seleção aplicada atual real são verdade. Quaisquer campos onde a seleção falhou, por exemplo: onde os valores não existiam, não aparecerão na lista retornada.

• Qlik_clear_selections: limpe as seleções - todos ou campo específico

  Nota de advertênciaAs seleções retornadas são as seleções atuais aplicadas e representam a verdade. Quaisquer campos onde a seleção falhou, por exemplo, se os valores não existiam, não aparecerão na lista retornada.

• Qlik_get_current_selections: obtenha as seleções ou filtros atualmente ativos no aplicativo

• Qlik_update_filter: atualize um painel de filtro existente em um aplicativo Qlik

Exemplo de prompt:

“Configure o contexto de análise para o aplicativo Vendas Executivas: selecione Ano = 2025 e Região = EMEA e aplique uma seleção baseada em padrões na Categoria do Produto para incluir apenas as categorias que começam com "Nuvem". Então me mostre as seleções atuais para que eu possa confirmar o que está ativo. Após analisar os KPIs, limpe apenas a seleção da Categoria do Produto (mantendo Ano e Região) e, por fim, limpe todas as seleções para redefinir o aplicativo para um estado sem filtros.”

Visualização e Pastas

Essas ferramentas permitem aos usuários montar painéis em um aplicativo Qlik:

• Crie uma nova pasta como uma tela.

• Adicione visualizações (gráficos, tabelas, KPIs.) configuradas com dimensões, medidas e opções de exibição.

• Coloque painéis de filtro na pasta para que os usuários possam segmentar interativamente a análise.

Juntos, eles cobrem o fluxo de trabalho básico de construção de uma página de painel utilizável e de autoatendimento.

As seguintes ferramentas estão disponíveis:

• Qlik_create_sheet: crie uma nova pasta vazia (painel) no aplicativo

• Qlik_add_chart: adicione uma visualização (gráfico de barra, linha, pizza, tabela, KPI, etc.) a uma pasta

  Nota informativa

  • Planeje a estrutura da sua consulta antes de fazer chamadas de ferramenta.

  • Teste a existência de valores de data com qlik_search_field_values ou qlik_get_field_values primeiro

  • Use a análise de conjunto em vez de seleções no nível do aplicativo para consultas únicas

• Qlik_add_filter: adicione um painel de filtro a uma pasta para filtragem orientada pelo usuário

• Qlik_delete_object: exclua um objeto de um aplicativo Qlik (gráfico, pasta, filtro, etc.)

• Qlik_show_chart: mostre uma visualização renderizada como um snapshot do Qlik

• Qlik_update_chart: atualize uma visualização de gráfico existente em um aplicativo Qlik

Exemplo de prompt:

“Crie uma nova pasta chamada "Visão Geral de Vendas" em nosso aplicativo de análise. Adicionar um KPI para Receita Total e Pedidos Totais, um gráfico de linhas mostrando Receita por Mês e um gráfico de barras mostrando Receita por Região (classificado em ordem decrescente). Em seguida, adicione um painel de filtro com Ano, Região e Categoria do Produto para que os usuários possam ajustar a visualização. Certifique-se de que os visuais tenham títulos claros e a pasta esteja pronta para um público executivo.”