McpToolRegistrationService クラス

エージェントフレームワークエージェント用の MCP ツール登録サービスを提供します。

このサービスは、エージェントフレームワークエージェントを使用した MCP (モデルコンテキストプロトコル) ツールサーバーの登録と管理を処理します。

コンストラクター

McpToolRegistrationService()

パラメーター

名前	説明
logger	規定値: None

メソッド

__init__	エージェントフレームワークの MCP ツール登録サービスを初期化します。
__new__
add_tool_servers_to_agent	RawAgent に MCP ツールサーバーを追加します (.NET 実装をミラー化します)。
cleanup	サービスによって使用されるすべてのリソースをクリーンアップします。
send_chat_history_from_store	HistoryProvider から MCP プラットフォームにチャット履歴を送信します。これは、ストアからメッセージを抽出し、デリゲートを send_chat_history_messages() に抽出する便利なメソッドです。
send_chat_history_messages	リアルタイムの脅威保護のために、チャット履歴メッセージを MCP プラットフォームに送信します。これは、メッセージ変換とコアツールサービスへの委任を処理する主要な実装方法です。 Note chat_messagesが空の場合や、すべてのメッセージが変換すると、要求は引き続き MCP プラットフォームに送信されます。これ turn_context.activity.text からのユーザーメッセージが登録されていることを確認しますリアルタイムの脅威保護のために正しく。

init

エージェントフレームワークの MCP ツール登録サービスを初期化します。

__init__(logger: Logger | None = None)

パラメーター

名前	説明
logger	Logger \| None ログ記録操作のロガーインスタンス。規定値: None

new

__new__(**kwargs)

add_tool_servers_to_agent

RawAgent に MCP ツールサーバーを追加します (.NET 実装をミラー化します)。

async add_tool_servers_to_agent(chat_client: OpenAIChatClient, agent_instructions: str, initial_tools: List[object], auth: Authorization, auth_handler_name: str, turn_context: TurnContext, auth_token: str | None = None) -> RawAgent

パラメーター

名前	説明
chat_client 必須	<xref:OpenAIChatClient> チャットクライアントインスタンス (OpenAIChatClient は OpenAI と Azure OpenAI の両方をサポート)
agent_instructions 必須	str エージェントの動作の手順
initial_tools 必須	List[object] エージェントに追加する初期ツールの一覧
auth 必須	<xref:Authorization> トークン交換の承認コンテキスト
auth_handler_name 必須	str 承認ハンドラーの名前。
turn_context 必須	<xref:TurnContext> 操作のコンテキストを有効にする
auth_token	Optional[str] 認証用のオプションのベアラートークン規定値: None

返品

型	説明
<xref:RawAgent>	MCP ツールが登録されている RawAgent インスタンス。

例外

型	説明
Exception	エージェントの作成が失敗した場合。

cleanup

サービスによって使用されるすべてのリソースをクリーンアップします。

async cleanup()

send_chat_history_from_store

HistoryProvider から MCP プラットフォームにチャット履歴を送信します。

これは、ストアからメッセージを抽出し、デリゲートを send_chat_history_messages() に抽出する便利なメソッドです。

async send_chat_history_from_store(chat_message_store: HistoryProvider, turn_context: TurnContext, tool_options: ToolOptions | None = None) -> OperationResult

パラメーター

名前	説明
chat_message_store 必須	<xref:agent_framework._sessions.HistoryProvider> 会話履歴を含む HistoryProvider。
turn_context 必須	TurnContext 会話情報を含む Agents SDK の TurnContext。
tool_options	ToolOptions \| None 要求のオプションの構成。規定値: None

返品

型	説明
OperationResult	操作の成功または失敗を示す OperationResult。

例外

型	説明
ValueError	chat_message_storeまたはturn_contextが None の場合。

例


>>> service = McpToolRegistrationService()
>>> result = await service.send_chat_history_from_store(
...     thread.chat_message_store, turn_context
... )

send_chat_history_messages

リアルタイムの脅威保護のために、チャット履歴メッセージを MCP プラットフォームに送信します。

これは、メッセージ変換とコアツールサービスへの委任を処理する主要な実装方法です。

Note

chat_messagesが空の場合や、すべてのメッセージが

変換すると、要求は引き続き MCP プラットフォームに送信されます。これ

turn_context.activity.text からのユーザーメッセージが登録されていることを確認します

リアルタイムの脅威保護のために正しく。

async send_chat_history_messages(chat_messages: Sequence[Message], turn_context: TurnContext, tool_options: ToolOptions | None = None) -> OperationResult

パラメーター

名前	説明
chat_messages 必須	Sequence[<xref:agent_framework._types.Message>] 送信するエージェントフレームワークメッセージオブジェクトのシーケンス。空にすることができます。要求は引き続き送信され、turn_context.activity.text からユーザーメッセージを登録します。
turn_context 必須	TurnContext 会話情報を含む Agents SDK の TurnContext。
tool_options	ToolOptions \| None 要求のオプションの構成。指定しない場合は、AgentFramework 固有のオプションが既定値になります。規定値: None

返品

型	説明
OperationResult	操作の成功または失敗を示す OperationResult。

例外

型	説明
ValueError	chat_messagesまたはturn_contextが None の場合。

例


>>> service = McpToolRegistrationService()
>>> messages = [Message(role="user", text="Hello")]
>>> result = await service.send_chat_history_messages(messages, turn_context)
>>> if result.succeeded:
...     print("Chat history sent successfully")