Herramientas de Qlik MCP

El servidor MCP de Qlik incluye herramientas que permiten a su LLM realizar acciones por usted en su espacio empresarial inquilino de Qlik Cloud. Puede personalizar su experiencia seleccionando qué herramientas de Qlik MCP desea tener disponibles.

Permisos de acceso y herramientas de Qlik MCP

El acceso a las herramientas de MCP está controlado por sus permisos. Necesita el permiso Qlik MCP configurado en Permitido en un rol personalizado para poder acceder a las herramientas de Qlik MCP desde su cliente LLM.

Además, como la herramienta de Qlik MCP está autorizada como el usuario que se conecta, utiliza su rol de usuario y permisos de espacio existentes. También necesita tener permiso en Qlik Cloud para usar las capacidades o el tipo de contenido utilizados por las herramientas. Por ejemplo, si no tiene permiso para acceder al linaje en Qlik Cloud, no puede usar la herramienta de Qlik MCP Obtener linaje de Qlik. Según sean sus permisos, algunas herramientas podrían responder con "No tiene acceso" si no puede usar la capacidad o función en Qlik Cloud.

La disponibilidad de las herramientas también puede estar limitada por la licencia de su espacio empresarial inquilino.

Seleccionar herramientas de Qlik MCP

Las herramientas de Qlik MCP son un catálogo de acciones diseñadas específicamente para que un LLM pueda invocar acciones en su espacio empresarial inquilino de Qlik Cloud. Dichas acciones incluyen:

• Buscar aplicaciones y conjuntos de datos

• Inspeccionar campos y metadatos de gráficos

• Aplicar y borrar filtros

• Crear hojas y gráficos

• Gestionar activos gobernados como términos de glosario y productos de datos.

Cada herramienta representa una capacidad específica con entradas y salidas bien definidas.

Herramientas disponibles de Qlik MCP

La tabla siguiente muestra una descripción general de las categorías y nombres de las herramientas actuales de Qlik MCP.

Lo que cada herramienta puede lograr

Detección de aplicaciones y metadatos

Use estas herramientas para encontrar la aplicación de análisis adecuada de Qlik y comprender rápidamente lo que contiene antes de crear gráficos o aplicar filtros. Esta categoría admite un flujo de detección de extremo a extremo: busque en los recursos de Qlik para localizar aplicaciones relevantes.

Están disponibles las siguientes herramientas:

• Qlik_search: busca recursos de Qlik (aplicaciones, conjuntos de datos, productos de datos, glosarios) por nombre o contenido.

• Qlik_describe_apps: permite obtener metadatos completos de una aplicación, incluyendo campos, propietario y estado de publicación.

• Qlik_get_fields: muestra todos los campos de datos disponibles en una aplicación para usar como dimensiones.

• Qlik_list_sheets: muestra todas las hojas de una aplicación.

• Qlik_get_sheet_details: permite obtener detalles sobre una hoja específica, incluidos todos los gráficos y sus tipos.

• Qlik_search_spaces: busca espacios basándose en una cadena de consulta.

• Qlik_search_spaces: realiza una búsqueda semántica de activos relevantes en la aplicación de Qlik.

Ejemplo de prompt:

"Necesito analizar la rotación de clientes." Este prompt sencillo permite:

• Utilizar qlik_search para encontrar aplicaciones relacionadas con “abandono” o “retención de clientes”.

• Para obtener la mejor coincidencia posible, ejecute qlik_describe_app para confirmar que es la aplicación correcta y ver sus metadatos (propietario y estado de publicación).

• Utilice qlik_get_fields para mostrar los campos disponibles e identificar dimensiones y medidas candidatas como Cliente, IndicadorDeBaja, TipoDeSuscripción, Región y FechaDeBaja.

• Utilice qlik_list_sheets para ver qué cuadros o paneles de mando ya existen.

• Para cualquier hoja con pinta atractiva, por ejemplo, “Resumen de abandono de clientes”, invoque a qlik_get_sheet_details y podrá ver resumido qué gráficos ya están disponibles y qué lagunas faltan.

Glosario empresarial

Este conjunto de herramientas permite a un usuario configurar y mantener un glosario empresarial gobernado de principio a fin:

• Crear un glosario

• Organizarlo por categorías

• Añadir y organizar términos (incluyendo editar, eliminar y administrar el estado del ciclo de vida como borrador -verificado-obsoleto)

• Conectar esos términos a recursos activos de análisis reales (aplicaciones, conjuntos de datos, campos, elementos maestros).

