ツールの追加と管理

重要

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

ツーリングモジュールを使用すると、開発者はモデルコンテキストプロトコル (MCP) サーバーを検出し、構成して、AI エージェントワークフローに統合できます。 MCP サーバーは、AI エージェントが呼び出すことができるツールとして外部機能を公開します。使用可能なツーリングサーバーの概要については、Agent 365 ツーリングサーバーを参照してください。

要求と応答のフローを示します

概要

Agent 365 ツーリングの統合は、次の 4 つのステップから成るワークフローに従います:

MCP サーバーの構成 - Agent 365 CLI を使用して MCP サーバーを検出して追加する
マニフェストの生成 - CLI はサーバー構成で ToolingManifest.json を作成する
コードへの統合 - マニフェストを読み込み、ツールをオーケストレーターに登録する
ツールの呼び出し - エージェントは実行中にツールを呼び出して操作を実行する

前提条件

MCP サーバーを構成する前に、以下を確認してください:

Agent 365 CLI がインストールされ構成済み
.NET 8.0 SDK 以降 - ダウンロード
Microsoft 365 テナントにおけるグローバル管理者権限

エージェント ID の設定

エージェンティック認証を使用している場合は、MCP サーバーを構成する前に、エージェント登録プロセスを完了して、エージェント ID を作成します。これにより、エージェントが MCP ツールを認証してアクセスできるようにするエージェンティックアプリ ID とエージェンティックユーザーが作成されます。

サービスプリンシパルを設定する

この ONE-TIME セットアップスクリプトを実行して、テナントに Agent 365 ツールのサービスプリンシパルを作成します。

重要

これは、グローバル管理者権限を必要とするテナントごとの ONE-TIME 操作です。

New-Agent365ToolsServicePrincipalProdPublic.ps1 スクリプトをダウンロードする
管理者として PowerShell を開き、スクリプトディレクトリに移動する

次のスクリプトを実行します。

.\New-Agent365ToolsServicePrincipalProdPublic.ps1

プロンプトが表示されたら、Azure の認証情報を使用してサインインする

完了すると、テナントはエージェント開発と MCP サーバー構成の準備が整います。

MCP サーバーの構成

Agent 365 CLI を使用して、エージェントの MCP サーバーを検出、追加、および管理します。使用可能な MCP サーバーとその機能の完全な一覧については、MCP サーバーカタログを参照してください。

使用可能なサーバーの検出

構成できるすべての MCP サーバーを一覧表示します:

a365 develop list-available

MCP サーバーの追加

エージェント構成に 1 つ以上の MCP サーバーを追加します:

a365 develop add-mcp-servers mcp_MailTools

構成済みサーバーの一覧表示

現在構成されている MCP サーバーを表示します:

a365 develop list-configured

MCP サーバーの削除

構成から MCP サーバーを削除します:

a365 develop remove-mcp-servers mcp_MailTools

完全な CLI リファレンスについては、a365 開発コマンドを参照してください。

ツーリングマニフェストの理解

a365 develop add-mcp-servers を実行すると、CLI はすべての MCP サーバーの構成を含む ToolingManifest.json ファイルを生成します。エージェントランタイムは、このマニフェストを使用して、使用可能なサーバーとその認証方法を把握します。

マニフェスト構造

例:ToolingManifest.json

{
  "mcpServers": [
    {
      "mcpServerName": "mcp_MailTools",
      "mcpServerUniqueName": "mcp_MailTools",
      "scope": "McpServers.Mail.All",
      "audience": "api://05879165-0320-489e-b644-f72b33f3edf0"
    }
  ]
}

マニフェストパラメーター

各 MCP サーバーエントリには、次のものが含まれます:

パラメーター	説明
mcpServerName	MCP サーバーの表示名
mcpServerUniqueName	MCP サーバーインスタンスの一意識別子
スコープ	MCP サーバーの機能にアクセスするために必要な OAuth スコープ (例: メール操作用の `McpServers.Mail.All`)。この値は、`add-mcp-servers` コマンドの実行時に MCP サーバーカタログから取得されます。
対象者	ターゲット API リソースを識別する Microsoft Entra ID URI。この値は、MCP サーバーカタログからも取得されます。

注意

MCP サーバーを追加すると、scope と audience の値は Agent 365 CLI によって自動的に設定されます。これらの値は、MCP サーバーカタログから取得され、各 MCP サーバーへのアクセスに必要なアクセス許可を定義します。

エージェントへのツールの統合

ツーリングマニフェストを生成したら、構成済み MCP サーバーをエージェントコードに統合します。このセクションでは、オプションの検査手順と必要な統合手順について説明します。

ツールサーバーの一覧表示 (オプション)

ヒント

