McpToolRegistrationService Classe

Fornece serviços relacionados a ferramentas no Kernel Semântico.

Esse serviço lida com o registro e o gerenciamento de servidores de ferramenta MCP (Protocolo de Contexto de Modelo) com agentes kernel semânticos.

Construtor

McpToolRegistrationService()

Parâmetros

Nome	Description
logger	Valor padrão: None

Métodos

__init__	Inicialize o Serviço de Registro da Ferramenta MCP para Kernel Semântico.
__new__
add_tool_servers_to_agent	Adiciona os Servidores de Ferramentas DO MCP A365 ao kernel especificado.
cleanup_connections	Limpe todos os plug-ins do MCP conectados.
send_chat_history	Envie o histórico de chat semântico do Kernel para a plataforma MCP. Esse método extrai mensagens de um objeto Semantic Kernel ChatHistory, converte-as no formato ChatHistoryMessage e as envia para a plataforma MCP para proteção contra ameaças em tempo real.
send_chat_history_messages	Envie mensagens semânticas do histórico de chat do Kernel para a plataforma MCP. Esse método aceita uma sequência de objetos Semantic Kernel ChatMessageContent, converte-os no formato ChatHistoryMessage e os envia para a plataforma MCP para proteção contra ameaças em tempo real.

init

Inicialize o Serviço de Registro da Ferramenta MCP para Kernel Semântico.

__init__(logger: Logger | None = None)

Parâmetros

Nome	Description
logger	Logger \| None Instância do agente para operações de registro em log. Valor padrão: None

new

__new__(**kwargs)

add_tool_servers_to_agent

Adiciona os Servidores de Ferramentas DO MCP A365 ao kernel especificado.

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

Parâmetros

Nome	Description
kernel Obrigatório	Kernel A instância de Kernel Semântico à qual as ferramentas serão adicionadas.
auth Obrigatório	Authorization Manipulador de autorização para troca de token.
auth_handler_name Obrigatório	str Nome do manipulador de autorização.
context Obrigatório	TurnContext Transforme o contexto da operação atual.
auth_token	str \| None Token de autenticação para acessar os servidores MCP. Valor padrão: None

Retornos

Tipo	Description
None

Exceções

Tipo	Description
ValueError	Se kernel for Nenhum ou parâmetros necessários forem inválidos.
Exception	Se houver um erro ao conectar ou configurar servidores MCP.

cleanup_connections

Limpe todos os plug-ins do MCP conectados.

async cleanup_connections() -> None

Retornos

Tipo	Description
None

send_chat_history

Envie o histórico de chat semântico do Kernel para a plataforma MCP.

Esse método extrai mensagens de um objeto Semantic Kernel ChatHistory, converte-as no formato ChatHistoryMessage e as envia para a plataforma MCP para proteção contra ameaças em tempo real.

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

Parâmetros

Nome	Description
turn_context Obrigatório	TurnContext TurnContext do SDK de Agentes que contém informações de conversa.
chat_history Obrigatório	ChatHistory Objeto Semântico Kernel ChatHistory que contém mensagens.
limit	int \| None Número máximo opcional de mensagens a serem enviadas. Se especificado, envia as N mensagens mais recentes. Se Nenhum, envia todas as mensagens. Valor padrão: None
options	ToolOptions \| None Configuração opcional para a solicitação. Valor padrão: None

Retornos

Tipo	Description
OperationResult	OperationResult indicando êxito ou falha.

Exceções

Tipo	Description
ValueError	Se turn_context ou chat_history for Nenhum.

Exemplos


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

Envie mensagens semânticas do histórico de chat do Kernel para a plataforma MCP.

Esse método aceita uma sequência de objetos Semantic Kernel ChatMessageContent, converte-os no formato ChatHistoryMessage e os envia para a plataforma MCP para proteção contra ameaças em tempo real.

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

Parâmetros

Nome	Description
turn_context Obrigatório	TurnContext TurnContext do SDK de Agentes que contém informações de conversa.
messages Obrigatório	Sequence[ChatMessageContent] Sequência de objetos Semantic Kernel ChatMessageContent a serem enviados.
options	ToolOptions \| None Configuração opcional para a solicitação. Valor padrão: None

Retornos

Tipo	Description
OperationResult	OperationResult indicando êxito ou falha.

Exceções

Tipo	Description
ValueError	Se turn_context ou mensagens for Nenhum.

Exemplos


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