McpToolRegistrationService Klas

Biedt MCP-hulpprogrammaregistratieservices voor Agent Framework-agents.

Deze service verwerkt de registratie en het beheer van MCP-hulpprogrammaservers (Model Context Protocol) met Agent Framework-agents.

Constructor

McpToolRegistrationService()

Parameters

Name	Description
logger	Default value: None

Methoden

__init__	Initialiseer de MCP Tool Registration Service voor Agent Framework.
__new__
add_tool_servers_to_agent	MCP-hulpprogrammaservers toevoegen aan een RawAgent (mirrors .NET-implementatie).
cleanup	Schoon alle resources op die door de service worden gebruikt.
send_chat_history_from_store	Verzend chatgeschiedenis van een HistoryProvider naar het MCP-platform. Dit is een handige methode waarmee berichten worden geëxtraheerd uit de store en gemachtigden naar send_chat_history_messages().
send_chat_history_messages	Chatgeschiedenisberichten verzenden naar het MCP-platform voor realtime bedreigingsbeveiliging. Dit is de primaire implementatiemethode voor het verwerken van berichtconversie en overdracht naar de belangrijkste toolingservice. Note Zelfs als chat_messages leeg is of alle berichten worden gefilterd tijdens conversie, de aanvraag wordt nog steeds verzonden naar het MCP-platform. Dit zorgt ervoor dat het gebruikersbericht van turn_context.activity.text is geregistreerd correct voor realtime bedreigingsbeveiliging.

init

Initialiseer de MCP Tool Registration Service voor Agent Framework.

__init__(logger: Logger | None = None)

Parameters

Name	Description
logger	Logger \| None Logboekregistratie-exemplaar voor logboekregistratiebewerkingen. Default value: None

new

__new__(**kwargs)

add_tool_servers_to_agent

MCP-hulpprogrammaservers toevoegen aan een RawAgent (mirrors .NET-implementatie).

async add_tool_servers_to_agent(chat_client: OpenAIChatClient, agent_instructions: str, initial_tools: List[object], auth: Authorization, auth_handler_name: str, turn_context: TurnContext, auth_token: str | None = None) -> RawAgent

Parameters

Name	Description
chat_client Vereist	<xref:OpenAIChatClient> Het chatclientexemplaren (OpenAIChatClient ondersteunt zowel OpenAI als Azure OpenAI)
agent_instructions Vereist	str Instructies voor het gedrag van de agent
initial_tools Vereist	List[object] Lijst met initiële hulpprogramma's die u aan de agent wilt toevoegen
auth Vereist	<xref:Authorization> Autorisatiecontext voor tokenuitwisseling
auth_handler_name Vereist	str Naam van de autorisatiehandler.
turn_context Vereist	<xref:TurnContext> Context draaien voor de bewerking
auth_token	Optional[str] Optioneel bearer-token voor verificatie Default value: None

Retouren

Type	Description
<xref:RawAgent>	RawAgent-exemplaar met MCP-hulpprogramma's geregistreerd.

Uitzonderingen

Type	Description
Exception	Als het maken van een agent mislukt.

cleanup

Schoon alle resources op die door de service worden gebruikt.

async cleanup()

send_chat_history_from_store

Verzend chatgeschiedenis van een HistoryProvider naar het MCP-platform.

Dit is een handige methode waarmee berichten worden geëxtraheerd uit de store en gemachtigden naar send_chat_history_messages().

async send_chat_history_from_store(chat_message_store: HistoryProvider, turn_context: TurnContext, tool_options: ToolOptions | None = None) -> OperationResult

Parameters

Name	Description
chat_message_store Vereist	<xref:agent_framework._sessions.HistoryProvider> HistoryProvider met de gespreksgeschiedenis.
turn_context Vereist	TurnContext TurnContext van de Agents SDK met gespreksgegevens.
tool_options	ToolOptions \| None Optionele configuratie voor de aanvraag. Default value: None

Retouren

Type	Description
OperationResult	OperationResult geeft aan dat de bewerking is geslaagd of mislukt.

Uitzonderingen

Type	Description
ValueError	Als chat_message_store of turn_context geen is.

Voorbeelden


>>> service = McpToolRegistrationService()
>>> result = await service.send_chat_history_from_store(
...     thread.chat_message_store, turn_context
... )

send_chat_history_messages

Chatgeschiedenisberichten verzenden naar het MCP-platform voor realtime bedreigingsbeveiliging.

Dit is de primaire implementatiemethode voor het verwerken van berichtconversie en overdracht naar de belangrijkste toolingservice.

Note

Zelfs als chat_messages leeg is of alle berichten worden gefilterd tijdens

conversie, de aanvraag wordt nog steeds verzonden naar het MCP-platform. Dit

zorgt ervoor dat het gebruikersbericht van turn_context.activity.text is geregistreerd

correct voor realtime bedreigingsbeveiliging.

async send_chat_history_messages(chat_messages: Sequence[Message], turn_context: TurnContext, tool_options: ToolOptions | None = None) -> OperationResult

Parameters

Name	Description
chat_messages Vereist	Sequence[<xref:agent_framework._types.Message>] Volgorde van Agent Framework Message-objecten die moeten worden verzonden. Kan leeg zijn: de aanvraag wordt nog steeds verzonden om het gebruikersbericht van turn_context.activity.text te registreren.
turn_context Vereist	TurnContext TurnContext van de Agents SDK met gespreksgegevens.
tool_options	ToolOptions \| None Optionele configuratie voor de aanvraag. Standaard ingesteld op AgentFramework-specifieke opties als deze niet zijn opgegeven. Default value: None

Retouren

Type	Description
OperationResult	OperationResult geeft aan dat de bewerking is geslaagd of mislukt.

Uitzonderingen

Type	Description
ValueError	Als chat_messages of turn_context geen is.

Voorbeelden


>>> service = McpToolRegistrationService()
>>> messages = [Message(role="user", text="Hello")]
>>> result = await service.send_chat_history_messages(messages, turn_context)
>>> if result.succeeded:
...     print("Chat history sent successfully")