Начало работы с удаленным сервером MCP для Eventhouse (предварительная версия)

Узнайте, как использовать удаленный протокол контекста модели (MCP) для eventhouse для выполнения запросов KQL. Удаленный сервер MCP Eventhouse позволяет агентам ИИ запрашивать, определять и действовать с данными в реальном времени в хранилище событий RTI. Это хостинговая MCP, в которой вы настраиваете URL-адрес для ведения к Eventhouse. Нет необходимости устанавливать или развертывать что-либо.

Служба Eventhouse remote MCP позволяет агентам ИИ запрашивать Eventhouse с помощью естественного языка. С помощью протокола контекста модели (MCP) помощники по искусственному интеллекту могут:

• Динамически обнаруживайте схемы и метаданные базы данных KQL.
• Создайте запросы KQL для запроса и анализа данных в базах данных KQL.
• Используйте запросы естественного языка, которые переводятся в запросы KQL.
• Возвращает аналитические сведения в режиме реального времени и исторических данных.
• Примеры данных.

Эта возможность позволяет Copilot и пользовательским агентам ИИ безопасно взаимодействовать с вашей системой управления событиями. Платформы облачных агентов могут поглощать эти агенты.

Начало работы

Чтобы приступить к работе с удаленной интеграцией MCP в Eventhouse, выполните следующие действия.

1. Подключитесь к серверу Eventhouse MCP из Visual Studio Code или GitHub Copilot CLI.

2. Запустите сервер Eventhouse MCP.

3. Использовать GitHub Copilot для выполнения запросов

Необходимые условия

• Visual Studio Code.

• GitHub Copilot в VS Code.

• Рабочее пространство с поддержкой ресурса Microsoft Fabric.

• Включите Copilot в Fabric, чтобы сервер MCP мог получить схему базы данных. В противном случае он может выполнять только запросы KQL.

• Хранилище событий с таблицами базы данных KQL.

  • Разрешения на чтение или запрос к базе данных KQL.
  • URI сервера MCP для настройки. См. Найдите URI сервера MCP.

Подключитесь к серверу MCP Eventhouse

Сервер Eventhouse MCP выступает в качестве конечной точки MCP на основе HTTP. Добавьте определение удаленного сервера MCP в файл конфигурации клиента MCP. В настоящее время поддерживается только конфигурация вручную.

1. Откройте файл конфигурации клиента MCP.

   В VS Code файл конфигурации обычно находится в .vscode/mcp.jsonпрофиле пользователя или в вашем профиле пользователя. Дополнительные сведения см. в справочнике по конфигурации VS Code MCP.

2. Добавьте URL-адрес сервера Eventhouse MCP в файл конфигурации клиента MCP. Найдите URI сервера MCP и ознакомьтесь с примером конфигурации клиента MCP.

Поиск URI сервера MCP

1. Войдите на портал Fabric.

2. Перейдите в рабочую область, содержащую ваш Eventhouse.

3. Выберите базу данных KQL.

4. В разделе"Общие> выберите URI копирования рядом с URI СЕРВЕРА MCP.

   

Пример конфигурации клиента MCP

{
  "servers": {
    "eventhouse-remote": {
      "type": "http",
      "url": "https://api.fabric.microsoft.com/v1/mcp/dataPlane/workspaces/11112222-bbbb-3333-cccc-4444dddd5555/items/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2/kqlEndpoint"
    },
    "kql-global": {
      "type": "http",
      "url": "https://api.fabric.microsoft.com/v1/mcp/dataPlane/kqlEndpoint"
    }
  }
}

Доступные средства

Сервер Eventhouse MCP предоставляет набор средств, которые агенты ИИ могут использовать для взаимодействия с Eventhouse и ее базами данных KQL. Эти средства позволяют агентам обнаруживать схемы базы данных KQL, создавать запросы KQL из естественного языка, выполнять запросы и образцы данных.

При использовании глобальной конечной точки (как показано в приведенном kql-global выше примере), укажите оба workspaceId, itemId в каждом вызове инструмента.

Средства в общедоступном сервере MCP поддерживают необязательные clusterUrl и databaseName параметры. При предоставлении указанных параметров запрос выполняется в указанном кластере и базе данных Azure Data Explorer, а элемент Fabric используется только для измерения использования ИИ в объеме Fabric.

Проверка подключения

После настройки убедитесь, что программа установки работает.

Запустите сервер MCP Eventhouse

1. Запустите сервер Eventhouse MCP в Visual Studio Code.

2. Аутентификация на сервере MCP с помощью учетных данных, которые имеют доступ к Eventhouse.

3. Убедитесь, что состояние сервера Eventhouse MCP отображается как запущенное.

Использование GitHub Copilot для выполнения запросов

1. Откройте окно GitHub Copilot Chat в VS Code.

2. Включите режим агента.

3. Задайте вопрос, например:

   • Какие таблицы есть в #eventhouse-remote? (используйте удаленное имя, предоставленное в файле mcp.json).
   • Анализ данных в таблице StormEvents и отображение наиболее разрушительных событий шторма

4. Просмотрите ответ, возвращенный Copilot.

Устранение неполадок

При возникновении проблем:

• Убедитесь, что сервер MCP подключен в Visual Studio Code или GitHub Copilot CLI.
• Убедитесь, что узел MCP поддерживает удаленные серверы HTTP MCP.
• Убедитесь, что у вас есть достаточные разрешения для базы данных Eventhouse. См. предварительные требования.
• Повторно выполните проверку подлинности, если появится соответствующий запрос.

Пример. Анализ данных

Пример запроса:

"У меня есть данные о выполняемых пользователем командах в таблице ProcessEvents. Выберите несколько строк и классифицируйте выполняемые команды с терпимостью к угрозам низкого/среднего/высокого уровня и представление в табличном виде общей сводки.

Ответ.

Связанный контент

• Что такое сервер Fabric RTI MCP (предварительный просмотр)?
• Начало работы с удаленным сервером MCP для Активатора (предварительная версия)
• Дополнительные сведения об использовании серверов MCP в Visual Studio Code.
• Добавление MCP-серверов для GitHub Copilot CLI.