McpToolRegistrationService Luokka

Tarjoaa MCP-työkalun rekisteröintipalveluja Agent Framework -agenteille.

Tämä palvelu käsittelee MCP (Model Context Protocol) -työkalupalvelimien rekisteröinnin ja hallinnan Agent Framework -agenttien kanssa.

Konstruktori

McpToolRegistrationService()

Parametrit

Nimi	Description
logger	Default value: None

Menetelmät

__init__	Alusta MCP-työkalun rekisteröintipalvelu Agent Frameworkille.
__new__
add_tool_servers_to_agent	LISÄÄ MCP-työkalupalvelimia RawAgent-kohteeseen (peilaa .NET-toteutusta).
cleanup	Tyhjennä kaikki palvelun käyttämät resurssit.
send_chat_history_from_store	Lähetä keskusteluhistoria HistoryProviderista MCP-ympäristöön. Tämä on kätevyysmenetelmä, joka poimii viestit kaupasta ja delegoi send_chat_history_messages().
send_chat_history_messages	Lähetä keskusteluhistoriaviestejä MCP-ympäristöön reaaliaikaista uhkien suojausta varten. Tämä on ensisijainen toteutusmenetelmä, joka käsittelee sanoman muunnoksen ja delegoinnin ydintyökalupalveluun. Muistio Vaikka chat_messages olisi tyhjä tai kaikki sanomat suodatetaan -muunnosta, pyyntö lähetetään silti MCP-ympäristöön. This Varmistaa, että käyttäjäviesti kohteesta turn_context.activity.text on rekisteröity oikeassa todellisten uhkien suojaamisessa.

init

Alusta MCP-työkalun rekisteröintipalvelu Agent Frameworkille.

__init__(logger: Logger | None = None)

Parametrit

Nimi	Description
logger	Logger \| None Lokitoiminnon esiintymä lokitoimintoja varten. Default value: None

new

__new__(**kwargs)

add_tool_servers_to_agent

LISÄÄ MCP-työkalupalvelimia RawAgent-kohteeseen (peilaa .NET-toteutusta).

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

Parametrit

Nimi	Description
chat_client Pakollinen	<xref:OpenAIChatClient> Keskusteluasiakasohjelman esiintymä (OpenAIChatClient tukee sekä OpenAI:tä että Azure OpenAI:tä)
agent_instructions Pakollinen	str Agentin toimintaa koskevat ohjeet
initial_tools Pakollinen	List[object] Luettelo ensimmäisistä työkaluista, jotka lisätään agenttiin
auth Pakollinen	<xref:Authorization> Tunnuksen vaihdon valtuutuskonteksti
auth_handler_name Pakollinen	str Valtuutuskäsittelijän nimi.
turn_context Pakollinen	<xref:TurnContext> Toiminnon kontekstin kääntäminen
auth_token	Optional[str] Valinnainen haltijatunnus todentamista varten Default value: None

Palautukset

Tyyppi	Description
<xref:RawAgent>	RawAgent-esiintymä, jossa MCP-työkalut on rekisteröity.

Poikkeukset

Tyyppi	Description
Exception	Jos agenttien luominen epäonnistuu.

cleanup

Tyhjennä kaikki palvelun käyttämät resurssit.

async cleanup()

send_chat_history_from_store

Lähetä keskusteluhistoria HistoryProviderista MCP-ympäristöön.

Tämä on kätevyysmenetelmä, joka poimii viestit kaupasta ja delegoi send_chat_history_messages().

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

Parametrit

Nimi	Description
chat_message_store Pakollinen	<xref:agent_framework._sessions.HistoryProvider> HistoryProvider, joka sisältää keskusteluhistorian.
turn_context Pakollinen	TurnContext TurnContext agenttien SDK:sta, joka sisältää tietoja keskustelusta.
tool_options	ToolOptions \| None Pyynnön valinnainen määritys. Default value: None

Palautukset

Tyyppi	Description
OperationResult	ToimintoTulos, joka ilmaisee toiminnon onnistumisen tai epäonnistumisen.

Poikkeukset

Tyyppi	Description
ValueError	Jos chat_message_store tai turn_context on Ei mitään.

Esimerkit


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

send_chat_history_messages

Lähetä keskusteluhistoriaviestejä MCP-ympäristöön reaaliaikaista uhkien suojausta varten.

Tämä on ensisijainen toteutusmenetelmä, joka käsittelee sanoman muunnoksen ja delegoinnin ydintyökalupalveluun.

Muistio

Vaikka chat_messages olisi tyhjä tai kaikki sanomat suodatetaan

-muunnosta, pyyntö lähetetään silti MCP-ympäristöön. This

Varmistaa, että käyttäjäviesti kohteesta turn_context.activity.text on rekisteröity

oikeassa todellisten uhkien suojaamisessa.

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

Parametrit

Nimi	Description
chat_messages Pakollinen	Sequence[<xref:agent_framework._types.Message>] Lähetettävien Agenttikehyksen viestien objektien järjestys. Voi olla tyhjä – pyyntö lähetetään edelleen rekisteröimään käyttäjäviesti turn_context.activity.text.
turn_context Pakollinen	TurnContext TurnContext agenttien SDK:sta, joka sisältää tietoja keskustelusta.
tool_options	ToolOptions \| None Pyynnön valinnainen määritys. Oletusasetus on AgentFramework-kohtainen, jos sitä ei ole annettu. Default value: None

Palautukset

Tyyppi	Description
OperationResult	ToimintoTulos, joka ilmaisee toiminnon onnistumisen tai epäonnistumisen.

Poikkeukset

Tyyppi	Description
ValueError	Jos chat_messages tai turn_context on Ei mitään.

Esimerkit


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