McpToolRegistrationService Třída

Poskytuje registrační služby nástroje MCP pro agenty Agent Framework.

Tato služba zpracovává registraci a správu serverů nástrojů MCP (Model Context Protocol) pomocí agentů Agent Framework.

Konstruktor

McpToolRegistrationService()

Parametry

Name	Description
logger	Default value: None

Metody

__init__	Inicializace služby registrace nástrojů MCP pro architekturu agenta
__new__
add_tool_servers_to_agent	Přidejte servery nástrojů MCP do RawAgentu (zrcadlí implementaci .NET).
cleanup	Vyčistěte všechny prostředky používané službou.
send_chat_history_from_store	Odeslání historie chatu z HistoryProvideru na platformu MCP Jedná se o metodu pohodlí, která extrahuje zprávy ze storu a delegáty na send_chat_history_messages().
send_chat_history_messages	Zasílání zpráv historie chatu na platformu MCP pro ochranu před hrozbami v reálném čase Toto je primární metoda implementace, která zpracovává převod zpráv a delegování do základní služby nástrojů. Note I v případě, že je chat_messages prázdné nebo se během období filtrování vyfiltrují všechny zprávy požadavek se stále odešle na platformu MCP. Toto zajišťuje registraci zprávy uživatele z turn_context.activity.text. pro ochranu před hrozbami v reálném čase.

init

Inicializace služby registrace nástrojů MCP pro architekturu agenta

__init__(logger: Logger | None = None)

Parametry

Name	Description
logger	Logger \| None Instance protokolovacího modulu pro operace protokolování. Default value: None

new

__new__(**kwargs)

add_tool_servers_to_agent

Přidejte servery nástrojů MCP do RawAgentu (zrcadlí implementaci .NET).

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

Parametry

Name	Description
chat_client Vyžadováno	<xref:OpenAIChatClient> Instance chatovacího klienta (OpenAIChatClient podporuje OpenAI i Azure OpenAI)
agent_instructions Vyžadováno	str Pokyny pro chování agenta
initial_tools Vyžadováno	List[object] Seznam počátečních nástrojů pro přidání do agenta
auth Vyžadováno	<xref:Authorization> Kontext autorizace pro výměnu tokenů
auth_handler_name Vyžadováno	str Název obslužné rutiny autorizace
turn_context Vyžadováno	<xref:TurnContext> Turn context for the operation
auth_token	Optional[str] Volitelný nosný token pro ověřování Default value: None

Návraty

Typ	Description
<xref:RawAgent>	Instance RawAgent s registrovanými nástroji MCP

Výjimky

Typ	Description
Exception	Pokud se vytvoření agenta nezdaří.

cleanup

Vyčistěte všechny prostředky používané službou.

async cleanup()

send_chat_history_from_store

Odeslání historie chatu z HistoryProvideru na platformu MCP

Jedná se o metodu pohodlí, která extrahuje zprávy ze storu a delegáty na send_chat_history_messages().

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

Parametry

Name	Description
chat_message_store Vyžadováno	<xref:agent_framework._sessions.HistoryProvider> HistoryProvider obsahující historii konverzací.
turn_context Vyžadováno	TurnContext TurnContext ze sady Sdk agentů obsahující informace o konverzaci
tool_options	ToolOptions \| None Volitelná konfigurace požadavku. Default value: None

Návraty

Typ	Description
OperationResult	OperationResult označující úspěch nebo selhání operace.

Výjimky

Typ	Description
ValueError	Pokud chat_message_store nebo turn_context není žádná.

Příklady


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

send_chat_history_messages

Zasílání zpráv historie chatu na platformu MCP pro ochranu před hrozbami v reálném čase

Toto je primární metoda implementace, která zpracovává převod zpráv a delegování do základní služby nástrojů.

Note

I v případě, že je chat_messages prázdné nebo se během období filtrování vyfiltrují všechny zprávy

požadavek se stále odešle na platformu MCP. Toto

zajišťuje registraci zprávy uživatele z turn_context.activity.text.

pro ochranu před hrozbami v reálném čase.

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

Parametry

Name	Description
chat_messages Vyžadováno	Sequence[<xref:agent_framework._types.Message>] Posloupnost objektů zpráv rozhraní agenta, které se mají odeslat Může být prázdný – požadavek se odešle, aby se zpráva uživatele zaregistrovala z turn_context.activity.text.
turn_context Vyžadováno	TurnContext TurnContext ze sady Sdk agentů obsahující informace o konverzaci
tool_options	ToolOptions \| None Volitelná konfigurace požadavku. Pokud nejsou k dispozici, nastaví se výchozí možnosti specifické pro AgentFramework. Default value: None

Návraty

Typ	Description
OperationResult	OperationResult označující úspěch nebo selhání operace.

Výjimky

Typ	Description
ValueError	Pokud chat_messages nebo turn_context není žádná.

Příklady


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