McpToolServerConfigurationService Luokka

Tarjoaa palveluita MCP-työkalupalvelimen määritysten hallintaan.

Tämä palvelu käsittelee MCP (Model Context Protocol) -työkalupalvelimien etsimisen ja määrittämisen useista lähteistä:

• Kehitys: paikalliset ToolingManifest.json tiedostot
• Tuotanto: etätyökalujen yhdyskäytävän päätepisteet

Konstruktori

McpToolServerConfigurationService()

Parametrit

Nimi	Description
logger	Default value: None

Menetelmät

__init__	Alusta MCP-työkalupalvelimen määrityspalvelu.
__new__
list_tool_servers	Hakee luettelon MCP-palvelimista, jotka on määritetty agentille. Kun authorizationkaikki -, auth_handler_name- ja turn_context -tunnukset hankitaan kohderyhmäkohtaisille OAuth-tunnuksille löytöjen jälkeen: V1-palvelimet (ei audience kenttää) jakavat jaetun ATG-tunnuksen (yksi vaihto). Jokainen V2-palvelin saa tunnuksen, joka on rajoitettu heidän oman yleisönsä GUID-tunnuksen mukaan.
send_chat_history	Lähettää keskusteluhistorian MCP-ympäristöön reaaliaikaista uhkien suojausta varten. Muistio Vaikka chat_history_messages olisi tyhjä, pyyntö lähetetään edelleen kohteeseen MCP-alustalla. Näin varmistat käyttäjäviestin kohteesta turn_context.activity.text on rekisteröity oikein reaaliaikaiseen uhkien torjuntaan.

__init__

Alusta MCP-työkalupalvelimen määrityspalvelu.

__init__(logger: Logger | None = None)

Parametrit

Nimi	Description
logger	Logger | None Lokitoiminnon esiintymä lokitoimintoja varten. Jos Ei mitään, luo uuden lokitoiminnon. Default value: None

__new__

__new__(**kwargs)

list_tool_servers

Hakee luettelon MCP-palvelimista, jotka on määritetty agentille.

Kun authorizationkaikki -, auth_handler_name- ja turn_context -tunnukset hankitaan kohderyhmäkohtaisille OAuth-tunnuksille löytöjen jälkeen:

• V1-palvelimet (ei audience kenttää) jakavat jaetun ATG-tunnuksen (yksi vaihto).
• Jokainen V2-palvelin saa tunnuksen, joka on rajoitettu heidän oman yleisönsä GUID-tunnuksen mukaan.

async list_tool_servers(agentic_app_id: str, auth_token: str | None = None, options: ToolOptions | None = None, authorization: Authorization | None = None, auth_handler_name: str | None = None, turn_context: TurnContext | None = None) -> List[MCPServerConfig]

Parametrit

Nimi	Description
agentic_app_id Pakollinen	str Agentin asiakassovellustunnus.
auth_token	str | None Yhdyskäytävän etsinnässä käytettävä todennustunnus. Default value: None
options	ToolOptions | None Valinnainen TyökaluAsetukset-esiintymä, joka sisältää valinnaisia parametreja. Default value: None
authorization	Authorization | None Valinnainen valtuutuskonteksti käyttäjäkohtaiselle tunnusten vaihdolle. Default value: None
auth_handler_name	str | None Valinnainen todennuskäsittelijän nimi, jota käytetään :n kanssa authorization. Default value: None
turn_context	TurnContext | None Valinnainen TurnContext, jota käytetään :n kanssa authorization. Default value: None

Palautukset

Tyyppi	Description
List[MCPServerConfig]	Palauttaa määritettyjen MCP-palvelinten luettelon, joihin Authorization jokaiseen on liitetty otsikko todennuskontekstin antaessa.

Poikkeukset

Tyyppi	Description
ValueError	Jos pakolliset parametrit ovat virheellisiä tai tyhjiä.
Exception	Jos työkaluyhdyskäytävän kanssa ilmenee virheviestintä tai käyttäjäkohtainen tunnusten vaihto epäonnistuu.

send_chat_history

Lähettää keskusteluhistorian MCP-ympäristöön reaaliaikaista uhkien suojausta varten.

Muistio

Vaikka chat_history_messages olisi tyhjä, pyyntö lähetetään edelleen kohteeseen

MCP-alustalla. Näin varmistat käyttäjäviestin kohteesta turn_context.activity.text

on rekisteröity oikein reaaliaikaiseen uhkien torjuntaan.

async send_chat_history(turn_context: TurnContext, chat_history_messages: List[ChatHistoryMessage], options: ToolOptions | None = None) -> OperationResult

Parametrit

Nimi	Description
turn_context Pakollinen	TurnContext TurnContext agenttien SDK:lta, joka sisältää tietoa keskustelusta. Kelvollinen toiminto sisältää conversation.id, activity.id ja activity.text-funktion.
chat_history_messages Pakollinen	List[ChatHistoryMessage] Luettelo ChatHistoryMessage-objekteista, jotka edustavat keskusteluhistoriaa. Voi olla tyhjä – tyhjä luettelo lähettää edelleen pyynnön MCP-ympäristöön, jossa on tyhjä keskusteluhistoria.
options	ToolOptions | None Valinnainen TyökaluAsetukset-esiintymä, joka sisältää valinnaisia parametreja. Default value: None

Palautukset

Tyyppi	Description
<xref:OperationResult>	ToimintoTulos, joka ilmaisee onnistumisen tai epäonnistumisen. Kun tulos on onnistunut, palauttaa funktion OperationResult.success(). Virhetilanteessa palauttaa funktion OperationResult.failed(), joka sisältää virhetiedot.

Poikkeukset

Tyyppi	Description
ValueError	Jos turn_context on Ei mitään, chat_history_messages on Ei mitään, turn_context.activity on Ei mitään tai jokin pakollinen kenttä (conversation.id, activity.id, activity.text) puuttuu tai on tyhjä.

Esimerkit

>>> from datetime import datetime, timezone
>>> from microsoft_agents_a365.tooling.models import ChatHistoryMessage
>>>
>>> history = [
...     ChatHistoryMessage("msg-1", "user", "Hello", datetime.now(timezone.utc)),
...     ChatHistoryMessage("msg-2", "assistant", "Hi!", datetime.now(timezone.utc))
... ]
>>>
>>> service = McpToolServerConfigurationService()
>>> result = await service.send_chat_history(turn_context, history)
>>> if result.succeeded:
...     print("Chat history sent successfully")