McpToolServerConfigurationService Klas

Biedt services voor configuratiebeheer van MCP-hulpprogrammaservers.

Deze service verwerkt detectie en configuratie van MCP-hulpprogrammaservers (Model Context Protocol) uit meerdere bronnen:

• Ontwikkeling: Lokale ToolingManifest.json-bestanden
• Productie: Gateway-eindpunten voor externe hulpprogramma's

Constructor

McpToolServerConfigurationService()

Parameters

Name	Description
logger	Default value: None

Methoden

__init__	Initialiseer de CONFIGURATIEservice van de MCP-hulpprogrammaserver.
__new__
list_tool_servers	Hiermee haalt u de lijst met MCP-servers op die zijn geconfigureerd voor de agent. Wanneer authorization, auth_handler_nameen turn_context worden allemaal opgegeven, worden OAuth-tokens per doelgroep verkregen voor elke server na detectie: V1-servers (geen audience veld) delen het gedeelde ATG-token (één exchange). V2-servers ontvangen elk een tokenbereik dat is afgestemd op hun eigen doelgroep-GUID.
send_chat_history	Hiermee wordt chatgeschiedenis verzonden naar het MCP-platform voor realtime bedreigingsbeveiliging. Note Zelfs als chat_history_messages leeg is, wordt de aanvraag nog steeds verzonden naar het MCP-platform. Dit zorgt ervoor dat het gebruikersbericht van turn_context.activity.text is correct geregistreerd voor realtime bedreigingsbeveiliging.

__init__

Initialiseer de CONFIGURATIEservice van de MCP-hulpprogrammaserver.

__init__(logger: Logger | None = None)

Parameters

Name	Description
logger	Logger | None Logboekregistratie-exemplaar voor logboekregistratiebewerkingen. Als geen, maakt u een nieuwe logger. Default value: None

__new__

__new__(**kwargs)

list_tool_servers

Hiermee haalt u de lijst met MCP-servers op die zijn geconfigureerd voor de agent.

Wanneer authorization, auth_handler_nameen turn_context worden allemaal opgegeven, worden OAuth-tokens per doelgroep verkregen voor elke server na detectie:

• V1-servers (geen audience veld) delen het gedeelde ATG-token (één exchange).
• V2-servers ontvangen elk een tokenbereik dat is afgestemd op hun eigen doelgroep-GUID.

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]

Parameters

Name	Description
agentic_app_id Vereist	str Agentische app-id voor de agent.
auth_token	str | None Verificatietoken dat wordt gebruikt voor gatewaydetectie. Default value: None
options	ToolOptions | None Optioneel ToolOptions-exemplaar met optionele parameters. Default value: None
authorization	Authorization | None Optionele autorisatiecontext voor tokenuitwisseling per doelgroep. Default value: None
auth_handler_name	str | None Optionele naam van verificatiehandler gebruikt met authorization. Default value: None
turn_context	TurnContext | None Optioneel TurnContext gebruikt met authorization. Default value: None

Retouren

Type	Description
List[MCPServerConfig]	Retourneert de lijst met MCP-servers die zijn geconfigureerd, elk met een Authorization header die is gekoppeld wanneer de verificatiecontext wordt opgegeven.

Uitzonderingen

Type	Description
ValueError	Als de vereiste parameters ongeldig of leeg zijn.
Exception	Als er een fout optreedt bij het communiceren met de tooling-gateway of een tokenuitwisseling per doelgroep mislukt.

send_chat_history

Hiermee wordt chatgeschiedenis verzonden naar het MCP-platform voor realtime bedreigingsbeveiliging.

Note

Zelfs als chat_history_messages leeg is, wordt de aanvraag nog steeds verzonden naar

het MCP-platform. Dit zorgt ervoor dat het gebruikersbericht van turn_context.activity.text

is correct geregistreerd voor realtime bedreigingsbeveiliging.

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

Parameters

Name	Description
turn_context Vereist	TurnContext TurnContext van de Agents SDK met gespreksgegevens. Moet een geldige activiteit hebben met conversation.id, activity.id en activity.text.
chat_history_messages Vereist	List[ChatHistoryMessage] Lijst met ChatHistoryMessage-objecten die de chatgeschiedenis vertegenwoordigen. Kan leeg zijn: een lege lijst verzendt nog steeds een aanvraag naar het MCP-platform met een lege chatgeschiedenis.
options	ToolOptions | None Optioneel ToolOptions-exemplaar met optionele parameters. Default value: None

Retouren

Type	Description
<xref:OperationResult>	Een OperationResult die aangeeft dat de bewerking is geslaagd of mislukt. Bij succes wordt OperationResult.success() geretourneerd. Bij een fout retourneert OperationResult.failed() met foutdetails.

Uitzonderingen

Type	Description
ValueError	Als turn_context Geen is, ontbreekt chat_history_messages, turn_context.activity geen of een van de vereiste velden (conversation.id, activity.id, activity.text) ontbreekt of leeg.

Voorbeelden

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