Están disponibles las siguientes herramientas:

• Qlik_create_glossary: permite crear un nuevo glosario empresarial

• Qlik_get_full_glossary_export: permite obtener el glosario completo con todos los términos, categorías y enlaces (operación que exige bastantes recursos)

• Qlik_get_glossary_categories: permite recuperar todas las categorías de un glosario

• Qlik_create_glossary_category: permite crear una nueva categoría dentro de un glosario

• Qlik_search_glossary_terms: permite buscar términos dentro de un glosario

• Qlik_get_glossary_term: permite obtener un término específico de un glosario

• Qlik_create_glossary_term: permite crear un nuevo término de glosario con descripción, etiquetas, relaciones

• Qlik_update_glossary_term: permite modificar un término de glosario existente

• Qlik_delete_glossary_term: permite eliminar un término del glosario

• Qlik_update_term_status: permite actualizar el estado del término (borrador, verificado, obsoleto). Solo un administrador de datos puede verificar un término. Una vez que el término está verificado, solo un administrador de datos puede modificarlo.

  Nota informativa

  Esta operación tiene tres estados:

  • Borrador: el término se encuentra en estado de borrador.

  • Verificado: el término ha sido verificado por un administrador de datos.

  • Obsoleto: el término está obsoleto y no debe usarse.

  Los nombres de estado distinguen entre mayúsculas y minúsculas y deben proporcionarse exactamente como se indica arriba.

• Qlik_get_glossary_term_links: permite obtener recursos vinculados a un término del glosario

  Esta función admite dos modos:

  • Modo de enlace único: proporcione parámetros individuales, por ejemplo, resource_id o resource_type.

  • Modo por lotes: proporcione una lista de diccionarios de enlace a través del parámetro "links"

  Nota informativa

  Al vincular a un subrecurso, los tres campos del subrecurso (subResourceId, subResourceName y subResourceType) deben proporcionarse juntos para cada enlace.

• Qlik_create_glossary_term_links: permite vincular un término a aplicaciones, conjuntos de datos, campos, elementos maestros

Ejemplo rápido:

"Ayúdame a construir y gobernar un Glosario de negocio para nuestro dominio de Ventas. Cree un glosario llamado "Glosario de Ventas", añada las categorías 'Ingresos', 'Clientes' y 'Proceso o canalización de datos'. Luego cree términos como "Ingresos recurrentes anuales (ARR)" y "Abandono de clientes" con definiciones claras y etiquetas, por ejemplo, finanzas y operaciones de ventas, configúrelos como borrador y vincule cada término a los campos de conjunto de datos relevantes y a los elementos maestros de KPI."

Conjuntos de datos y calidad de los datos

Estas herramientas ayudan a un usuario a comprender, validar y gobernar conjuntos de datos inspeccionando qué es el conjunto de datos (metadatos y membresías de productos de datos), qué contiene (esquema), cómo se ven los datos (estadísticas de perfilado-distribuciones y una muestra rápida de filas). Las herramientas también admiten flujos de trabajo de administración de datos: mejorando la documentación del conjunto de datos (nombre-descripción) y activando y supervisando los cálculos de calidad de los datos para actualizar las métricas de calidad a lo largo del tiempo.

Están disponibles las siguientes herramientas:

• Qlik_get_dataset: permite cargar metadatos de un conjunto de datos, incluida la puntuación de confianza

• Qlik_get_dataset_schema: permite cargar el esquema (definiciones de columna) de un conjunto de datos

• Qlik_get_dataset_profile: permite cargar datos de perfil (estadísticas, distribuciones) de un conjunto de datos

• Qlik_get_dataset_sample: permite cargar las primeras 10 filas de un conjunto de datos para previsualización

• Qlik_get_dataset_freshness: permite obtener la fecha y hora de la última actualización de un conjunto de datos

• Qlik_get_dataset_trust_score: permite obtener la puntuación de confianza de un conjunto de datos

• Qlik_get_dataset_memberships: permite obtener las embresías de productos de datos de un conjunto de datos

• Qlik_update_dataset_metadata: permite actualizar el nombre y la descripción de un conjunto de datos

• Qlik_update_dataset_quality: permite solicitar un cálculo de calidad de datos para un conjunto de datos

• Qlik_update_dataset_quality: permite solicitar un cálculo de calidad de datos para un conjunto de datos

• Qlik_get_dataset_quality_computation_status: permite comprobar el estado de un cálculo de calidad

