Introducción a las herramientas de Azure Data Explorer para azure MCP Server

El Azure servidor MCP le permite administrar Azure Data Explorer recursos mediante mensajes de lenguaje natural. Puede enumerar clústeres, ver bases de datos y consultar datos mediante lenguaje natural. También puede usar consultas KQL específicas para respuestas dirigidas.

Azure Data Explorer es un servicio de análisis de datos rápido y totalmente administrado para el análisis en tiempo real en grandes volúmenes de streaming de datos desde aplicaciones, sitios web, dispositivos IoT, etc. Azure Data Explorer le ayuda a analizar grandes volúmenes de datos diversos de cualquier origen de datos, como sitios web, aplicaciones, dispositivos IoT, etc.

Nota:

Parámetros de herramienta: las herramientas del servidor MCP de Azure definen parámetros para los datos que necesitan para completar las tareas. Algunos de estos parámetros son específicos de cada herramienta y se documentan aquí. Otros parámetros son globales y compartidos por todas las herramientas. Para obtener más información, consulte Parámetros de la herramienta.

Parámetros condicionales

Algunas de las herramientas de Azure Data Explorer requieren uno de los siguientes conjuntos de parámetros dentro del contexto de conversación:

  • Opción 1: URI de clúster
  • Opción 2: nombre y suscripción del clúster

No proporcione los tres parámetros (URI de clúster, nombre de clúster y suscripción) juntos, ya que esto crea entradas en conflicto.

Clúster: enumeración de clústeres

El servidor MCP de Azure enumera todos los clústeres de Azure Data Explorer de una suscripción.

Algunas solicitudes de ejemplo incluyen:

  • Enumerar clústeres: "Mostrar todos los clústeres de Azure Data Explorer en mi suscripción".
  • Visualización de clústeres: "¿Qué clústeres de Azure Data Explorer tengo disponibles?"
  • Compruebe los clústeres: "Enumerar todos los clústeres de Azure Data Explorer".
  • Clústeres de consulta: "Mostrar mi organización de clústeres de Azure Data Explorer".
  • Búsqueda de clústeres: "Obtención de todos los clústeres de ADX en mi suscripción de Azure".

Sugerencias de anotación de herramientas:

Destructivo Idempotente Abrir mundo Solo lectura Secreto Se requiere un recurso local
❌ ✅ ❌ ✅ ❌ ❌

Clúster: Obtención de detalles del clúster

El servidor MCP de Azure obtiene detalles de un clúster específico de Azure Data Explorer.

Algunas solicitudes de ejemplo incluyen:

  • Obtenga detalles: "Muéstrame los detalles de mi clúster de Azure Data Explorer 'analytics-cluster'."
  • Ver clúster: "Dame información sobre el clúster de ADX 'logs-prod'."
  • Información del clúster: "¿Cuáles son los detalles del clúster de Azure Data Explorer "data-explorer-dev"?"
  • Compruebe la configuración: "Obtenga los detalles de configuración del clúster de ADX "telemetry-cluster".
  • Propiedades del clúster: "Mostrar las propiedades de mi clúster de Azure Data Explorer en la suscripción "my-sub".
Parámetro Obligatorio u opcional Descripción
Clúster Obligatorio Nombre del clúster de Azure Data Explorer.

Sugerencias de anotación de herramientas:

Destructivo Idempotente Abrir mundo Solo lectura Secreto Se requiere un recurso local
❌ ✅ ❌ ✅ ❌ ❌

Base de datos: enumerar bases de datos

El servidor MCP de Azure enumera todas las bases de datos de un clúster de Azure Data Explorer.

Algunas solicitudes de ejemplo incluyen:

  • Enumerar bases de datos: "Mostrar todas las bases de datos en el clúster de Azure Data Explorer "analytics-cluster".
  • Ver bases de datos: "¿Qué bases de datos tengo en el clúster de ADX "analytics-cluster"?"
  • Comprobar bases de datos: "Enumerar todas las bases de datos del clúster "analytics-cluster" del clúster de Data Explorer".
  • Bases de datos de consulta: "Mostrar bases de datos en el URI del clúster de Azure Data Explorer "https://mycluster.westus.kusto.windows.net".
  • Buscar bases de datos: "Obtener todas las bases de datos del clúster de ADX "analytics-cluster".
Parámetro Obligatorio u opcional Descripción
URI del clúster Obligatorio condicionalmente URI del clúster de Azure Data Explorer.
Clúster Obligatorio condicionalmente Nombre del clúster de Azure Data Explorer.

Sugerencias de anotación de herramientas:

Destructivo Idempotente Abrir mundo Solo lectura Secreto Se requiere un recurso local
❌ ✅ ❌ ✅ ❌ ❌

Tabla: Enumerar tablas

El servidor MCP de Azure enumera todas las tablas de una base de datos específica de Azure Data Explorer.

Algunas solicitudes de ejemplo incluyen:

  • Listar tablas: «Muéstrame todas las tablas de la base de datos "logs" del clúster de Azure Data Explorer "analytics-cluster".»
  • Ver tablas: "¿Qué tablas tengo en la base de datos "telemetría" en el clúster de ADX "analytics-cluster"?"
  • Comprobar tablas: "Enumere todas las tablas de la base de datos "analytics" de Azure Data Explorer en el clúster "analytics-cluster".
  • Tablas de consulta: "Mostrar tablas en la base de datos "metrics" del clúster de Data Explorer "analytics-cluster".
  • Buscar tablas: "Obtenga todas las tablas de la base de datos "events" en el clúster de Azure Data Explorer "analytics-cluster".
