McpToolRegistrationService Klasse

Leverer tjenester relatert til verktøy i Semantic Kernel.

Denne tjenesten håndterer registrering og administrasjon av MCP-verktøyservere (Model Context Protocol) med Semantic Kernel-agenter.

Konstruktør

McpToolRegistrationService()

Parametere

Navn	Beskrivelse
logger	Default value: None

Metoder

__init__	Initialiser MCP Tool Registration Service for Semantic Kernel.
__new__
add_tool_servers_to_agent	Legger til A365 MCP-verktøyserverne i den angitte kjernen.
cleanup_connections	Rydd opp i alle tilkoblede MCP-programtillegg.
send_chat_history	Send Semantic Kernel-chatteloggen til MCP-plattformen. Denne metoden trekker ut meldinger fra et Semantic Kernel ChatHistory-objekt, konverterer dem til ChatHistoryMessage-format og sender dem til MCP-plattformen for trusselbeskyttelse i sanntid.
send_chat_history_messages	Send meldinger om semantisk kjernechat til MCP-plattformen. Denne metoden godtar en sekvens av Semantic Kernel ChatMessageContent-objekter, konverterer dem til ChatHistoryMessage-format og sender dem til MCP-plattformen for trusselbeskyttelse i sanntid.

init

Initialiser MCP Tool Registration Service for Semantic Kernel.

__init__(logger: Logger | None = None)

Parametere

Navn	Beskrivelse
logger	Logger \| None Loggerforekomst for loggingsoperasjoner. Default value: None

new

__new__(**kwargs)

add_tool_servers_to_agent

Legger til A365 MCP-verktøyserverne i den angitte kjernen.

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

Parametere

Navn	Beskrivelse
kernel Obligatorisk	Kernel Semantic Kernel-forekomsten som verktøyene skal legges til i.
auth Obligatorisk	Authorization Godkjenningsbehandling for tokenutveksling.
auth_handler_name Obligatorisk	str Navnet på godkjenningsbehandlingen.
context Obligatorisk	TurnContext Slå kontekst for gjeldende operasjon.
auth_token	str \| None Godkjenningstoken for å få tilgang til MCP-serverne. Default value: None

Returnerer

Type	Beskrivelse
None

Unntak

Type	Beskrivelse
ValueError	Hvis kjernen er Ingen eller nødvendige parametere er ugyldige.
Exception	Hvis det oppstår en feil under tilkobling til eller konfigurering av MCP-servere.

cleanup_connections

Rydd opp i alle tilkoblede MCP-programtillegg.

async cleanup_connections() -> None

Returnerer

Type	Beskrivelse
None

send_chat_history

Send Semantic Kernel-chatteloggen til MCP-plattformen.

Denne metoden trekker ut meldinger fra et Semantic Kernel ChatHistory-objekt, konverterer dem til ChatHistoryMessage-format og sender dem til MCP-plattformen for trusselbeskyttelse i sanntid.

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

Parametere

Navn	Beskrivelse
turn_context Obligatorisk	TurnContext TurnContext fra Agents SDK som inneholder samtaleinformasjon.
chat_history Obligatorisk	ChatHistory Semantic Kernel ChatHistory-objekt som inneholder meldinger.
limit	int \| None Valgfritt maksimalt antall meldinger som skal sendes. Hvis angitt, sender de nyeste N-meldingene. Hvis ingen, sender alle meldinger. Default value: None
options	ToolOptions \| None Valgfri konfigurasjon for forespørselen. Default value: None

Returnerer

Type	Beskrivelse
OperationResult	OperationResult angir vellykket eller mislykket.

Unntak

Type	Beskrivelse
ValueError	Hvis turn_context eller chat_history er Ingen.

Eksempler


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

Send meldinger om semantisk kjernechat til MCP-plattformen.

Denne metoden godtar en sekvens av Semantic Kernel ChatMessageContent-objekter, konverterer dem til ChatHistoryMessage-format og sender dem til MCP-plattformen for trusselbeskyttelse i sanntid.

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

Parametere

Navn	Beskrivelse
turn_context Obligatorisk	TurnContext TurnContext fra Agents SDK som inneholder samtaleinformasjon.
messages Obligatorisk	Sequence[ChatMessageContent] Sekvens av Semantic Kernel ChatMessageContent-objekter som skal sendes.
options	ToolOptions \| None Valgfri konfigurasjon for forespørselen. Default value: None

Returnerer

Type	Beskrivelse
OperationResult	OperationResult angir vellykket eller mislykket.

Unntak

Type	Beskrivelse
ValueError	Hvis turn_context eller meldinger er Ingen.

Eksempler


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