Ejemplo rápido:

“Evalúa la preparación de nuestro conjunto de datos de Pedidos de Clientes para un nuevo panel de control. Muéstrame sus metadatos y la puntuación de confianza actual, confirma la última hora de actualización y muestra a qué productos de datos pertenece. Luego carga el esquema y una muestra de 10 filas para verificar campos clave como order_date, customer_id y net_amount. Ejecuta un perfil de conjunto de datos para detectar valores que faltan y valores atípicos, y, si las métricas de calidad parecen obsoletas, activa un cálculo de calidad de datos y sigue comprobando el estado del trabajo hasta que se complete. Por último, actualiza la descripción del conjunto de datos para documentar las restricciones conocidas y el uso recomendado.”

Exploración de datos & Análisis

Estas herramientas permiten la investigación rápida y ad hoc de datos y el contenido analítico existente sin requerir que el usuario cree permanentemente nuevas visualizaciones. Puede crear cálculos temporales, o consultar objetos para responder a preguntas hipotéticas, inspeccionar campos listando valores distintos o buscar valores específicos.

Están disponibles las siguientes herramientas:

• Qlik_create_data_object: permite crear objetos de cálculo temporales para consultas de análisis ad hoc

  Nota informativa

  Utilice get_field_values() o search_field_values() antes de aplicar selecciones para verificar que los valores existen.

  Nota de aviso

  Qlik realiza TODOS los cálculos, por lo tanto:

  • Nunca agregue, sume, promedie o calcule sobre los datos devueltos: los valores son finales.

  • Para cálculos diferentes, vuelva a llamar a la herramienta con nuevas expresiones.

  • Aplique siempre los filtros/selecciones adecuados para limitar el tamaño de los datos y mejorar el rendimiento.

• Qlik_get_field_values: permite obtener valores distintos para un campo específico (usar antes de filtrar)

  Nota informativa

  Para campos de alta cardinalidad, utilice siempre qlik_search_field_values() en su lugar.

  Nota de aviso

  Utilice esta herramienta o qlik_search_field_values() ANTES de crear selecciones/filtros para verificar que los valores existen. Esto ayuda a evitar errores al aplicar filtros con valores inexistentes.

