Visão geral das ferramentas do Azure Data Explorer para o Servidor MCP do Azure

O servidor MCP Azure permite que você gerencie Azure Data Explorer recursos usando prompts de linguagem natural. Você pode listar clusters, exibir bancos de dados e consultar dados usando linguagem natural. Você também pode usar consultas KQL específicas para respostas direcionadas.

O Azure Data Explorer é um serviço de análise de dados rápido e totalmente gerenciado para análise em tempo real em grandes volumes de streaming de dados de aplicativos, sites, dispositivos IoT e muito mais. O Azure Data Explorer ajuda você a analisar grandes volumes de dados diversos de qualquer fonte de dados, como sites, aplicativos, dispositivos IoT e muito mais.

Observação

Parâmetros de ferramenta: as ferramentas do Servidor MCP do Azure definem parâmetros para os dados necessários para concluir tarefas. Alguns desses parâmetros são específicos para cada ferramenta e estão documentados aqui. Outros parâmetros são globais e compartilhados por todas as ferramentas. Para obter mais informações, consulte parâmetros de ferramenta.

Parâmetros condicionais

Algumas das ferramentas do Azure Data Explorer exigem um dos seguintes conjuntos de parâmetros dentro do contexto de conversa:

  • Opção 1: URI do cluster
  • Opção 2: nome do cluster e assinatura

Não forneça todos os três parâmetros (URI do cluster, nome do cluster e assinatura) juntos, pois isso cria entradas conflitantes.

Cluster: Listar clusters

O Servidor MCP do Azure lista todos os clusters do Azure Data Explorer em uma assinatura.

Os prompts de exemplo incluem:

  • Listar clusters: "Mostre-me todos os clusters do Azure Data Explorer na minha assinatura".
  • Ver clusters: "Quais clusters do Azure Data Explorer estão disponíveis para mim?"
  • Verificar clusters: "Listar todos os meus clusters do Azure Data Explorer".
  • Consultar clusters: "Mostrar minha organização de cluster do Azure Data Explorer".
  • Localizar clusters: "Obter todos os clusters do ADX na minha assinatura do Azure".

Dicas de anotação da ferramenta:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Localidade obrigatória
❌ ✅ ❌ ✅ ❌ ❌

Cluster: Obter detalhes do cluster

O Servidor MCP do Azure obtém detalhes de um cluster específico do Azure Data Explorer.

Os prompts de exemplo incluem:

  • Obtenha detalhes: "Mostre-me detalhes do cluster 'analytics-cluster' do Azure Data Explorer."
  • Exibir cluster: "Forneça-me informações sobre meu cluster do ADX 'logs-prod'."
  • Informações do cluster: "Quais são os detalhes do cluster do Azure Data Explorer 'data-explorer-dev'?"
  • Verificar configuração: "Obtenha detalhes de configuração do meu cluster ADX 'telemetry-cluster'."
  • Propriedades do cluster: "Mostrar propriedades do cluster do Azure Data Explorer na assinatura 'my-sub'."
Parâmetro Obrigatório ou opcional Descrição
Cluster Obrigatório O nome do cluster do Azure Data Explorer.

Dicas de anotação da ferramenta:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Localidade obrigatória
❌ ✅ ❌ ✅ ❌ ❌

Banco de dados: listar bancos de dados

O Servidor MCP do Azure lista todos os bancos de dados em um cluster do Azure Data Explorer.

Os prompts de exemplo incluem:

  • Listar bancos de dados: "Mostre-me todos os bancos de dados no cluster 'analytics-cluster' do Azure Data Explorer."
  • Exibir bancos de dados: "Quais bancos de dados eu tenho no cluster do ADX 'analytics-cluster'?"
  • Verificar bancos de dados: "Listar todos os bancos de dados no cluster 'analytics-cluster' do Data Explorer."
  • Consultar bancos de dados: "Mostrar bancos de dados no URI do cluster do Azure Data Explorer 'https://mycluster.westus.kusto.windows.net'."
  • Localizar bancos de dados: "Obter todos os bancos de dados do cluster ADX 'analytics-cluster'."
Parâmetro Obrigatório ou opcional Descrição
Cluster URI Obrigatório condicionalmente O URI do cluster do Azure Data Explorer.
Cluster Obrigatório condicionalmente O nome do cluster do Azure Data Explorer.

Dicas de anotação da ferramenta:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Localidade obrigatória
❌ ✅ ❌ ✅ ❌ ❌

Tabela: Lista de tabelas

O Servidor MCP do Azure lista todas as tabelas em um banco de dados específico do Azure Data Explorer.

Os prompts de exemplo incluem:

  • Listar tabelas: "Mostre-me todas as tabelas no banco de dados 'logs' do cluster 'analytics-cluster' do Azure Data Explorer."
  • Exibir tabelas: "Quais tabelas tenho no banco de dados 'telemetria' no cluster ADX 'analytics-cluster'?"
  • Verificar tabelas: "Listar todas as tabelas no banco de dados do Azure Data Explorer 'analytics' no cluster 'analytics-cluster'."
  • Consultar tabelas: "Mostrar tabelas no banco de dados 'metrics' do cluster 'analytics-cluster' do Data Explorer."
  • Encontre tabelas: "Obtenha todas as tabelas do banco de dados 'eventos' no cluster 'analytics-cluster' do Azure Data Explorer."
