モックツールサーバー

Important

Microsoft Agent 365 の早期アクセスを利用するには、フロンティアプレビュープログラムに参加する必要があります。フロンティアは、Microsoft の最新の AI イノベーションと直接接続します。 Frontier のプレビューは、お客様の契約書に記載されている既存のプレビュー利用規約に従います。これらの機能は現在開発中であるため、提供状況や機能は今後変更される可能性があります。

Agent 365 CLIには、テストおよび開発目的のためのモックツールサーバーが含まれています。このサーバーはMCP(Model Context Protocol)サーバーとの相互作用をシミュレートするため、実際のサーバー実装を必要とせずにエージェントのツール機能をローカルでテストできます。他のエージェント365の機能は含まれていません。

モックサーバー使用の利点

モックサーバーはローカル開発およびテストに以下の利点を提供します:

オフライン開発:インターネット接続や外部依存なしでエージェントをテストしましょう。
一貫したテスト:エッジケースのテストに対して予測可能な回答を得ること。
デバッグ:すべてのリクエストとレスポンスをリアルタイムで閲覧
迅速な反復:外部API呼び出しを待つ必要や複雑なテスト環境の設定をする必要はありません。

[前提条件]

モックツールサーバーを使用する前に、以下の前提条件を確認してください:

Agent 365 CLIをインストールし ました - CLIと一緒にモックツールサーバーを使いましょう。インストール手順は Agent 365 CLI を参照してください。
- モックツールサーバーを使うには、少なくともバージョン1.1.25-previewが必要です。
サンプルエージェントプロジェクト - MCPサーバーに接続できるローカルエージェントプロジェクト。利用可能な出発点については、当社の Agent365-Samples リポジトリをご覧ください。

モックツールサーバーを起動します

a365のdevelop-start-mock-tooling-serverコマンドを使ってモックツールサーバーを起動してください。

# Full command
a365 develop start-mock-tooling-server

# Short alias
a365 develop mts

コマンドオプション

モックツールサーバーは以下のオプションをサポートしています:

Option	Description	既定値
`-p, --port <port>`	モックサーバーのポート番号	5309
`-v, --verbose`	詳細ログを有効にする	false
`-?, -h, --help`	ヘルプと使用状況の情報を表示する	-
`-bg`	サーバーを新しい端末で起動してください	-

例示

以下の例は、モックツールサーバーを起動する一般的な方法を示しています:

まずはデフォルト設定から始めましょう:

a365 develop start-mock-tooling-server

カスタムポートから始めましょう:

a365 develop start-mock-tooling-server -p 8080

まずは詳細なログから始めましょう:

a365 develop start-mock-tooling-server -v

コマンドを実行すると、次のようになります:

指定されたポート(デフォルト:localhost:5309)でモックサーバーを起動します。
端末上でサーバーログや受信リクエストを表示します。

サンプルエージェントを使ったモックサーバーを使う

サンプルエージェントをモックツールサーバーに接続するには:

ステップ1:モックサーバーを起動する

a365 develop start-mock-tooling-server

サーバーは以下の例に似た出力を開始し表示します:

info: Microsoft.Hosting.Lifetime[14]
      Now listening on: http://localhost:5309
info: Microsoft.Hosting.Lifetime[0]
      Application started. Press Ctrl+C to shut down.

ステップ2:エージェントの設定

サンプルエージェントの MCP_PLATFORM_ENDPOINT 環境変数をモックサーバーを指すように設定します:

MCP_PLATFORM_ENDPOINT=http://localhost:5309

カスタムポートを使う場合は、 5309 を選択したポート番号に置き換えてください。

ステップ3:エージェントを活用する

サンプル剤は通常通りに始めてください。エージェントは実際のMCPサーバーではなく、モックサーバーに接続します。

ステップ4:サーバーの活動を監視する

モックサーバー端末には以下が表示されます:

エージェントからのリクエストが届いています
嘲笑された返答が返ってくる
接続状況とエラー(あった場合)

サーバーログの例:

info: Microsoft.AspNetCore.Hosting.Diagnostics[1]
      Request starting HTTP/1.1 POST http://localhost:5309/agents/servers/mcp_CalendarTools - application/json 351
info: Microsoft.AspNetCore.Routing.EndpointMiddleware[0]
      Executing endpoint 'HTTP: POST /agents/servers/{mcpServerName}'
info: Microsoft.AspNetCore.Http.Result.JsonResult[3]
      Writing value of type '<>f__AnonymousType14`3' as Json.
info: Microsoft.AspNetCore.Routing.EndpointMiddleware[1]
      Executed endpoint 'HTTP: POST /agents/servers/{mcpServerName}'
info: Microsoft.AspNetCore.Hosting.Diagnostics[2]
      Request finished HTTP/1.1 POST http://localhost:5309/agents/servers/mcp_CalendarTools - 200 - application/json;+charset=utf-8 399.1814ms

モックサーバーの停止

モックサーバーを停止するには、サーバーが動作しているターミナルで Ctrl+C'を使うか、ターミナルウィンドウを閉じてください。

トラブルシューティング

このセクションには、モックツールサーバーに関する一般的な問題のトラブルシューティング方法についての情報が含まれています。

モックサーバーの起動失敗

症状：

Error: Address already in use

原因:

別のプロセスはすでにデフォルトのポート(5309)や指定されたポートを使っています。

Solution:

別のポートを使いましょう。

a365 develop start-mock-tooling-server -p 8080

あるいはポートを使ったプロセスを止めて、もう一度試すのも良いでしょう。

エージェントがモックサーバーに接続できません