McpToolServerConfigurationService Klasse

Leverer tjenester til konfigurationsstyring af MCP-værktøjsserver.

Denne tjeneste håndterer registrering og konfiguration af MCP-værktøjsservere (Model Context Protocol) fra flere kilder:

  • Udvikling: Lokale ToolingManifest.json-filer
  • Produktion: Slutpunkter for fjernværktøjsgateway

Konstruktør

McpToolServerConfigurationService()

Parametre

Name Beskrivelse
logger
Default value: None

Metoder

__init__

Initialiser konfigurationstjenesten til MCP Tool Server.
__new__
list_tool_servers

Henter listen over MCP-servere, der er konfigureret for agenten.

Når authorization, auth_handler_nameog turn_context alle er angivet, hentes OAuth-tokens pr. målgruppe for hver server efter registrering:

  • V1-servere (intet audience felt) deler det delte ATG-token (én udveksling).
  • V2-servere modtager hver især et token, der er begrænset til deres eget målgruppe-GUID.
send_chat_history

Sender chathistorik til MCP-platformen for at beskytte trusler i realtid.

Bemærkning

Selvom chat_history_messages er tom, sendes anmodningen stadig til

mcp-platformen. Dette sikrer, at brugermeddelelsen fra turn_context.activity.text

er registreret korrekt til trusselsbeskyttelse i realtid.

__init__

Initialiser konfigurationstjenesten til MCP Tool Server.

__init__(logger: Logger | None = None)

Parametre

Name Beskrivelse
logger
Logger | None

Logføringsforekomst for logføringshandlinger. Hvis Ingen, oprettes der en ny logføring.

Default value: None

__new__ 

__new__(**kwargs)

list_tool_servers

Henter listen over MCP-servere, der er konfigureret for agenten.

Når authorization, auth_handler_nameog turn_context alle er angivet, hentes OAuth-tokens pr. målgruppe for hver server efter registrering:

  • V1-servere (intet audience felt) deler det delte ATG-token (én udveksling).
  • V2-servere modtager hver især et token, der er begrænset til deres eget målgruppe-GUID.
async list_tool_servers(agentic_app_id: str, auth_token: str | None = None, options: ToolOptions | None = None, authorization: Authorization | None = None, auth_handler_name: str | None = None, turn_context: TurnContext | None = None) -> List[MCPServerConfig]

Parametre

Name Beskrivelse
agentic_app_id
Påkrævet
str

Agentisk app-id for agenten.
auth_token
str | None

Godkendelsestoken, der bruges til registrering af gateway.

Default value: None
options
ToolOptions | None

Valgfri forekomst af ToolOptions, der indeholder valgfri parametre.

Default value: None
authorization
Authorization | None

Valgfri godkendelseskontekst for tokenudveksling pr. målgruppe.

Default value: None
auth_handler_name
str | None

Valgfrit godkendelseshandlernavn, der bruges sammen med authorization.

Default value: None
turn_context
TurnContext | None

Valgfri TurnContext, der bruges sammen med authorization.

Default value: None

Returnerer

Type Beskrivelse
List[MCPServerConfig]

Returnerer listen over MCP-servere, der er konfigureret, hver med en Authorization tilknyttet header, når godkendelseskonteksten angives.

Undtagelser

Type Beskrivelse
ValueError

Hvis de påkrævede parametre er ugyldige eller tomme.
Exception

Hvis der er en fejl under kommunikation med værktøjsgatewayen eller en udveksling af token pr. målgruppe mislykkes.

send_chat_history

Sender chathistorik til MCP-platformen for at beskytte trusler i realtid.

Bemærkning

Selvom chat_history_messages er tom, sendes anmodningen stadig til

mcp-platformen. Dette sikrer, at brugermeddelelsen fra turn_context.activity.text

er registreret korrekt til trusselsbeskyttelse i realtid.

async send_chat_history(turn_context: TurnContext, chat_history_messages: List[ChatHistoryMessage], options: ToolOptions | None = None) -> OperationResult

Parametre

Name Beskrivelse
turn_context
Påkrævet
TurnContext

TurnContext fra Agents SDK, der indeholder samtaleoplysninger. Skal have en gyldig aktivitet med conversation.id, activity.id og activity.text.
chat_history_messages
Påkrævet
List[ChatHistoryMessage]

Liste over ChatHistoryMessage-objekter, der repræsenterer chathistorikken. Kan være tom – en tom liste sender stadig en anmodning til MCP-platformen med tom chathistorik.
options
ToolOptions | None

Valgfri forekomst af ToolOptions, der indeholder valgfri parametre.

Default value: None

Returnerer

Type Beskrivelse
<xref:OperationResult>

En OperationResult, der angiver, om det lykkedes eller mislykkedes. Returnerer OperationResult.success() ved vellykket handling. Ved fejl returneres OperationResult.failed() med oplysninger om fejl.

Undtagelser

Type Beskrivelse
ValueError

Hvis turn_context er None, er chat_history_messages None, turn_context.activity is None, eller nogle af de obligatoriske felter (conversation.id, activity.id, activity.text) mangler eller er tomme.

Eksempler


>>> from datetime import datetime, timezone
>>> from microsoft_agents_a365.tooling.models import ChatHistoryMessage
>>>
>>> history = [
...     ChatHistoryMessage("msg-1", "user", "Hello", datetime.now(timezone.utc)),
...     ChatHistoryMessage("msg-2", "assistant", "Hi!", datetime.now(timezone.utc))
... ]
>>>
>>> service = McpToolServerConfigurationService()
>>> result = await service.send_chat_history(turn_context, history)
>>> if result.succeeded:
...     print("Chat history sent successfully")