McpToolRegistrationService Klasse

Leverer MCP-verktøyregistreringstjenester for Agent Framework-agenter.

Denne tjenesten håndterer registrering og administrasjon av MCP-verktøyservere (Model Context Protocol) med Agent Framework-agenter.

Konstruktør

McpToolRegistrationService()

Parametere

Navn	Beskrivelse
logger	Default value: None

Metoder

__init__	Initialiser MCP Tool Registration Service for Agent Framework.
__new__
add_tool_servers_to_agent	Legg til MCP-verktøyservere i en RawAgent (speil .NET-implementering).
cleanup	Rydd opp i alle ressurser som brukes av tjenesten.
send_chat_history_from_store	Send chattelogg fra en HistoryProvider til MCP-plattformen. Dette er en praktisk metode som trekker ut meldinger fra butikken og representanter for å send_chat_history_messages().
send_chat_history_messages	Send chatloggmeldinger til MCP-plattformen for trusselbeskyttelse i sanntid. Dette er den primære implementeringsmetoden som håndterer meldingskonvertering og delegering til kjerneverktøytjenesten. Bemerkning Selv om chat_messages er tom eller alle meldinger filtreres under konvertering, vil forespørselen fortsatt bli sendt til MCP-plattformen. Dermed sikrer at brukermeldingen fra turn_context.activity.text er registrert riktig for trusselbeskyttelse i sanntid.

init

Initialiser MCP Tool Registration Service for Agent Framework.

__init__(logger: Logger | None = None)

Parametere

Navn	Beskrivelse
logger	Logger \| None Loggerforekomst for loggingsoperasjoner. Default value: None

new

__new__(**kwargs)

add_tool_servers_to_agent

Legg til MCP-verktøyservere i en RawAgent (speil .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

Parametere

Navn	Beskrivelse
chat_client Obligatorisk	<xref:OpenAIChatClient> Chatklientforekomsten (OpenAIChatClient støtter både OpenAI og Azure OpenAI)
agent_instructions Obligatorisk	str Instruksjoner for agentvirkemåten
initial_tools Obligatorisk	List[object] Liste over innledende verktøy som skal legges til agenten
auth Obligatorisk	<xref:Authorization> Godkjenningskontekst for tokenutveksling
auth_handler_name Obligatorisk	str Navnet på godkjenningsbehandlingen.
turn_context Obligatorisk	<xref:TurnContext> Slå kontekst for operasjonen
auth_token	Optional[str] Valgfritt bærertoken for godkjenning Default value: None

Returnerer

Type	Beskrivelse
<xref:RawAgent>	RawAgent-forekomst med MCP-verktøy registrert.

Unntak

Type	Beskrivelse
Exception	Hvis oppretting av agent mislykkes.

cleanup

Rydd opp i alle ressurser som brukes av tjenesten.

async cleanup()

send_chat_history_from_store

Send chattelogg fra en HistoryProvider til MCP-plattformen.

Dette er en praktisk metode som trekker ut meldinger fra butikken og representanter for å send_chat_history_messages().

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

Parametere

Navn	Beskrivelse
chat_message_store Obligatorisk	<xref:agent_framework._sessions.HistoryProvider> HistoryProvider som inneholder samtaleloggen.
turn_context Obligatorisk	TurnContext TurnContext fra Agents SDK som inneholder samtaleinformasjon.
tool_options	ToolOptions \| None Valgfri konfigurasjon for forespørselen. Default value: None

Returnerer

Type	Beskrivelse
OperationResult	OperationResult angir vellykket eller mislykket operasjon.

Unntak

Type	Beskrivelse
ValueError	Hvis chat_message_store eller turn_context er Ingen.

Eksempler


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

send_chat_history_messages

Send chatloggmeldinger til MCP-plattformen for trusselbeskyttelse i sanntid.

Dette er den primære implementeringsmetoden som håndterer meldingskonvertering og delegering til kjerneverktøytjenesten.

Bemerkning

Selv om chat_messages er tom eller alle meldinger filtreres under

konvertering, vil forespørselen fortsatt bli sendt til MCP-plattformen. Dermed

sikrer at brukermeldingen fra turn_context.activity.text er registrert

riktig for trusselbeskyttelse i sanntid.

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

Parametere

Navn	Beskrivelse
chat_messages Obligatorisk	Sequence[<xref:agent_framework._types.Message>] Sekvens av Agent Framework-meldingsobjekter som skal sendes. Kan være tom – forespørselen sendes fremdeles for å registrere brukermeldingen fra turn_context.activity.text.
turn_context Obligatorisk	TurnContext TurnContext fra Agents SDK som inneholder samtaleinformasjon.
tool_options	ToolOptions \| None Valgfri konfigurasjon for forespørselen. Standarder som agentFramework-spesifikke alternativer hvis de ikke er angitt. Default value: None

Returnerer

Type	Beskrivelse
OperationResult	OperationResult angir vellykket eller mislykket operasjon.

Unntak

Type	Beskrivelse
ValueError	Hvis chat_messages eller turn_context er Ingen.

Eksempler


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