Локальная отладка подключаемых модулей MCP и API

Совет

Рекомендуется: Начните с Work IQ Dev Tools для поддерживаемых сценариев декларативного агента и плагинов для кода. См. краткое руководство по WIQD. Инструкции на основе набора средств остаются доступными для существующих проектов и рабочих процессов, для которых они требуются. Перед выбором инструмента проверьте поддержку возможностей и целевого интерфейса : WIQD не нацелен на агентов пользовательской подсистемы.

Подключаемые модули позволяют декларативным агентам в Microsoft 365 Copilot вызывать серверы протокола контекста модели (MCP) или REST API для получения данных и выполнения задач. Microsoft 365 Copilot должен связаться с сервером MCP или API через Интернет. Как правило, средства отладки проводят сеансы отладки по localhost протоколу (127.0.0.1), которые доступны только на компьютере, на котором запущено средство отладки. Используя обратный прокси-сервер, например туннели разработки, вы можете предоставить сеанс отладки в Интернете, чтобы включить вызовы отладки из Microsoft 365 Copilot.

В этой статье показано, как использовать devtunnel средство для локальной отладки для сервера MCP или API.

Примечание

Возможно, ваши средства отладки уже предоставляют решение в виде обратного прокси-сервера. Мы рекомендуем проверить документацию для проверки ваших средств разработчика. Например, если вы создали новый API с помощью набора средств агентов Microsoft 365, этот набор средств настроит обратный прокси-сервер автоматически.

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

  • Интерфейс командной строки devtunnel , установленный на компьютере, на котором размещаются сеансы отладки
  • Номер порта HTTP, используемый средством отладки.

Создание сохраняемого туннеля для разработки

Интерфейс devtunnel командной строки позволяет создать постоянный туннель разработки, который можно остановить и запустить по мере необходимости без изменения размещенного URL-адреса. Использование туннеля с постоянным URL-адресом упрощает отладку подключаемых модулей, так как вам не нужно добавлять новые URL-адреса в пакеты приложений декларативного агента.

  1. Если вы еще не вошли в интерфейс командной строки devtunnel, используйте его devtunnel user login --help , чтобы просмотреть доступные параметры. Прежде чем продолжить, войдите в интерфейс командной строки.

  2. Создайте туннель, разрешающий анонимный доступ. Анонимный доступ необходим для того, чтобы Microsoft 365 Copilot получил доступ к вашему туннелю, и не связан с какой-либо проверкой подлинности, требуемой вашим API.

    devtunnel create --allow-anonymous
    

    Совет

    При создании нового туннеля используется только что созданный туннель. Это позволяет пропускать tunnel-id этот аргумент в последующих командах. Если вы создаете несколько туннелей, возможно, потребуется использовать этот tunnel-id аргумент, чтобы убедиться, что используется нужный туннель. Дополнительные сведения об использовании devtunnel --help команды см. в справочнике командной строки Dev tunnels.

  3. Добавьте номер HTTP-порта, который используется средством отладки. Замените <port> его номером порта и задайте параметру --protocolhttps , использует ли средство отладки протокол HTTPS для порта или http не использует HTTPS.

    devtunnel port create --port-number <port> --protocol https
    
  4. Запустите туннель разработки.

    devtunnel host
    
  5. При первом запуске этого туннеля разработки скопируйте URL-адрес с меткой "Подключиться через браузер". Откройте этот URL-адрес в браузере и выберите "Продолжить ", чтобы включить туннель.

    Примечание

    После нажатия кнопки "Продолжить" в браузере появится сообщение об ошибке. Это ожидаемо, и его можно проигнорировать.

После включения туннеля вы можете остановить туннель с помощью CTRL+C. Вы можете перезапустить туннель с помощью devtunnel host host-id команды.

Использование туннеля разработчика

Чтобы использовать туннель разработки для отладки, загрузите неопубликованный пакет приложения с URL-адресом туннеля разработки вместо URL-адреса сервера.

Задайте url свойство объекта спецификации сервера MCP в манифесте подключаемого модуля.

"runtimes": [
  {
    "type": "RemoteMCPServer",
    "spec": {
      "url": "<your-dev-tunnel-url>",
    }
  }
]

Если вы используете Agents Toolkit в Visual Studio Code для управления декларативным агентом, вы можете добавить переменную среды в файл /env/.env.dev.user с именем PLUGIN_SERVER_URL и использовать ее вместо URL-адреса туннеля разработки. Используйте шаг "Подготовка " на панели "Жизненный цикл ", чтобы загрузить неопубликованный агент. В файле /env/.env.dev.user добавьте:

OPENAPI_SERVER_URL=<your-dev-tunnel-url>

В манифесте подключаемого модуля обновите свойство url :

"runtimes": [
  {
    "type": "RemoteMCPServer",
    "spec": {
      "url": "${{PLUGIN_SERVER_URL}}",
    }
  }
]

Если вы не используете набор средств агентов, вы можете создать новый ZIP-файл пакета приложения и добавить агент.