McpToolRegistrationService Clase

Proporciona servicios relacionados con las herramientas del kernel semántico.

Este servicio controla el registro y la administración de servidores de herramientas MCP (Protocolo de contexto de modelo) con agentes de kernel semántico.

Constructor

McpToolRegistrationService()

Parámetros

Nombre	Description
logger	Valor predeterminado: None

Métodos

__init__	Inicialice el servicio de registro de herramientas de MCP para kernel semántico.
__new__
add_tool_servers_to_agent	Agrega los servidores de herramientas MCP de A365 al kernel especificado.
cleanup_connections	Limpie todos los complementos MCP conectados.
send_chat_history	Envíe el historial de chats de kernel semántico a la plataforma MCP. Este método extrae mensajes de un objeto ChatHistory del kernel semántico, los convierte en formato ChatHistoryMessage y los envía a la plataforma MCP para la protección contra amenazas en tiempo real.
send_chat_history_messages	Envíe mensajes de historial de chat de kernel semántico a la plataforma MCP. Este método acepta una secuencia de objetos ChatMessageContent del kernel semántico, los convierte en formato ChatHistoryMessage y los envía a la plataforma MCP para la protección contra amenazas en tiempo real.

init

Inicialice el servicio de registro de herramientas de MCP para kernel semántico.

__init__(logger: Logger | None = None)

Parámetros

Nombre	Description
logger	Logger \| None Instancia del registrador para las operaciones de registro. Valor predeterminado: None

new

__new__(**kwargs)

add_tool_servers_to_agent

Agrega los servidores de herramientas MCP de A365 al 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

Nombre	Description
kernel Requerido	Kernel Instancia del kernel semántico a la que se agregarán las herramientas.
auth Requerido	Authorization Controlador de autorización para el intercambio de tokens.
auth_handler_name Requerido	str Nombre del controlador de autorización.
context Requerido	TurnContext Active el contexto de la operación actual.
auth_token	str \| None Token de autenticación para acceder a los servidores MCP. Valor predeterminado: None

Devoluciones

Tipo	Description
None

Excepciones

Tipo	Description
ValueError	Si el kernel es None o los parámetros obligatorios no son válidos.
Exception	Si se produce un error al conectarse o configurar servidores MCP.

cleanup_connections

Limpie todos los complementos MCP conectados.

async cleanup_connections() -> None

Devoluciones

Tipo	Description
None

send_chat_history

Envíe el historial de chats de kernel semántico a la plataforma MCP.

Este método extrae mensajes de un objeto ChatHistory del kernel semántico, los convierte en formato ChatHistoryMessage y los envía a la plataforma MCP para la protección contra amenazas en tiempo real.

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

Parámetros

Nombre	Description
turn_context Requerido	TurnContext TurnContext del SDK de agentes que contiene información de conversación.
chat_history Requerido	ChatHistory Objeto ChatHistory del kernel semántico que contiene mensajes.
limit	int \| None Número máximo opcional de mensajes que se van a enviar. Si se especifica, envía los mensajes N más recientes. Si no, envía todos los mensajes. Valor predeterminado: None
options	ToolOptions \| None Configuración opcional para la solicitud. Valor predeterminado: None

Devoluciones

Tipo	Description
OperationResult	OperationResult indica que se ha realizado correctamente o no.

Excepciones

Tipo	Description
ValueError	Si turn_context o chat_history es Ninguno.

Ejemplos


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

Envíe mensajes de historial de chat de kernel semántico a la plataforma MCP.

Este método acepta una secuencia de objetos ChatMessageContent del kernel semántico, los convierte en formato ChatHistoryMessage y los envía a la plataforma MCP para la protección contra amenazas en tiempo real.

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

Parámetros

Nombre	Description
turn_context Requerido	TurnContext TurnContext del SDK de agentes que contiene información de conversación.
messages Requerido	Sequence[ChatMessageContent] Secuencia de objetos ChatMessageContent del kernel semántico que se van a enviar.
options	ToolOptions \| None Configuración opcional para la solicitud. Valor predeterminado: None

Devoluciones

Tipo	Description
OperationResult	OperationResult indica que se ha realizado correctamente o no.

Excepciones

Tipo	Description
ValueError	Si turn_context o mensajes es Ninguno.

Ejemplos


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