McpToolServerConfigurationService class

Pakke:

@microsoft/agents-a365-tooling

Tjeneste som er ansvarlig for å oppdage og normalisere MCP-verktøyservere (Model Context Protocol) og produsere konfigurasjonsobjekter som kan brukes av Claude SDK.

Konstruktører

McpToolServerConfigurationService(IConfigurationProvider<ToolingConfiguration>)

Konstruer en McpToolServerConfigurationService.

Metoder

getMcpClientTools(string, MCPServerConfig)	Koble til MCP-serveren, og returner verktøy med navn som er prefikset med servernavnet. Kaster hvis url-adressen for serveren mangler, eller klienten ikke klarer å liste opp verktøy.
listToolServers(string, string)	Returner MCP-serverdefinisjoner for den angitte agenten. Under utvikling (NODE_ENV=Utvikling) leser dette det lokale ToolingManifest.json; Ellers spør den eksterne verktøygatewayen.
listToolServers(string, string, ToolOptions)	Returner MCP-serverdefinisjoner for den angitte agenten. Under utvikling (NODE_ENV=Utvikling) leser dette det lokale ToolingManifest.json; Ellers spør den eksterne verktøygatewayen.
listToolServers(TurnContext, Authorization, string, string, ToolOptions)	Returner MCP-serverdefinisjoner for den angitte agenten. Under utvikling (NODE_ENV=Utvikling) leser dette det lokale ToolingManifest.json; Ellers spør den eksterne verktøygatewayen. Denne overbelastningen løser agenticAppId automatisk fra TurnContext og genererer godkjenningstokenet hvis det ikke er angitt.
sendChatHistory(TurnContext, ChatHistoryMessage[])	Sender chatteloggen til MCP-plattformen for trusselbeskyttelse i sanntid.
sendChatHistory(TurnContext, ChatHistoryMessage[], ToolOptions)	Sender chatteloggen til MCP-plattformen for trusselbeskyttelse i sanntid.

Konstruktørdetaljer

McpToolServerConfigurationService(IConfigurationProvider<ToolingConfiguration>)

Konstruer en McpToolServerConfigurationService.

new McpToolServerConfigurationService(configProvider?: IConfigurationProvider<ToolingConfiguration>)

Parametere

configProvider

IConfigurationProvider<ToolingConfiguration>

Valgfri konfigurasjonsleverandør. Standarder til defaultToolingConfigurationProvider hvis det ikke er angitt.

Metodedetaljer

getMcpClientTools(string, MCPServerConfig)

Koble til MCP-serveren, og returner verktøy med navn som er prefikset med servernavnet. Kaster hvis url-adressen for serveren mangler, eller klienten ikke klarer å liste opp verktøy.

function getMcpClientTools(mcpServerName: string, mcpServerConfig: MCPServerConfig): Promise<McpClientTool[]>

Parametere

mcpServerName

string

mcpServerConfig

MCPServerConfig

Returnerer

Promise<McpClientTool[]>

listToolServers(string, string)

Advarsel

Denne API-en er nå avskrevet.

Use the overload with TurnContext and Authorization parameters instead to enable x-ms-agentid header support and automatic token generation.

Returner MCP-serverdefinisjoner for den angitte agenten. Under utvikling (NODE_ENV=Utvikling) leser dette det lokale ToolingManifest.json; Ellers spør den eksterne verktøygatewayen.

function listToolServers(agenticAppId: string, authToken: string): Promise<MCPServerConfig[]>

Parametere

agenticAppId

string

Den agentiske app-ID-en du kan finne servere for.

authToken

string

Bærertoken som brukes når du spør den eksterne verktøygatewayen.

Returnerer

Promise<MCPServerConfig[]>

Et løfte om å løse til en rekke normaliserte MCP-serverkonfigurasjonsobjekter.

listToolServers(string, string, ToolOptions)

Advarsel

Denne API-en er nå avskrevet.

Use the overload with TurnContext and Authorization parameters instead to enable x-ms-agentid header support and automatic token generation.

