McpToolRegistrationService Classe

Fournit des services liés aux outils dans le noyau sémantique.

Ce service gère l’inscription et la gestion des serveurs d’outils MCP (Model Context Protocol) avec des agents de noyau sémantique.

Constructeur

McpToolRegistrationService()

Paramètres

Nom	Description
logger	Valeur par défaut: None

Méthodes

__init__	Initialisez le service d’inscription de l’outil MCP pour le noyau sémantique.
__new__
add_tool_servers_to_agent	Ajoute les serveurs d’outils A365 MCP au noyau spécifié.
cleanup_connections	Nettoyez tous les plug-ins MCP connectés.
send_chat_history	Envoyez l’historique des conversations du noyau sémantique à la plateforme MCP. Cette méthode extrait les messages d’un objet ChatHistory du noyau sémantique, les convertit au format ChatHistoryMessage et les envoie à la plateforme MCP pour la protection contre les menaces en temps réel.
send_chat_history_messages	Envoyez des messages d’historique de conversation de noyau sémantique à la plateforme MCP. Cette méthode accepte une séquence d’objets ChatMessageContent du noyau sémantique, les convertit au format ChatHistoryMessage et les envoie à la plateforme MCP pour la protection contre les menaces en temps réel.

init

Initialisez le service d’inscription de l’outil MCP pour le noyau sémantique.

__init__(logger: Logger | None = None)

Paramètres

Nom	Description
logger	Logger \| None Instance d’enregistreur d’événements pour les opérations de journalisation. Valeur par défaut: None

new

__new__(**kwargs)

add_tool_servers_to_agent

Ajoute les serveurs d’outils A365 MCP au noyau spécifié.

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

Paramètres

Nom	Description
kernel Obligatoire	Kernel Instance de noyau sémantique à laquelle les outils seront ajoutés.
auth Obligatoire	Authorization Gestionnaire d’autorisation pour l’échange de jetons.
auth_handler_name Obligatoire	str Nom du gestionnaire d’autorisation.
context Obligatoire	TurnContext Activer le contexte de l’opération actuelle.
auth_token	str \| None Jeton d’authentification pour accéder aux serveurs MCP. Valeur par défaut: None

Retours

Type	Description
None

Exceptions

Type	Description
ValueError	Si le noyau n’est pas valide ou si les paramètres requis ne sont pas valides.
Exception	En cas d’erreur lors de la connexion ou de la configuration des serveurs MCP.

cleanup_connections

Nettoyez tous les plug-ins MCP connectés.

async cleanup_connections() -> None

Retours

Type	Description
None

send_chat_history

Envoyez l’historique des conversations du noyau sémantique à la plateforme MCP.

Cette méthode extrait les messages d’un objet ChatHistory du noyau sémantique, les convertit au format ChatHistoryMessage et les envoie à la plateforme MCP pour la protection contre les menaces en temps réel.

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

Paramètres

Nom	Description
turn_context Obligatoire	TurnContext TurnContext à partir du Kit de développement logiciel (SDK) Agents contenant des informations de conversation.
chat_history Obligatoire	ChatHistory Objet ChatHistory du noyau sémantique contenant des messages.
limit	int \| None Nombre maximal facultatif de messages à envoyer. S’il est spécifié, envoie les messages N les plus récents. Si aucun, envoie tous les messages. Valeur par défaut: None
options	ToolOptions \| None Configuration facultative pour la demande. Valeur par défaut: None

Retours

Type	Description
OperationResult	OperationResult indiquant la réussite ou l’échec.

Exceptions

Type	Description
ValueError	Si turn_context ou chat_history n’est pas.

Exemples


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

Envoyez des messages d’historique de conversation de noyau sémantique à la plateforme MCP.

Cette méthode accepte une séquence d’objets ChatMessageContent du noyau sémantique, les convertit au format ChatHistoryMessage et les envoie à la plateforme MCP pour la protection contre les menaces en temps réel.

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

Paramètres

Nom	Description
turn_context Obligatoire	TurnContext TurnContext à partir du Kit de développement logiciel (SDK) Agents contenant des informations de conversation.
messages Obligatoire	Sequence[ChatMessageContent] Séquence d’objets ChatMessageContent du noyau sémantique à envoyer.
options	ToolOptions \| None Configuration facultative pour la demande. Valeur par défaut: None

Retours

Type	Description
OperationResult	OperationResult indiquant la réussite ou l’échec.

Exceptions

Type	Description
ValueError	Si turn_context ou les messages ne sont pas.

Exemples


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