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