秘訣
推薦項目: 從 Work IQ 開發工具 開始,支援專業程式碼宣告式代理程式和外掛程式案例。 請參閱 WIQD 快速入門。 工具組式指示仍然適用於需要工具組的指示的現有專案和工作流程。 在選擇工具之前,請先檢查 功能和目標體驗支援 : WIQD 不會以自訂引擎代理程式為目標。
外掛程式可讓 Microsoft 365 Copilot 中的宣告式代理程式呼叫模型內容通訊協定 (MCP) 伺服器或 REST API 來擷取資料和執行工作。 Microsoft 365 Copilot 必須透過網際網路連線至 MCP 或 API 伺服器。 一般而言,偵錯工具會在 (127.0.0.1) 上 localhost 託管偵錯工作階段,只能從執行偵錯工具的電腦存取。 藉由使用反向 Proxy,例如開發者隧道,您可以將偵錯工作階段公開至網際網路,以啟用來自 Microsoft 365 Copilot 的偵錯呼叫。
本文將示範如何使用此工具為 devtunnel MCP 伺服器或 API 啟用本機偵錯。
注意
您的偵錯工具可能已經提供反向 Proxy 解決方案。 建議您查看開發人員工具的文件以確認。 例如,如果您使用 Microsoft 365 Agents Toolkit建立新 API,則工具組會為您處理設定反向 Proxy。
先決條件
- 安裝在
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>取代為您的連接埠號碼,並將參數設定為--protocolhttps您的偵錯工具是否在連接埠上使用 HTTPS,或http如果未使用 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 中的代理程式工具組來管理宣告式代理程式,您可以將環境變數新增至 /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}}",
}
}
]
如果您沒有使用 Agents Toolkit,可以產生新的應用程式套件 ZIP 檔案並 上傳您的代理程式。