McpToolRegistrationService Klass

Tillhandahåller MCP-verktygsregistreringstjänster för Agent Framework-agenter.

Den här tjänsten hanterar registrering och hantering av MCP-verktygsservrar (Model Context Protocol) med Agent Framework-agenter.

Konstruktor

McpToolRegistrationService()

Parametrar

Name	Description
logger	Standardvärde: None

Metoder

__init__	Initiera registreringstjänsten för MCP-verktyget för Agent Framework.
__new__
add_tool_servers_to_agent	Lägg till MCP-verktygsservrar i en RawAgent (speglar .NET-implementering).
cleanup	Rensa alla resurser som används av tjänsten.
send_chat_history_from_store	Skicka chatthistorik från en HistoryProvider till MCP-plattformen. Det här är en bekvämlighetsmetod som extraherar meddelanden från arkivet och delegerar till send_chat_history_messages().
send_chat_history_messages	Skicka chatthistorikmeddelanden till MCP-plattformen för skydd mot hot i realtid. Det här är den primära implementeringsmetoden som hanterar meddelandekonvertering och delegering till kärnverktygstjänsten. Note Även om chat_messages är tom eller om alla meddelanden filtreras under kommer begäran fortfarande att skickas till MCP-plattformen. Denna ser till att användarmeddelandet från turn_context.activity.text är registrerat korrekt för skydd mot hot i realtid.

init

Initiera registreringstjänsten för MCP-verktyget för Agent Framework.

__init__(logger: Logger | None = None)

Parametrar

Name	Description
logger	Logger \| None Loggningsinstans för loggningsåtgärder. Standardvärde: None

new

__new__(**kwargs)

add_tool_servers_to_agent

Lägg till MCP-verktygsservrar i en RawAgent (speglar .NET-implementering).

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

Parametrar

Name	Description
chat_client Obligatorisk	<xref:OpenAIChatClient> Chattklientinstansen (OpenAIChatClient stöder både OpenAI och Azure OpenAI)
agent_instructions Obligatorisk	str Instruktioner för agentbeteendet
initial_tools Obligatorisk	List[object] Lista över de första verktyg som ska läggas till i agenten
auth Obligatorisk	<xref:Authorization> Auktoriseringskontext för tokenutbyte
auth_handler_name Obligatorisk	str Namnet på auktoriseringshanteraren.
turn_context Obligatorisk	<xref:TurnContext> Aktivera kontext för åtgärden
auth_token	Optional[str] Valfri ägartoken för autentisering Standardvärde: None

Returer

Typ	Description
<xref:RawAgent>	RawAgent-instans med MCP-verktyg registrerade.

Undantag

Typ	Description
Exception	Om det inte går att skapa agenten.

cleanup

Rensa alla resurser som används av tjänsten.

async cleanup()

send_chat_history_from_store

Skicka chatthistorik från en HistoryProvider till MCP-plattformen.

Det här är en bekvämlighetsmetod som extraherar meddelanden från arkivet och delegerar till send_chat_history_messages().

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

Parametrar

Name	Description
chat_message_store Obligatorisk	<xref:agent_framework._sessions.HistoryProvider> HistoryProvider som innehåller konversationshistoriken.
turn_context Obligatorisk	TurnContext TurnContext från Agents SDK som innehåller konversationsinformation.
tool_options	ToolOptions \| None Valfri konfiguration för begäran. Standardvärde: None

Returer

Typ	Description
OperationResult	OperationResult anger att åtgärden lyckades eller misslyckades.

Undantag

Typ	Description
ValueError	Om chat_message_store eller turn_context är Ingen.

Exempel


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

send_chat_history_messages

Skicka chatthistorikmeddelanden till MCP-plattformen för skydd mot hot i realtid.

Det här är den primära implementeringsmetoden som hanterar meddelandekonvertering och delegering till kärnverktygstjänsten.

Note

Även om chat_messages är tom eller om alla meddelanden filtreras under

kommer begäran fortfarande att skickas till MCP-plattformen. Denna

ser till att användarmeddelandet från turn_context.activity.text är registrerat

korrekt för skydd mot hot i realtid.

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

Parametrar

Name	Description
chat_messages Obligatorisk	Sequence[<xref:agent_framework._types.Message>] Sekvens av Agent Framework-meddelandeobjekt som ska skickas. Kan vara tom – begäran skickas fortfarande för att registrera användarmeddelandet från turn_context.activity.text.
turn_context Obligatorisk	TurnContext TurnContext från Agents SDK som innehåller konversationsinformation.
tool_options	ToolOptions \| None Valfri konfiguration för begäran. Standardinställningen är AgentFramework-specifika alternativ om de inte tillhandahålls. Standardvärde: None

Returer

Typ	Description
OperationResult	OperationResult anger att åtgärden lyckades eller misslyckades.

Undantag

Typ	Description
ValueError	Om chat_messages eller turn_context är Ingen.

Exempel


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