提示
受到推崇的: 从 Work IQ 开发工具 开始,用于受支持的专业代码声明代理和插件方案。 请参阅 WIQD 快速入门。 基于工具包的说明仍然可用于需要它们的现有项目和工作流。 在选择工具之前,请检查 功能和目标体验支持 : WIQD 不面向自定义引擎代理。
插件使 智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶® 中的声明性代理能够调用模型上下文协议 (MCP) 服务器或 REST API 来检索数据并执行任务。 智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶®必须通过 Internet 访问 MCP 或 API 服务器。 通常,调试工具在 (127.0.0.1) 上 localhost 托管调试会话,该只能从运行调试工具的计算机访问。 通过使用反向代理(如开发隧道),可以将调试会话公开到 Internet,以启用来自智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶®的调试调用。
本文介绍如何使用该 devtunnel 工具为 MCP 服务器或 API 启用本地调试。
注意
你的调试工具可能已提供反向代理解决方案。 建议查看开发人员工具文档以进行确认。 例如,如果使用 Microsoft 365 代理工具包创建了一个新 API,该工具包将为你处理反向代理的配置。
先决条件
-
安装在
devtunnel托管调试会话的计算机上的 CLI - 调试工具使用的 HTTP 端口号
创建持久性开发隧道
使用 devtunnel CLI,可以创建持久性开发隧道 - 可以在不更改托管 URL 的情况下根据需要停止和启动隧道。 使用具有持久性 URL 的隧道可简化插件调试,因为无需使用新 URL 更新声明性代理应用程序包。
如果尚未登录到 devtunnel CLI,请使用
devtunnel user login --help查看可用选项。 在继续操作之前,请登录到 CLI。创建允许匿名访问的隧道。 匿名访问是允许智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶®访问隧道所必需的,并且与 API 所需的任何身份验证无关。
devtunnel create --allow-anonymous提示
创建新隧道会将默认隧道切换到新创建的隧道。 这允许您省
tunnel-id略后续命令的参数。 如果创建多个隧道,则可能需要使用tunnel-id参数来确保使用的是预期的隧道。 有关详细信息,请使用该devtunnel --help命令或参阅 开发人员隧道命令行参考。添加调试工具使用的 HTTP 端口号。 替换
<port>为端口号,并将参数https设置为--protocol调试工具是否在端口http上使用 HTTPS 或未使用 HTTPS。devtunnel port create --port-number <port> --protocol https启动开发隧道。
devtunnel host首次运行此开发隧道时,请复制标记为“ 通过浏览器连接”的 URL。 在浏览器中打开此 URL,然后选择 “继续” 以启用隧道。
注意
选择 “继续”后,浏览器将显示错误。 这是预期的,可以忽略。
启用隧道后,可以使用 CTRL + C 停止隧道。可以使用以下 devtunnel host host-id 命令重新启动隧道。
使用开发隧道
要使用开发隧道进行调试,请使用开发隧道的 URL 旁加载应用包来取代服务器的 URL。
在插件清单中设置 urlMCP 服务器规格对象 的属性。
"runtimes": [
{
"type": "RemoteMCPServer",
"spec": {
"url": "<your-dev-tunnel-url>",
}
}
]
如果在 Visual Studio Code 中使用 Agents Toolkit 管理声明式代理,可以将环境变量添加到名为 PLUGIN_SERVER_URL/env/.env.dev.user 的文件,并使用它来代替开发隧道 URL。 使用“生命周期”窗格中的“预配”步骤旁加载代理。 在 /env/.env.dev.user 文件中,添加:
OPENAPI_SERVER_URL=<your-dev-tunnel-url>
在插件清单中,更新 url 属性:
"runtimes": [
{
"type": "RemoteMCPServer",
"spec": {
"url": "${{PLUGIN_SERVER_URL}}",
}
}
]
如果未使用代理工具包,可以生成新的应用包 ZIP 文件并 上传代理。