Parâmetro Obrigatório ou opcional Descrição
Cluster URI Obrigatório condicionalmente O URI do cluster do Azure Data Explorer.
Cluster Obrigatório condicionalmente O nome do cluster do Azure Data Explorer.
Banco de dados Obrigatório O nome do banco de dados do Azure Data Explorer.

Dicas de anotação da ferramenta:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Localidade obrigatória
❌ ✅ ❌ ✅ ❌ ❌

Tabela: Obter esquema de tabela

O Servidor MCP do Azure obtém o esquema de uma tabela específica em um banco de dados do Azure Data Explorer.

Os prompts de exemplo incluem:

  • Exibir esquema: "Mostre-me o esquema da tabela 'Eventos' nos 'logs' do banco de dados no cluster 'analytics-cluster' do Azure Data Explorer."
  • Obter estrutura: "Quais são as colunas que a tabela 'Metrics' possui no banco de dados 'telemetry' no cluster ADX 'analytics-cluster'?"
  • Verificar esquema: "Descrever a tabela 'Logs' no banco de dados 'logs' no cluster 'analytics-cluster' do Data Explorer."
  • Exibir colunas: "Mostrar as colunas e os tipos para a tabela 'Telemetria' no banco de dados 'telemetria' no cluster 'analytics-cluster' do Azure Data Explorer."
  • Examine a tabela: "Obtenha a estrutura da tabela 'Traces' no banco de dados 'logs' no cluster ADX 'analytics-cluster'."
Parâmetro Obrigatório ou opcional Descrição
Cluster URI Obrigatório condicionalmente O URI do cluster do Azure Data Explorer.
Cluster Obrigatório condicionalmente O nome do cluster do Azure Data Explorer.
Banco de dados Obrigatório O nome do banco de dados do Azure Data Explorer.
Tabela Obrigatório O nome da tabela.

Dicas de anotação da ferramenta:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Localidade obrigatória
❌ ✅ ❌ ✅ ❌ ❌

Dados de exemplo

O Servidor MCP do Azure recupera um exemplo de dados de uma tabela especificada do Azure Data Explorer.

Os prompts de exemplo incluem:

  • Obtenha dados de exemplo: "Mostre-me um exemplo de dados da tabela 'Eventos' nos 'logs' do banco de dados no cluster 'analytics-cluster' do Azure Data Explorer."
  • Visualizar tabela: "Dê-me uma visualização dos registros da tabela 'Logs' no banco de dados 'logs' no cluster ADX 'analytics-cluster'."
  • Exiba exemplos de dados: "Mostrar linhas de exemplo da tabela 'Métricas' no banco de dados 'telemetria' no cluster 'analytics-cluster' do Data Explorer."
  • Verifique o formato de dados: "Obtenha alguns registros de exemplo da tabela 'Telemetria' no banco de dados 'telemetria' no cluster 'analytics-cluster' do Azure Data Explorer para ver a estrutura de dados."
  • Exploração de dados: "Retornar 10 linhas de exemplo da tabela 'UserActivity' no banco de dados 'logs' no cluster ADX 'analytics-cluster'."
Parâmetro Obrigatório ou opcional Descrição
Cluster URI Obrigatório condicionalmente O URI do cluster do Azure Data Explorer.
Cluster Obrigatório condicionalmente O nome do cluster do Azure Data Explorer.
Banco de dados Obrigatório O nome do banco de dados do Azure Data Explorer.
Tabela Obrigatório O nome da tabela da qual os dados de exemplo serão fornecidos.
Limite Opcional O número máximo de linhas a serem retornadas no exemplo.

Dicas de anotação da ferramenta:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Localidade obrigatória
❌ ✅ ❌ ✅ ❌ ❌

Query

O Servidor MCP do Azure executa uma consulta KQL em um banco de dados do Azure Data Explorer.

Os prompts de exemplo incluem:

  • Executar consulta: "Executar 'Logs | onde Carimbo de data e hora > atrás(1h) | contar' no banco de dados 'logs' no cluster do Azure Data Explorer 'analytics-cluster'."
  • Consultar dados: "Execute a consulta KQL 'Logs | onde Level == "Error" e Carimbo de data e hora > atrás(24h)' para encontrar todos os erros nas últimas 24 horas no banco de dados 'logs' no cluster ADX 'analytics-cluster'."
  • Buscar dados: "Obter eventos recentes com a consulta 'Eventos | tirar 100' dos 'logs' do banco de dados no cluster do Data Explorer 'analytics-cluster'."
  • Extraia insights: "Consultar padrões de atividade de usuário com 'UserActivity | resumir count() por UserId' do banco de dados 'logs' no cluster do Azure Data Explorer 'analytics-cluster'."
  • Analisar logs: "Executar KQL 'Metrics | resumir avg(Duration) por Service" para resumir as métricas de desempenho por serviço no banco de dados 'telemetry' no cluster ADX 'analytics-cluster'."
Parâmetro Obrigatório ou opcional Descrição
Cluster URI Obrigatório condicionalmente O URI do cluster do Azure Data Explorer.
Cluster Obrigatório condicionalmente O nome do cluster do Azure Data Explorer.
Banco de dados Obrigatório O nome do banco de dados do Azure Data Explorer.
Consulta Obrigatório A consulta KQL a ser executada.

Dicas de anotação da ferramenta:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Localidade obrigatória
❌ ✅ ❌ ✅ ❌ ❌

Conteúdo relacionado

  • Last updated on