Поделиться через


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

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

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

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

Эта возможность позволяет Copilot и пользовательским агентам ИИ безопасно взаимодействовать с вашим хранилищем событий и использоваться платформами облачных агентов, такими как Copilot Studio и Azure AI Foundry.

Это важно

Эта функция доступна в предварительной версии.

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

Существует три основных шага для начала работы с удаленной интеграцией MCP Eventhouse:

  1. Подключитесь к удаленному серверу Eventhouse MCP из Visual Studio Code или GitHub Copilot CLI.
  2. Используйте GitHub Copilot для запроса Eventhouse с помощью естественного языка.
  3. Проверьте подключение с помощью тестовых запросов.

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

Прежде чем настроить и запросить сервер MCP, вам потребуется:

  • Visual Studio Code.
  • GitHub Copilot в VS Code.
  • Хранилище событий с базой данных и таблицами KQL.
    • Необходимы разрешения на чтение или запрос в базе данных Eventhouse.
    • Запишите идентификатор рабочей области и идентификатор базы данных KQL для настройки.

Примите во внимание следующие рекомендации.

  • Имеют хорошо описанные схемы и метаданные таблицы для улучшения качества запросов ИИ.
  • Включите Copilot в Fabric и иметь платную емкость Fabric (F2 или выше, или любой выпуск P). Если вы не включите Copilot в Fabric, сервер MCP может выполнять только запросы KQL. Не удается получить схему.

Настройка удаленного сервера Eventhouse MCP

Удаленный сервер Eventhouse MCP выступает в качестве конечной точки MCP на основе HTTP.

Installation

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

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

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

  2. Измените файл конфигурации, чтобы включить определение Eventhouse, используя следующий формат URL-адреса в Example MCP configuration. Замените <Workspace ID> и <KQL database ID> на ваши фактические значения.

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

Подсказка

Чтобы добавить этот сервер MCP с помощью интерфейса командной строки GitHub Copilot вместо VS Code, см. статью "Добавление серверов MCP для интерфейса командной строки GitHub Copilot". Используйте команду с типом сервера /mcp add и укажите URL-адрес Eventhouse из Пример конфигурации MCP.

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

{
  "servers": {
    "eventhouse-remote": {
      "type": "http",
      "url": "https://api.fabric.microsoft.com/v1/mcp/workspaces/<Workspace ID>/kqlDatabases/<KQL database ID>"
    }
  }
}

Найдите URL-адрес MCP базы данных KQL

  1. Войдите на портал Fabric.
  2. Перейдите в рабочую область, содержащую ваш Eventhouse.
  3. Выберите базу данных KQL, чтобы открыть страницу сведений.
  4. На панели сведений о базе данных в разделе "Обзор " выберите URI копирования рядом с URI сервера MCP.

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

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

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

  1. Запустите сервер Eventhouse MCP в Visual Studio Code.
  2. Пройдите аутентификацию на сервере MCP с помощью учетных данных, имеющих доступ к хранилищу событий.
  3. Убедитесь, что состояние сервера Eventhouse MCP отображается как запущенное.

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

  1. Откройте окно чата GitHub Copilot в VS Code.
  2. Включите режим агента.
  3. Задайте вопрос, например:
    • Какие таблицы есть в #eventhouse-remote? (используйте удаленное имя, предоставленное в mcp.json).
    • Анализ данных в таблице StormEvents и отображение наиболее разрушительных событий шторма
  4. Просмотрите ответ, возвращенный Copilot.

Troubleshooting

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

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

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

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

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

Ответ.

Снимок экрана: агент VS Code Copilot, в котором отображается сводка выполненных пользователем команд.