Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Совет
Рекомендуется: Начните с 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-адреса в пакеты приложений декларативного агента.
Если вы еще не вошли в интерфейс командной строки devtunnel, используйте его
devtunnel user login --help, чтобы просмотреть доступные параметры. Прежде чем продолжить, войдите в интерфейс командной строки.Создайте туннель, разрешающий анонимный доступ. Анонимный доступ необходим для того, чтобы Microsoft 365 Copilot получил доступ к вашему туннелю, и не связан с какой-либо проверкой подлинности, требуемой вашим API.
devtunnel create --allow-anonymousСовет
При создании нового туннеля используется только что созданный туннель. Это позволяет пропускать
tunnel-idэтот аргумент в последующих командах. Если вы создаете несколько туннелей, возможно, потребуется использовать этотtunnel-idаргумент, чтобы убедиться, что используется нужный туннель. Дополнительные сведения об использованииdevtunnel --helpкоманды см. в справочнике командной строки Dev tunnels.Добавьте номер HTTP-порта, который используется средством отладки. Замените
<port>его номером порта и задайте параметру--protocolhttps, использует ли средство отладки протокол HTTPS для порта илиhttpне использует HTTPS.devtunnel port create --port-number <port> --protocol httpsЗапустите туннель разработки.
devtunnel hostПри первом запуске этого туннеля разработки скопируйте 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-файл пакета приложения и добавить агент.