Parámetro Obligatorio u opcional Descripción
URI del clúster Obligatorio condicionalmente URI del clúster de Azure Data Explorer.
Clúster Obligatorio condicionalmente Nombre del clúster de Azure Data Explorer.
Base de datos Obligatorio Nombre de la base de datos de Azure Data Explorer.

Sugerencias de anotación de herramientas:

Destructivo Idempotente Abrir mundo Solo lectura Secreto Se requiere un recurso local
❌ ✅ ❌ ✅ ❌ ❌

Tabla: Obtener el esquema de la tabla

El servidor MCP de Azure obtiene el esquema de una tabla específica en una base de datos de Azure Data Explorer.

Algunas solicitudes de ejemplo incluyen:

  • Ver esquema: "Muéstrame el esquema de la tabla 'Events' en la base de datos 'logs' en el clúster de Azure Data Explorer 'analytics-cluster'."
  • Obtener estructura: "¿Qué columnas tiene la tabla 'Metrics' en la base de datos 'telemetry' en el clúster de ADX 'analytics-cluster'?"
  • Verificar esquema: "Describe la tabla 'Logs' de la base de datos 'logs' en el clúster de Data Explorer 'analytics-cluster'."
  • Ver columnas: "Mostrar columnas y tipos para la tabla «Telemetría» en la base de datos «telemetría» del clúster de Azure Data Explorer «analytics-cluster»."
  • Examine la tabla: "Obtenga la estructura de la tabla «Traces» de la base de datos «logs» en el clúster de ADX «analytics-cluster»."
Parámetro Obligatorio u opcional Descripción
URI del clúster Obligatorio condicionalmente URI del clúster de Azure Data Explorer.
Clúster Obligatorio condicionalmente Nombre del clúster de Azure Data Explorer.
Base de datos Obligatorio Nombre de la base de datos de Azure Data Explorer.
Table Obligatorio Nombre de la tabla.

Sugerencias de anotación de herramientas:

Destructivo Idempotente Abrir mundo Solo lectura Secreto Se requiere un recurso local
❌ ✅ ❌ ✅ ❌ ❌

Datos de ejemplo

El servidor MCP de Azure recupera un ejemplo de datos de una tabla especificada de Azure Data Explorer.

Algunas solicitudes de ejemplo incluyen:

  • Obtención de datos de ejemplo: "Mostrarme un ejemplo de datos de la tabla "Events" de la base de datos "logs" en el clúster de Azure Data Explorer "analytics-cluster".
  • Tabla de vista previa: "Dame una vista previa de los registros de la tabla 'Logs' de la base de datos 'logs' en el clúster de ADX 'analytics-cluster'."
  • Ver ejemplos de datos: "Mostrar filas de ejemplo de la tabla «Métricas» en la base de datos «telemetría» en el clúster de Data Explorer «analytics-cluster»."
  • Comprobar el formato de datos: "Obtén algunos registros de ejemplo de la tabla 'Telemetry' de la base de datos 'telemetry' en el clúster de Azure Data Explorer 'analytics-cluster' para ver la estructura de datos."
  • Exploración de datos: "Devuelve 10 filas de ejemplo de la tabla 'UserActivity' en la base de datos 'logs' del clúster de ADX 'analytics-cluster'."
Parámetro Obligatorio u opcional Descripción
URI del clúster Obligatorio condicionalmente URI del clúster de Azure Data Explorer.
Clúster Obligatorio condicionalmente Nombre del clúster de Azure Data Explorer.
Base de datos Obligatorio Nombre de la base de datos de Azure Data Explorer.
Table Obligatorio Nombre de la tabla desde la que se van a muestrear datos.
Límite Opcional Número máximo de filas que se van a devolver en el ejemplo.

Sugerencias de anotación de herramientas:

Destructivo Idempotente Abrir mundo Solo lectura Secreto Se requiere un recurso local
❌ ✅ ❌ ✅ ❌ ❌

Query

El servidor MCP de Azure ejecuta una consulta KQL en una base de datos de Azure Data Explorer.

Algunas solicitudes de ejemplo incluyen:

  • Ejecutar consulta: "Ejecuta 'Logs | where Timestamp > ago(1h) | count' en la base de datos 'logs' en el clúster de Azure Data Explorer 'analytics-cluster'."
  • Datos de consulta: "Ejecuta la consulta KQL 'Logs | where Level == "Error" and Timestamp > ago(24h)" para buscar todos los errores en las últimas 24 horas en la base de datos 'logs' en el clúster de ADX 'analytics-cluster'."
  • Captura de datos: "Obtén eventos recientes con la consulta 'Events | take 100' de la base de datos 'logs' en el clúster de Data Explorer 'analytics-cluster'."
  • Extraer información: "Consulta los patrones de actividad del usuario con 'UserActivity | summarize count() by UserId' desde la base de datos 'logs' en el clúster de Azure Data Explorer 'analytics-cluster'."
  • Analizar registros: "Ejecuta 'Metrics | summarize avg(Duration) by Service' en KQL para resumir las métricas de rendimiento por servicio en la base de datos 'telemetry' en el clúster de ADX 'analytics-cluster'."
Parámetro Obligatorio u opcional Descripción
URI del clúster Obligatorio condicionalmente URI del clúster de Azure Data Explorer.
Clúster Obligatorio condicionalmente Nombre del clúster de Azure Data Explorer.
Base de datos Obligatorio Nombre de la base de datos de Azure Data Explorer.
Consulta Obligatorio Consulta KQL para ejecutar.

Sugerencias de anotación de herramientas:

Destructivo Idempotente Abrir mundo Solo lectura Secreto Se requiere un recurso local
❌ ✅ ❌ ✅ ❌ ❌

Contenido relacionado

  • Last updated on