McpToolRegistrationService クラス

セマンティックカーネルのツールに関連するサービスを提供します。

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

コンストラクター

McpToolRegistrationService()

パラメーター

名前	説明
logger	規定値: None

メソッド

__init__	セマンティックカーネルの MCP ツール登録サービスを初期化します。
__new__
add_tool_servers_to_agent	指定したカーネルに A365 MCP ツールサーバーを追加します。
cleanup_connections	接続されているすべての MCP プラグインをクリーンアップします。
send_chat_history	セマンティックカーネルチャット履歴を MCP プラットフォームに送信します。このメソッドは、セマンティックカーネル ChatHistory オブジェクトからメッセージを抽出し、それらを ChatHistoryMessage 形式に変換して、リアルタイムの脅威保護のために MCP プラットフォームに送信します。
send_chat_history_messages	セマンティックカーネルチャット履歴メッセージを MCP プラットフォームに送信します。このメソッドは、セマンティックカーネル ChatMessageContent オブジェクトのシーケンスを受け入れ、それらを ChatHistoryMessage 形式に変換し、リアルタイムの脅威保護のために MCP プラットフォームに送信します。

init

セマンティックカーネルの MCP ツール登録サービスを初期化します。

__init__(logger: Logger | None = None)

パラメーター

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

new

__new__(**kwargs)

add_tool_servers_to_agent

指定したカーネルに A365 MCP ツールサーバーを追加します。

async add_tool_servers_to_agent(kernel: Kernel, auth: Authorization, auth_handler_name: str, context: TurnContext, auth_token: str | None = None) -> None

パラメーター

名前	説明
kernel 必須	Kernel ツールが追加されるセマンティックカーネルインスタンス。
auth 必須	Authorization トークン交換の承認ハンドラー。
auth_handler_name 必須	str 承認ハンドラーの名前。
context 必須	TurnContext 現在の操作のコンテキストを有効にします。
auth_token	str \| None MCP サーバーにアクセスするための認証トークン。規定値: None

返品

型	説明
None

例外

型	説明
ValueError	カーネルが None の場合、または必須パラメーターが無効です。
Exception	MCP サーバーへの接続または構成中にエラーが発生した場合。

cleanup_connections

接続されているすべての MCP プラグインをクリーンアップします。

async cleanup_connections() -> None

返品

型	説明
None

send_chat_history

セマンティックカーネルチャット履歴を MCP プラットフォームに送信します。

このメソッドは、セマンティックカーネル ChatHistory オブジェクトからメッセージを抽出し、それらを ChatHistoryMessage 形式に変換して、リアルタイムの脅威保護のために MCP プラットフォームに送信します。

async send_chat_history(turn_context: TurnContext, chat_history: ChatHistory, limit: int | None = None, options: ToolOptions | None = None) -> OperationResult

パラメーター

名前	説明
turn_context 必須	TurnContext 会話情報を含む Agents SDK の TurnContext。
chat_history 必須	ChatHistory メッセージを含むセマンティックカーネル ChatHistory オブジェクト。
limit	int \| None 送信するメッセージの最大数 (省略可能)。指定した場合は、最新の N メッセージを送信します。 None の場合は、すべてのメッセージを送信します。規定値: None
options	ToolOptions \| None 要求のオプションの構成。規定値: None

返品

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

例外

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

例


>>> from semantic_kernel.contents import ChatHistory
>>> from microsoft_agents_a365.tooling.extensions.semantickernel import (
...     McpToolRegistrationService
... )
>>>
>>> service = McpToolRegistrationService()
>>> chat_history = ChatHistory()
>>> chat_history.add_user_message("Hello!")
>>> chat_history.add_assistant_message("Hi there!")
>>>
>>> result = await service.send_chat_history(
...     turn_context, chat_history, limit=50
... )
>>> if result.succeeded:
...     print("Chat history sent successfully")

send_chat_history_messages

セマンティックカーネルチャット履歴メッセージを MCP プラットフォームに送信します。

このメソッドは、セマンティックカーネル ChatMessageContent オブジェクトのシーケンスを受け入れ、それらを ChatHistoryMessage 形式に変換し、リアルタイムの脅威保護のために MCP プラットフォームに送信します。

async send_chat_history_messages(turn_context: TurnContext, messages: Sequence[ChatMessageContent], options: ToolOptions | None = None) -> OperationResult

パラメーター

名前	説明
turn_context 必須	TurnContext 会話情報を含む Agents SDK の TurnContext。
messages 必須	Sequence[ChatMessageContent] 送信するセマンティックカーネル ChatMessageContent オブジェクトのシーケンス。
options	ToolOptions \| None 要求のオプションの構成。規定値: None

返品

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

例外

型	説明
ValueError	turn_contextまたはメッセージが None の場合。

例


>>> from semantic_kernel.contents import ChatMessageContent, AuthorRole
>>> from microsoft_agents_a365.tooling.extensions.semantickernel import (
...     McpToolRegistrationService
... )
>>>
>>> service = McpToolRegistrationService()
>>> messages = [
...     ChatMessageContent(role=AuthorRole.USER, content="Hello!"),
...     ChatMessageContent(role=AuthorRole.ASSISTANT, content="Hi there!"),
... ]
>>>
>>> result = await service.send_chat_history_messages(
...     turn_context, messages
... )
>>> if result.succeeded:
...     print("Chat history sent successfully")