• Qlik_search_field_values: permite buscar valores específicos en los campos (verificar antes del análisis de conjuntos)

  Nota de aviso

  Antes de crear objetos de datos con análisis de conjuntos o selecciones: utilice qlik_search_field_values para verificar que los valores existen. Esto evita errores por valores de filtro inexistentes, especialmente importante para: años, fechas, códigos de moneda, nombres de productos.

  Ejemplo de flujo de trabajo de mejores prácticas:

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

  2. Verificar que "2022" existe en los resultados

  3. Crear objeto de datos usando {payment_year={2022}.

• Qlik_get_chart_data: permite recuperar datos paginados de una visualización de gráfico existente

• Qlik_get_chart_info: permite obtener metadatos sobre un gráfico sin recuperar sus datos

Ejemplo rápido:

“Ayúdame a investigar por qué los ingresos de la región Norte disminuyeron el mes pasado. Primero, revisa el gráfico existente ‘Ingresos por región’: muéstrame sus metadatos (dimensiones, medidas, filtros, recuento de filas) y luego extrae los datos del gráfico de los últimos dos meses. Antes de aplicar cualquier selección, muestra los valores distintos de Región y busca en los valores del campo para confirmar si se utiliza ‘Norte’, ‘NORTE’ o ‘Septentrional’. Luego crea un cálculo temporal para comparar los ingresos y el margen mes a mes de la región Norte frente a otras regiones, y destaca qué categorías de productos contribuyeron más al cambio.”

Productos de datos

Estas herramientas gestionan el ciclo de vida completo de un producto de datos como un paquete de conjuntos de datos gobernado y compartible:

1. Crearlo.

2. Inspeccionar sus metadatos y documentación.

3. Mantener su definición (nombre, descripción y qué conjuntos de datos contiene)

4. Controlar dónde y si está disponible moviéndolo entre espacios y activándolo o desactivándolo.

También admiten la limpieza al final de su vida útil eliminando un producto de datos cuando ya no es necesario.

Están disponibles las siguientes herramientas:

• Qlik_create_data_product: permite crear un nuevo producto de datos

• Qlik_get_data_product: permite obtener metadatos para un producto de datos específico

• Qlik_get_data_product_documentation: permite obtener la documentación markdown de un producto de datos

• Qlik_update_data_product: permite actualizar propiedades (nombre, descripción, conjuntos de datos) de un producto de datos

• Qlik_update_data_product_space: permite mover un producto de datos a un espacio diferente

• Qlik_update_activate_data_product: permite activar un producto de datos en un espacio específico

• Qlik_update_deactivate_data_product: permite desactivar un producto de datos

• Qlik_delete_data_product: permite eliminar un producto de datos

Ejemplo rápido:

“Crea un producto de datos llamado «Análisis de ventas – Aprobado» con una descripción clara e incluye estos conjuntos de datos: Pedidos, Clientes y Productos. Luego muéstrame los metadatos del producto de datos y extrae su documentación en markdown para que pueda revisar lo que verán los consumidores. Actualiza la descripción para añadir orientación de uso y añade también el conjunto de datos de Devoluciones. Mueve el producto de datos a nuestro espacio compartido de "Análisis", actívalo allí para un acceso más amplio, y si más tarde lo reemplazamos por una nueva versión, desactiva el antiguo. Finalmente, si el producto está completamente retirado y ya no se referencia, elimínalo.”

Linaje

Esta herramienta permite a un usuario rastrear de dónde provienen los datos y cómo fluyen al recuperar el linaje ascendente de un conjunto de datos o una aplicación. Dado que cada llamada devuelve solo un paso atrás, normalmente se repite de forma recursiva para construir la cadena completa. Esto es útil para:

• Análisis de impacto.

• Solución de problemas de números inesperados.

• Gobernanza o auditoría.

• Identificación de las verdaderas fuentes que alimentan un informe o conjunto de datos.

Están disponibles las siguientes herramientas:

• Qlik_get_lineage: permite cargar el historial de linaje de un conjunto de datos o aplicación (llamar recursivamente para la cadena completa)

Ejemplo rápido:

“Muéstrame el linaje ascendente completo del conjunto de datos de Pedidos de Clientes. Empieza desde el conjunto de datos y retrocede recursivamente hasta que llegues a los sistemas fuente originales. Para cada paso, resume cuál es el padre inmediato y anota cualquier transformación clave o conjunto de datos o aplicaciones implicados. Luego dime qué fuente ascendente es más probable que afecte el campo net_amount si cambia.”

Elementos maestros (Dimensiones & Medidas)

Estas herramientas ayudan a los usuarios a estandarizar y reutilizar la lógica de negocio clave en una aplicación trabajando con dimensiones y medidas maestras (de biblioteca). Puede inventariar lo que ya está disponible (para evitar duplicados y fomentar la coherencia), y puede crear nuevas dimensiones y medidas reutilizables para que los gráficos de varias hojas utilicen las mismas definiciones de campo y expresiones de cálculo, mejorando la gobernanza, el mantenimiento y la alineación de métricas.

Están disponibles las siguientes herramientas:

• Qlik_list_dimensionst: permite mostrar todas las dimensiones de biblioteca disponibles en la aplicación

• Qlik_create_dimension: permite crear una dimensión de biblioteca reutilizable

• Qlik_update_dimension: permite actualizar una dimensión de biblioteca existente en una aplicación de Qlik

• Qlik_delete_dimension: permite eliminar una dimensión de biblioteca de una aplicación de Qlik

• Qlik_list_measures: permite mostrar todas las medidas de biblioteca disponibles en la aplicación

• Qlik_create_measure: permite crear una medida de biblioteca reutilizable con expresión

• Qlik_update_measure: permite actualizar una medida de biblioteca existente en una aplicación de Qlik

• Qlik_delete_measure: permite eliminar una medida de biblioteca de una aplicación de Qlik

Ejemplo rápido:

“Ayúdame a estandarizar las métricas en nuestra aplicación de Rendimiento de Ventas. Primero, enumera las dimensiones y medidas de la biblioteca existentes para no duplicar nada. Luego, crea una nueva dimensión de biblioteca "Segmento de clientes" basada en el campo de segmento apropiado, y crea una medida reutilizable 'Margen bruto %' utilizando nuestra definición estándar (margen bruto dividido por ingresos, con formato de porcentaje). Después de crearlos, dime los nombres exactos de los elementos maestros que debo referenciar al crear gráficos para que todos los paneles utilicen la misma lógica.”

Selecciones & Filtrado

Estas herramientas controlan el estado del filtro interactivo de una aplicación de Qlik:

• Aplica selecciones a uno o más campos (utilizando valores exactos o coincidencia de estilo predicado de patrón).

• Inspeccione qué filtros están activos actualmente.

• Borre las selecciones globalmente o para un campo específico.

Juntos, admiten flujos de análisis guiados y pasos de investigación reproducibles.

Están disponibles las siguientes herramientas:

• Qlik_select_values: permite aplicar selecciones (filtros) a campos, admite valores exactos y coincidencia de patrones

  Nota informativa

  Cuándo usar selecciones en lugar de análisis de conjuntos:

  • Cuando desee filtrar toda la aplicación o sesión para múltiples operaciones posteriores, utilice select_values().

  • Cuando necesite un filtro único para un cálculo específico, utilice el análisis de conjuntos en las expresiones

  Las selecciones persisten en todas las operaciones hasta que se borran y afectan a TODAS las recuperaciones de datos posteriores. Como buena práctica recomendada, para consultas analíticas individuales le conviene elegir el análisis de conjuntos mejor que las selecciones para evitar la sobrecarga de la gestión de estados.

  Nota de aviso

  • Utilice qlik_get_field_values() o qlik_search_field_values() primero para verificar que los valores que desea seleccionar existen. Seleccionar valores inexistentes dará error en segundo plano.

  • Las selecciones devueltas son la selección actual aplicada y constituyen la verdad. Cualquier campo donde la selección falló, por ejemplo: donde los valores no existían, no aparecerá en la lista devuelta.

• Qlik_clear_selections: permite borrar selecciones: todas o las de un campo específico

  Nota de avisoLas selecciones devueltas son la selección actual aplicada y constituyen la verdad. Cualquier campo en el que la selección haya fallado (por ejemplo, los valores no existían) no aparecerá en la lista devuelta.

• Qlik_get_current_selections: permite obtener las selecciones o filtros activos actualmente en la aplicación

• Qlik_update_filter: permite actualizar un panel de filtro existente en una aplicación de Qlik

Ejemplo rápido:

“Configura mi contexto de análisis para la aplicación Executive Sales: selecciona Año = 2025 y Región = EMEA, y aplica una selección basada en patrones en Categoría de producto para incluir solo las categorías que comiencen por "Cloud". Luego, muéstrame las selecciones actuales para que pueda confirmar qué está activo. Después de revisar los KPI, borra solo la selección de Categoría de producto (mantén Año y Región), y por último borra todas las selecciones para restablecer la aplicación a un estado sin filtrar.”

Visualización & Hojas

Estas herramientas permiten a los usuarios ensamblar cuadros de mando en una aplicación de Qlik:

• Crear una hoja nueva como un lienzo.

• Añadir visualizaciones (gráficos, tablas, KPI) configuradas con dimensiones, medidas y opciones de visualización.

• Coloque paneles de filtro en la hoja para que los usuarios puedan segmentar interactivamente el análisis.

Juntos, constituyen el flujo de trabajo básico para construir una página de panel de autoservicio utilizable.

Están disponibles las siguientes herramientas:

• Qlik_create_sheet: permite crear una nueva hoja vacía (panel) en la aplicación

• Qlik_add_chart: permite añadir una visualización (de barras, líneas, gráfico circular de tarta, tabla, KPI, etc.) a una hoja

  Nota informativa

  • Planifique la estructura de su consulta antes de realizar llamadas a herramientas.

  • Comprobar la existencia de valores de fecha con qlik_search_field_values o qlik_get_field_values primero

  • Usar análisis de conjuntos sobre selecciones a nivel de aplicación para consultas únicas

• Qlik_add_filter: permite añadir un panel de filtrado a una hoja para un filtrado controlado por el usuario

• Qlik_delete_object: permite eliminar un objeto de una aplicación de Qlik (gráfico, hoja, filtro, etc.)

• Qlik_show_chart: permite mostrar una visualización generada como una instantánea de Qlik

• Qlik_update_chart: permite actualizar una visualización de gráfico existente en una aplicación de Qlik

Ejemplo rápido:

“Crea una nueva hoja llamada "Resumen de ventas" en nuestra aplicación de análisis. Añade un KPI para el Total de ingresos y el Total de pedidos, un gráfico de líneas que muestre los Ingresos por mes y un gráfico de barras que muestre los Ingresos por región (ordenado de forma descendente). Luego, añade un panel de filtros con Año, Región y Categoría de producto para que los usuarios puedan ajustar la vista. Asegúrate de que los elementos visuales tengan títulos claros y que la hoja sea adecuada para una audiencia de directivos.”