このステップはオプションです。ツールサーバー構成サービスを使用して、使用可能なツールサーバーをオーケストレーターに追加する前に、ツーリングマニフェストから検査します。

ツールサーバー構成サービスを使用して、ツーリングマニフェストからエージェントが利用可能なツールサーバーを検出します。この方法により、以下のことが可能になります:

ToolingManifest.json から構成済みのすべての MCP サーバーをクエリする
サーバーのメタデータと機能を取得する
登録前にサーバーの可用性を確認する

ツールサーバーを一覧表示する方法は、コアツーリングパッケージで使用できます:

# Use McpToolServerConfigurationService.list_tool_servers
from microsoft.agents.a365.tooling import McpToolServerConfigurationService

config_service = McpToolServerConfigurationService()
tool_servers = await config_service.list_tool_servers(agentic_app_id, auth_token)

パラメーター:

パラメーター	タイプ	プロパティ	変更後の値	必須/任意
`agentic_app_id`	str	エージェントアプリケーションインスタンスの一意識別子	有効なエージェントアプリケーション ID 文字列	必須
`auth_token`	str	MCP サーバーゲートウェイで認証するためのベアラートークン	有効な OAuth ベアラートークン	必須

パッケージ: microsoft-agents-a365-tooling

// Use McpToolServerConfigurationService.listToolServers
const { McpToolServerConfigurationService } = require('@microsoft/agents-a365-tooling');

const configService = new McpToolServerConfigurationService();
const toolServers = await configService.listToolServers(agentUserId, authToken);

パラメーター:

パラメーター	タイプ	プロパティ	変更後の値	必須/任意
`agentInstanceId`	文字列	エージェントインスタンスの一意識別子	有効なエージェントインスタンス ID 文字列	必須
`authToken`	文字列	MCP サーバーゲートウェイで認証するためのベアラートークン	有効な OAuth ベアラートークン	必須

パッケージ: Microsoft.Agents.A365.Tooling

// Use IMcpToolServerConfigurationService.ListToolServersAsync
using Microsoft.Agents.A365.Tooling.Services;

var configService = serviceProvider.GetRequiredService<IMcpToolServerConfigurationService>();
var toolServers = await configService.ListToolServersAsync(agentInstanceId, authToken);

パラメーター:

パラメーター	タイプ	プロパティ	変更後の値	必須/任意
`agentInstanceId`	文字列	エージェントインスタンスの一意識別子	有効なエージェントインスタンス ID 文字列	必須
`authToken`	文字列	MCP サーバーゲートウェイで認証するためのベアラートークン	有効な OAuth ベアラートークン	必須

パッケージ: Microsoft.Agents.A365.Tooling

オーケストレーターへのツールの登録

フレームワーク固有の拡張機能メソッドを使用して、すべての MCP サーバーをオーケストレーションフレームワークに登録します:

AddToolServersToAgentAsync (.NET)
add_tool_servers_to_agent (Python)
addToolServersToAgent (Node.js)

これらのメソッド:

構成済みの MCP サーバーからのすべてのツールをオーケストレーターに登録する
認証と接続の詳細を自動的に設定する
エージェントが呼び出すツールをすぐに使用できるようにする

オーケストレーター拡張機能の選択

Agent 365 ツーリングモジュールには、さまざまなオーケストレーションフレームワーク用の専用拡張機能パッケージが用意されています:

microsoft-agents-a365-tooling: コアツーリング機能
microsoft-agents-a365-tooling-extensions-agentframework: Agent Framework 統合
microsoft-agents-a365-tooling-extensions-azureaifoundry: Azure AI Foundry 統合
microsoft-agents-a365-tooling-extensions-openai: OpenAI 統合
microsoft-agents-a365-tooling-extensions-semantickernel: Semantic Kernel 統合

注意

a365 develop add-mcp-servers を実行すると、Agent 365 CLI によって認証が自動的に構成されます。 OAuth スコープと対象ユーザーの値は MCP サーバーカタログから取得され、ToolingManifest.json に含まれます。拡張機能メソッドは、これらの値を自動的に使用して認証を設定します。手動で構成する必要はありません。

詳細な実装例については、Agent 365 サンプルを参照してください。

実装の例

次の例では、Agent 365 ツーリングをさまざまなオーケストレーションフレームワークと統合する方法を示します。

Python と OpenAI

この例では、Python アプリケーションで MCP ツールを OpenAI と統合する方法を示します。

1. インポートステートメントの追加

ツーリングモジュールと OpenAI 拡張機能にアクセスするために必要なインポートを追加します:

from microsoft.agents.a365.tooling import McpToolServerConfigurationService
from microsoft.agents.a365.tooling.extensions.openai import mcp_tool_registration_service

