McpToolRegistrationService Luokka

Tarjoaa semanttisen ytimen työkaluihin liittyviä palveluita.

Tämä palvelu käsittelee MCP (Model Context Protocol) -työkalupalvelimien rekisteröinnin ja hallinnan semanttisten kernelagenttien avulla.

Konstruktori

McpToolRegistrationService()

Parametrit

Nimi	Description
logger	Default value: None

Menetelmät

__init__	Alusta MCP-työkalun rekisteröintipalvelu semanttista ydintä varten.
__new__
add_tool_servers_to_agent	Lisää A365 MCP -työkalupalvelimet määritettyyn ytimeen.
cleanup_connections	Tyhjennä kaikki yhdistetyt MCP-laajennukset.
send_chat_history	Lähetä semanttinen ytimen keskusteluhistoria MCP-ympäristöön. Tämä menetelmä poimii viestit semanttisesta Kernel ChatHistory -objektista, muuntaa ne ChatHistoryMessage-muotoon ja lähettää ne MCP-ympäristöön reaaliaikaista uhkien suojausta varten.
send_chat_history_messages	Lähetä semanttisia ydinkeskusteluhistoriaviestejä MCP-ympäristöön. Tämä menetelmä hyväksyy semanttisen Kernel ChatMessageContent -objektien sarjan, muuntaa ne ChatHistoryMessage-muotoon ja lähettää ne MCP-ympäristöön reaaliaikaista uhkien suojausta varten.

init

Alusta MCP-työkalun rekisteröintipalvelu semanttista ydintä varten.

__init__(logger: Logger | None = None)

Parametrit

Nimi	Description
logger	Logger \| None Lokitoiminnon esiintymä lokitoimintoja varten. Default value: None

new

__new__(**kwargs)

add_tool_servers_to_agent

Lisää A365 MCP -työkalupalvelimet määritettyyn ytimeen.

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

Parametrit

Nimi	Description
kernel Pakollinen	Kernel Semanttinen ydin -esiintymä, johon työkalut lisätään.
auth Pakollinen	Authorization Valtuutuskäsittelijä tunnuksen vaihdolle.
auth_handler_name Pakollinen	str Valtuutuskäsittelijän nimi.
context Pakollinen	TurnContext Käännä nykyisen toiminnon konteksti.
auth_token	str \| None Todennustunnus MCP-palvelimien käyttämistä varten. Default value: None

Palautukset

Tyyppi	Description
None

Poikkeukset

Tyyppi	Description
ValueError	Jos ydin on Ei mitään tai jos pakolliset parametrit ovat virheellisiä.
Exception	Jos mcP-palvelimiin yhdistettäessä tai määritettäessä esiintyy virhe.

cleanup_connections

Tyhjennä kaikki yhdistetyt MCP-laajennukset.

async cleanup_connections() -> None

Palautukset

Tyyppi	Description
None

send_chat_history

Lähetä semanttinen ytimen keskusteluhistoria MCP-ympäristöön.

Tämä menetelmä poimii viestit semanttisesta Kernel ChatHistory -objektista, muuntaa ne ChatHistoryMessage-muotoon ja lähettää ne MCP-ympäristöön reaaliaikaista uhkien suojausta varten.

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

Parametrit

Nimi	Description
turn_context Pakollinen	TurnContext TurnContext agenttien SDK:sta, joka sisältää tietoja keskustelusta.
chat_history Pakollinen	ChatHistory Viestejä sisältävä semanttinen Kernel ChatHistory -objekti.
limit	int \| None Valinnainen lähetettävän viestien enimmäismäärä. Jos tämä on määritetty, se lähettää uusimmat N viestiä. Jos Ei mitään, kaikki viestit lähetetään. Default value: None
options	ToolOptions \| None Pyynnön valinnainen määritys. Default value: None

Palautukset

Tyyppi	Description
OperationResult	ToimintoTulos, joka ilmaisee onnistumisen tai epäonnistumisen.

Poikkeukset

Tyyppi	Description
ValueError	Jos turn_context tai chat_history on Ei mitään.

Esimerkit


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

Lähetä semanttisia ydinkeskusteluhistoriaviestejä MCP-ympäristöön.

Tämä menetelmä hyväksyy semanttisen Kernel ChatMessageContent -objektien sarjan, muuntaa ne ChatHistoryMessage-muotoon ja lähettää ne MCP-ympäristöön reaaliaikaista uhkien suojausta varten.

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

Parametrit

Nimi	Description
turn_context Pakollinen	TurnContext TurnContext agenttien SDK:sta, joka sisältää tietoja keskustelusta.
messages Pakollinen	Sequence[ChatMessageContent] Lähetettävät semanttiset Kernel ChatMessageContent -objektit.
options	ToolOptions \| None Pyynnön valinnainen määritys. Default value: None

Palautukset

Tyyppi	Description
OperationResult	ToimintoTulos, joka ilmaisee onnistumisen tai epäonnistumisen.

Poikkeukset

Tyyppi	Description
ValueError	Jos turn_context tai sanomat ovat Ei mitään.

Esimerkit


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