McpToolRegistrationService Klass

Tillhandahåller tjänster relaterade till verktyg i semantisk kernel.

Den här tjänsten hanterar registrering och hantering av MCP-verktygsservrar (Model Context Protocol) med semantiska kernelagenter.

Konstruktor

McpToolRegistrationService()

Parametrar

Name	Description
logger	Standardvärde: None

Metoder

__init__	Initiera registreringstjänsten för MCP-verktyget för semantisk kernel.
__new__
add_tool_servers_to_agent	Lägger till A365 MCP-verktygsservrarna i den angivna kerneln.
cleanup_connections	Rensa alla anslutna MCP-plugin-program.
send_chat_history	Skicka semantisk kernelchatthistorik till MCP-plattformen. Den här metoden extraherar meddelanden från ett Semantic Kernel ChatHistory-objekt, konverterar dem till ChatHistoryMessage-format och skickar dem till MCP-plattformen för skydd mot hot i realtid.
send_chat_history_messages	Skicka meddelanden om semantisk kernelchatthistorik till MCP-plattformen. Den här metoden accepterar en sekvens av Semantic Kernel ChatMessageContent-objekt, konverterar dem till ChatHistoryMessage-format och skickar dem till MCP-plattformen för skydd mot hot i realtid.

init

Initiera registreringstjänsten för MCP-verktyget för semantisk kernel.

__init__(logger: Logger | None = None)

Parametrar

Name	Description
logger	Logger \| None Loggningsinstans för loggningsåtgärder. Standardvärde: None

new

__new__(**kwargs)

add_tool_servers_to_agent

Lägger till A365 MCP-verktygsservrarna i den angivna kerneln.

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

Parametrar

Name	Description
kernel Obligatorisk	Kernel Den semantiska kernelinstans som verktygen ska läggas till i.
auth Obligatorisk	Authorization Auktoriseringshanterare för tokenutbyte.
auth_handler_name Obligatorisk	str Namnet på auktoriseringshanteraren.
context Obligatorisk	TurnContext Aktivera kontext för den aktuella åtgärden.
auth_token	str \| None Autentiseringstoken för åtkomst till MCP-servrarna. Standardvärde: None

Returer

Typ	Description
None

Undantag

Typ	Description
ValueError	Om kerneln är Ingen eller obligatoriska parametrar är ogiltiga.
Exception	Om det uppstår ett fel vid anslutning till eller konfiguration av MCP-servrar.

cleanup_connections

Rensa alla anslutna MCP-plugin-program.

async cleanup_connections() -> None

Returer

Typ	Description
None

send_chat_history

Skicka semantisk kernelchatthistorik till MCP-plattformen.

Den här metoden extraherar meddelanden från ett Semantic Kernel ChatHistory-objekt, konverterar dem till ChatHistoryMessage-format och skickar dem till MCP-plattformen för skydd mot hot i realtid.

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

Parametrar

Name	Description
turn_context Obligatorisk	TurnContext TurnContext från Agents SDK som innehåller konversationsinformation.
chat_history Obligatorisk	ChatHistory Semantisk Kernel ChatHistory-objekt som innehåller meddelanden.
limit	int \| None Valfritt maximalt antal meddelanden att skicka. Om det anges skickar du de senaste N-meddelandena. Om ingen, skickar alla meddelanden. Standardvärde: None
options	ToolOptions \| None Valfri konfiguration för begäran. Standardvärde: None

Returer

Typ	Description
OperationResult	OperationResult som anger lyckat eller misslyckat.

Undantag

Typ	Description
ValueError	Om turn_context eller chat_history är Ingen.

Exempel


>>> 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

Skicka meddelanden om semantisk kernelchatthistorik till MCP-plattformen.

Den här metoden accepterar en sekvens av Semantic Kernel ChatMessageContent-objekt, konverterar dem till ChatHistoryMessage-format och skickar dem till MCP-plattformen för skydd mot hot i realtid.

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

Parametrar

Name	Description
turn_context Obligatorisk	TurnContext TurnContext från Agents SDK som innehåller konversationsinformation.
messages Obligatorisk	Sequence[ChatMessageContent] Sekvens av Semantic Kernel ChatMessageContent-objekt som ska skickas.
options	ToolOptions \| None Valfri konfiguration för begäran. Standardvärde: None

Returer

Typ	Description
OperationResult	OperationResult som anger lyckat eller misslyckat.

Undantag

Typ	Description
ValueError	Om turn_context eller meddelanden är Ingen.

Exempel


>>> 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")