2. ツーリングサービスの初期化

構成およびツール登録サービスのインスタンスを作成します:

# Create configuration service and tool service with dependency injection
self.config_service = McpToolServerConfigurationService()
self.tool_service = mcp_tool_registration_service.McpToolRegistrationService()

3. MCP ツールの OpenAI エージェントへの登録

add_tool_servers_to_agent メソッドを使用して、すべての構成済み MCP ツールを OpenAI エージェントに登録します。この方法では、エージェンティック認証と非エージェンティック認証の両方のシナリオを処理します:

async def setup_mcp_servers(self, auth: Authorization, context: TurnContext):
    """Set up MCP server connections"""
    try:
        use_agentic_auth = os.getenv("USE_AGENTIC_AUTH", "false").lower() == "true"
        if use_agentic_auth:
            self.agent = await self.tool_service.add_tool_servers_to_agent(
                agent=self.agent,
                agentic_app_id=agentic_app_id,
                auth=auth,
                context=context,
            )
        else:
            self.agent = await self.tool_service.add_tool_servers_to_agent(
                agent=self.agent,
                agentic_app_id=agentic_app_id,
                auth=auth,
                context=context,
                auth_token=self.auth_options.bearer_token,
            )

    except Exception as e:
        logger.error(f"Error setting up MCP servers: {e}")

メソッド parameters

次の表では、add_tool_servers_to_agent で使用するパラメーターについて説明します。

パラメーター	説明
`agent`	ツールを登録する OpenAI エージェントインスタンス。
`agentic_app_id`	エージェントの一意識別子 (エージェンティックアプリ ID)。
`auth`	ユーザーの認可コンテキスト。
`context`	エージェント SDK からの現在の会話ターンコンテキスト。セキュリティで保護されたツール登録用のユーザー ID、会話メタデータ、および認証コンテキストを提供します。
`auth_token`	(オプション) 非エージェンティック認証シナリオのベアラートークン。

4. 初期化中の呼び出し

エージェントを実行する前に、初期化中に必ず設定メソッドを呼び出してください:

# Setup MCP servers during initialization
await self.setup_mcp_servers(auth, context)

add_tool_servers_to_agent メソッドは自動的に:

ToolingManifest.json からすべての MCP サーバーを読み込みます
OpenAI エージェントにツールを登録します
マニフェスト構成に基づいて認証を設定します
エージェントがツールを呼び出すことができるようにします

JavaScript と LangChain

この例では、JavaScript/TypeScript アプリケーションで MCP ツールを LangChain と統合する方法を示します。

1. インポートステートメントの追加

ツーリングモジュールと LangChain 拡張機能にアクセスするために必要なインポートを追加します:

import { McpToolServerConfigurationService } from '@microsoft/agents-a365-tooling';
import { McpToolRegistrationService } from '@microsoft/agents-a365-tooling-extensions-langchain';

2. ツーリングサービスの初期化

ツール登録サービスのインスタンスを作成します:

const toolService = new McpToolRegistrationService();

3. MCP ツールの LangChain エージェントへの登録

addToolServersToAgent メソッドを使用して、すべての構成済み MCP ツールを LangChain エージェントに登録します。この方法では、エージェンティック認証と非エージェンティック認証の両方のシナリオを処理します:

// Get MCP Tools
try {
  const agent = await toolService.addToolServersToAgent(
    agent,
    process.env.AGENTIC_USER_ID || '',
    authorization,
    turnContext,
    process.env.MCP_AUTH_TOKEN || "",
  );
} catch (error) {
  console.error('Error adding MCP tool servers:', error);
}

メソッド parameters

次の表では、addToolServersToAgent メソッドで使用するパラメーターについて説明します。

パラメーター	説明
`agent`	ツールを登録する LangChain ReactAgent インスタンス。
`agentUserId`	エージェントユーザーの一意識別子。エージェンティック認証を使用しない場合は、空の文字列 (`''`) にすることができます。
`authorization`	ユーザーの認可コンテキスト。
`turnContext`	エージェント SDK からの現在の会話ターンコンテキスト。セキュリティで保護されたツール登録用のユーザー ID、会話メタデータ、および認証コンテキストを提供します。
`authToken`	(オプション) 非エージェンティック認証シナリオのベアラートークン。

4. 初期化中の呼び出し

初期化中に addToolServersToAgent メソッドを呼び出して、MCP ツールをエージェントに登録します。

addToolServersToAgent メソッドは自動的に:

ToolingManifest.json からすべての MCP サーバーを読み込みます
LangChain エージェントにツールを登録します
マニフェスト構成に基づいて認証を設定します
エージェントがツールを呼び出すことができるようにします

