ヒント
推奨事項: サポートされているプロコード宣言型エージェントとプラグイン シナリオ用の Work IQ 開発ツール から始めます。 WIQD クイックスタートを参照してください。 Toolkit ベースの手順は、それらを必要とする既存のプロジェクトおよびワークフローで引き続き使用できます。 ツールを選択する前に 、機能とターゲット エクスペリエンスのサポート を確認します。WIQD はカスタム エンジン エージェントを対象としません。
プラグインを使用すると、Microsoft 365 Copilot の宣言型エージェントがモデル コンテキスト プロトコル (MCP) サーバーまたは REST API を呼び出してデータを取得し、タスクを実行できるようになります。 Microsoft 365 Copilot は、インターネット経由で MCP または API サーバーに接続する必要があります。 通常、デバッグ ツールは、デバッグ ツールを実行しているコンピューターからのみアクセスできる localhost (127.0.0.1) でデバッグ セッションをホストします。
開発トンネルなどのリバース プロキシを使用すると、デバッグ セッションをインターネットに公開して、Microsoft 365 Copilot からのデバッグ呼び出しを有効にすることができます。
この記事では、 devtunnel ツールを使用して、MCP サーバーまたは API のローカル デバッグを有効にする方法について説明します。
注
お使いのデバッグ ツールで既にリバース プロキシ ソリューションが提供されている場合があります。 開発者ツールのドキュメントを確認して確認することをお勧めします。 たとえば、Microsoft 365 Agents Toolkit を使用して新しい API を作成した場合、ツールキットによってリバース プロキシの構成が自動的に行われます。
前提条件
- デバッグ セッションをホストするコンピューターにインストールされている
devtunnelCLI - デバッグ ツールで使用される 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パラメーターをhttps、HTTPS を使用していない場合はhttpに設定します。devtunnel port create --port-number <port> --protocol https開発トンネルを開始します。
devtunnel hostこの開発トンネルを初めて実行する場合は、[ ブラウザー経由で接続] というラベルの付いた URL をコピーします。 ブラウザーでこの URL を開き、[ 続行] を選択してトンネルを有効にします。
注
[ 続行] を選択すると、ブラウザーにエラーが表示されます。 これは当然のことであり、無視してかまいません。
トンネルが有効になったら、 CTRL + C キーを押してトンネルを停止できます。 devtunnel host host-id コマンドを使用すると、トンネルを再始動できます。
開発トンネルの使用
開発トンネルをデバッグに使用するには、サーバーの URL の代わりに開発トンネルの URL を含むアプリ パッケージをサイドロードします。
プラグイン マニフェスト内の MCP サーバー仕様オブジェクトの url プロパティを設定します。
"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}}",
}
}
]
Agents Toolkit を使用していない場合は、新しいアプリ パッケージの ZIP ファイルを生成して、 エージェントをアップロードできます。