Returner MCP-serverdefinisjoner for den angitte agenten. Under utvikling (NODE_ENV=Utvikling) leser dette det lokale ToolingManifest.json; Ellers spør den eksterne verktøygatewayen.

function listToolServers(agenticAppId: string, authToken: string, options?: ToolOptions): Promise<MCPServerConfig[]>

Parametere

agenticAppId

string

Den agentiske app-ID-en du kan finne servere for.

authToken

string

Bærertoken som brukes når du spør den eksterne verktøygatewayen.

options

ToolOptions

Valgfrie verktøyalternativer når du ringer gatewayen.

Returnerer

Promise<MCPServerConfig[]>

Et løfte om å løse til en rekke normaliserte MCP-serverkonfigurasjonsobjekter.

listToolServers(TurnContext, Authorization, string, string, ToolOptions)

Returner MCP-serverdefinisjoner for den angitte agenten. Under utvikling (NODE_ENV=Utvikling) leser dette det lokale ToolingManifest.json; Ellers spør den eksterne verktøygatewayen. Denne overbelastningen løser agenticAppId automatisk fra TurnContext og genererer godkjenningstokenet hvis det ikke er angitt.

function listToolServers(turnContext: TurnContext, authorization: Authorization, authHandlerName: string, authToken?: string, options?: ToolOptions): Promise<MCPServerConfig[]>

Parametere

turnContext

TurnContext

TurnContext for gjeldende forespørsel.

authorization

Authorization

Autorisasjonsobjekt for tokenutveksling.

authHandlerName

string

Navnet på godkjenningsbehandlingen som skal brukes for tokenutveksling.

authToken

string

Valgfritt bærertoken. Hvis ikke angitt, genereres automatisk via tokenutveksling.

options

ToolOptions

Valgfrie verktøyalternativer når du ringer gatewayen.

Returnerer

Promise<MCPServerConfig[]>

Et løfte om å løse til en rekke normaliserte MCP-serverkonfigurasjonsobjekter.

sendChatHistory(TurnContext, ChatHistoryMessage[])

Sender chatteloggen til MCP-plattformen for trusselbeskyttelse i sanntid.

function sendChatHistory(turnContext: TurnContext, chatHistoryMessages: ChatHistoryMessage[]): Promise<OperationResult>

Parametere

turnContext

TurnContext

Svingkonteksten som inneholder samtaleinformasjon.

chatHistoryMessages

ChatHistoryMessage[]

Chatloggmeldingene som skal sendes.

Returnerer

Promise<OperationResult>

Et løfte som løses til en OperationResult som angir vellykket eller mislykket.

Merknader

HTTP-unntak (nettverksfeil, tidsavbrudd) fanges opp og logges, men blir ikke funnet på nytt. I stedet returnerer metoden en OperationResult som angir om operasjonen var vellykket eller mislykket. Innringere kan velge å undersøke resultatet for feilbehandling eller ignorere det hvis det ikke er behov for feildetaljer.

sendChatHistory(TurnContext, ChatHistoryMessage[], ToolOptions)

Sender chatteloggen til MCP-plattformen for trusselbeskyttelse i sanntid.

function sendChatHistory(turnContext: TurnContext, chatHistoryMessages: ChatHistoryMessage[], options?: ToolOptions): Promise<OperationResult>

Parametere

turnContext

TurnContext

Svingkonteksten som inneholder samtaleinformasjon.

chatHistoryMessages

ChatHistoryMessage[]

Chatloggmeldingene som skal sendes.

options

ToolOptions

Valgfrie verktøyalternativer for å sende chattelogg.

Returnerer

Promise<OperationResult>

Et løfte som løses til en OperationResult som angir vellykket eller mislykket.

Merknader

HTTP-unntak (nettverksfeil, tidsavbrudd) fanges opp og logges, men blir ikke funnet på nytt. I stedet returnerer metoden en OperationResult som angir om operasjonen var vellykket eller mislykket. Innringere kan velge å undersøke resultatet for feilbehandling eller ignorere det hvis det ikke er behov for feildetaljer.