McpToolRegistrationService クラス
Azure Foundry エージェント用の MCP ツール登録サービスを提供します。
このサービスは、Azure AI SDK を使用して、Azure Foundry エージェントを使用した MCP (モデル コンテキスト プロトコル) ツール サーバーの登録と管理を処理します。 MCP サーバーと Azure Foundry のエージェント フレームワークの間にシームレスな統合が提供されます。
機能
- MCP サーバーの自動検出と構成
- Azure ID と DefaultAzureCredential の統合
- ツール定義とリソース管理
- 開発 (ToolingManifest.json) シナリオと運用 (ゲートウェイ API) シナリオの両方のサポート
- 包括的なエラー処理とログ記録
Azure Foundry の MCP ツール登録サービスを初期化します。
コンストラクター
McpToolRegistrationService(logger: Logger | None = None, credential: DefaultAzureCredential | None = None)
パラメーター
| 名前 | 説明 |
|---|---|
|
logger
|
ログ記録操作のロガー インスタンス。 規定値: None
|
|
credential
|
認証用の Azure 資格情報。 None の場合、DefaultAzureCredential が使用されます。 規定値: None
|
例
>>> service = McpToolRegistrationService()
>>> service.add_tool_servers_to_agent(project_client, agent_id, token)
メソッド
| add_tool_servers_to_agent |
MCP ツール サーバーを Azure Foundry エージェントに追加します。 |
add_tool_servers_to_agent
MCP ツール サーバーを Azure Foundry エージェントに追加します。
async add_tool_servers_to_agent(project_client: AIProjectClient, auth: Authorization, auth_handler_name: str, context: TurnContext, auth_token: str | None = None) -> None
パラメーター
| 名前 | 説明 |
|---|---|
|
project_client
必須
|
Azure Foundry AIProjectClient インスタンス。 |
|
auth
必須
|
トークン交換の承認ハンドラー。 |
|
auth_handler_name
必須
|
承認ハンドラーの名前。 |
|
context
必須
|
現在の操作のコンテキストを有効にします。 |
|
auth_token
|
MCP サーバーにアクセスするための認証トークン。 規定値: None
|
例外
| 型 | 説明 |
|---|---|
|
project_clientが None の場合、または必須パラメーターが無効です。 |
|
|
MCP ツールの登録中にエラーが発生した場合。 |