McpToolRegistrationService Klasa

Udostępnia usługi związane z narzędziami w semantycznym jądrze.

Ta usługa obsługuje rejestrację i zarządzanie serwerami narzędzi MCP (Model Context Protocol) za pomocą agentów semantycznych jądra.

Konstruktor

McpToolRegistrationService()

Parametry

Nazwa	Opis
logger	Domyślna wartość: None

Metody

__init__	Zainicjuj usługę rejestracji narzędzi MCP dla jądra semantycznego.
__new__
add_tool_servers_to_agent	Dodaje serwery narzędzi MCP A365 do określonego jądra.
cleanup_connections	Wyczyść wszystkie podłączone wtyczki MCP.
send_chat_history	Wyślij historię czatu jądra semantycznego do platformy MCP. Ta metoda wyodrębnia komunikaty z obiektu ChatHistory jądra semantycznego, konwertuje je na format ChatHistoryMessage i wysyła je do platformy MCP w celu ochrony przed zagrożeniami w czasie rzeczywistym.
send_chat_history_messages	Wysyłanie wiadomości historii czatów jądra semantycznego do platformy MCP. Ta metoda akceptuje sekwencję obiektów ChatMessageContent jądra semantycznego, konwertuje je na format ChatHistoryMessage i wysyła je do platformy MCP w celu ochrony przed zagrożeniami w czasie rzeczywistym.

init

Zainicjuj usługę rejestracji narzędzi MCP dla jądra semantycznego.

__init__(logger: Logger | None = None)

Parametry

Nazwa	Opis
logger	Logger \| None Wystąpienie rejestratora na potrzeby operacji rejestrowania. Domyślna wartość: None

new

__new__(**kwargs)

add_tool_servers_to_agent

Dodaje serwery narzędzi MCP A365 do określonego jądra.

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

Parametry

Nazwa	Opis
kernel Wymagane	Kernel Wystąpienie semantyczne jądra, do którego zostaną dodane narzędzia.
auth Wymagane	Authorization Procedura obsługi autoryzacji na potrzeby wymiany tokenów.
auth_handler_name Wymagane	str Nazwa programu obsługi autoryzacji.
context Wymagane	TurnContext Włącz kontekst bieżącej operacji.
auth_token	str \| None Token uwierzytelniania w celu uzyskania dostępu do serwerów MCP. Domyślna wartość: None

Zwraca

Typ	Opis
None

Wyjątki

Typ	Opis
ValueError	Jeśli jądro ma wartość Brak lub wymagane parametry są nieprawidłowe.
Exception	Jeśli wystąpi błąd podczas nawiązywania połączenia z serwerami MCP lub konfigurowania ich.

cleanup_connections

Wyczyść wszystkie podłączone wtyczki MCP.

async cleanup_connections() -> None

Zwraca

Typ	Opis
None

send_chat_history

Wyślij historię czatu jądra semantycznego do platformy MCP.

Ta metoda wyodrębnia komunikaty z obiektu ChatHistory jądra semantycznego, konwertuje je na format ChatHistoryMessage i wysyła je do platformy MCP w celu ochrony przed zagrożeniami w czasie rzeczywistym.

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

Parametry

Nazwa	Opis
turn_context Wymagane	TurnContext Funkcja TurnContext z zestawu SDK agentów zawierająca informacje o konwersacji.
chat_history Wymagane	ChatHistory Semantyczny obiekt ChatHistory jądra zawierający komunikaty.
limit	int \| None Opcjonalna maksymalna liczba komunikatów do wysłania. Jeśli zostanie określony, wysyła najnowsze N komunikatów. Jeśli brak, wysyła wszystkie komunikaty. Domyślna wartość: None
options	ToolOptions \| None Opcjonalna konfiguracja żądania. Domyślna wartość: None

Zwraca

Typ	Opis
OperationResult	OperacjaResult wskazująca powodzenie lub niepowodzenie.

Wyjątki

Typ	Opis
ValueError	Jeśli turn_context lub chat_history to Brak.

Przykłady


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

Wysyłanie wiadomości historii czatów jądra semantycznego do platformy MCP.

Ta metoda akceptuje sekwencję obiektów ChatMessageContent jądra semantycznego, konwertuje je na format ChatHistoryMessage i wysyła je do platformy MCP w celu ochrony przed zagrożeniami w czasie rzeczywistym.

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

Parametry

Nazwa	Opis
turn_context Wymagane	TurnContext Funkcja TurnContext z zestawu SDK agentów zawierająca informacje o konwersacji.
messages Wymagane	Sequence[ChatMessageContent] Sekwencja obiektów ChatMessageContent jądra semantycznego do wysłania.
options	ToolOptions \| None Opcjonalna konfiguracja żądania. Domyślna wartość: None

Zwraca

Typ	Opis
OperationResult	OperacjaResult wskazująca powodzenie lub niepowodzenie.

Wyjątki

Typ	Opis
ValueError	Jeśli turn_context lub komunikaty to Brak.

Przykłady


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