.NET と Semantic Kernel

この例では、MCP ツールと Semantic Kernel を .NET アプリケーションで統合する方法を示します。

1. インポートステートメントの追加

ツーリングモジュールと Semantic Kernel 拡張機能にアクセスするために必要な名前空間を追加します:

using Microsoft.Agents.A365.Tooling;
using Microsoft.Agents.A365.Tooling.Extensions.SemanticKernel;

2. サービスの依存関係の挿入による登録

ツーリングサービスを依存関係挿入コンテナーに追加して、クラスに挿入できるようにします:

builder.Services.AddSingleton<IMcpToolRegistrationService, McpToolRegistrationService>();
builder.Services.AddSingleton<IMcpToolServerConfigurationService, McpToolServerConfigurationService>();

3. 非公開フィールド宣言の追加

ツール登録サービス参照を保持する非公開フィールドを宣言します:

private readonly IMcpToolRegistrationService _toolsService;

4. MCP ツールの Semantic Kernel への登録

AddToolServersToAgentAsync 拡張機能メソッドを使用して、すべての構成済み MCP ツールを Semantic Kernel インスタンスに登録します。この方法では、エージェンティック認証と非エージェンティック認証の両方のシナリオを処理します:

// Simplified call (authentication configured automatically)
await toolService.AddToolServersToAgentAsync(kernel, userAuthorization, turnContext);

// Or with explicit authentication parameters:
if (useAgenticAuth)
{
    await toolService.AddToolServersToAgentAsync(kernel, userAuthorization, authHandlerName, turnContext);
}
else
{
    await toolService.AddToolServersToAgentAsync(kernel, userAuthorization, authHandlerName, turnContext, authToken);
}

注意

複数のメソッドオーバーロードを使用できます。簡易バージョンでは既定の認証構成を使用しますが、明示バージョンではカスタム認証ハンドラーの仕様を使用できます。

メソッド parameters

次の表では、AddToolServersToAgentAsync で使用するパラメーターについて説明します

パラメーター	説明
`kernel`	ツールを登録する Semantic Kernel インスタンス。 Kernel は、AI サービス、プラグイン、および関数の実行を調整します。
`userAuthorization`	ユーザーの認可コンテキスト
`authHandlerName`	UserAuthorization システムで使用する認証ハンドラー名
`turnContext`	エージェント SDK からの現在の会話ターンコンテキスト (1 つのユーザーメッセージとエージェント応答サイクル)。セキュリティで保護されたツール登録用のユーザー ID、会話メタデータ、および認証コンテキストを提供します。
`authToken`	(オプション) 非エージェンティック認証シナリオのベアラートークン

AddToolServersToAgentAsync メソッドは自動的に:

ToolingManifest.json からすべての MCP サーバーを読み込みます
ツールを Semantic Kernel に登録します
マニフェスト構成に基づいて認証を設定します
エージェントがツールを呼び出すことができるようにします

完全な作業例については、Agent 365 サンプルリポジトリを参照してください。

テストと監視

エージェントをテストする

MCP ツールをエージェントに統合した後、ツールの呼び出しをテストして、正しく動作し、さまざまなシナリオを処理できることを確認します。テストガイドに従って環境を設定し、主にテストツールの呼び出しセクションに注目して、MCP ツールが想定どおりに動作していることを確認します。

監視の追加

エージェントに監視を追加して、エージェントの MCP ツール呼び出しを監視およびトレースし、監視機能を追加して、パフォーマンスを追跡し、問題をデバッグし、ツールの使用パターンを理解します。トレースと監視の実装の詳細

フィードバック

このページはお役に立ちましたか?

Last updated on 2025-12-08

次の方法で共有

ツールの追加と管理

概要

前提条件

エージェント ID の設定

サービス プリンシパルを設定する

MCP サーバーの構成

使用可能なサーバーの検出

MCP サーバーの追加

構成済みサーバーの一覧表示

MCP サーバーの削除

ツーリング マニフェストの理解

マニフェスト構造

マニフェスト パラメーター

エージェントへのツールの統合

ツール サーバーの一覧表示 (オプション)

オーケストレーターへのツールの登録

オーケストレーター拡張機能の選択

実装の例

Python と OpenAI

1. インポート ステートメントの追加

2. ツーリング サービスの初期化

3. MCP ツールの OpenAI エージェントへの登録

メソッド parameters

4. 初期化中の呼び出し

テストと監視

エージェントをテストする

監視の追加

フィードバック

その他のリソース

サービスプリンシパルを設定する

ツーリングマニフェストの理解

マニフェストパラメーター

ツールサーバーの一覧表示 (オプション)

1. インポートステートメントの追加

2. ツーリングサービスの初期化