McpToolServerConfigurationService class
Servizio responsabile dell'individuazione e della normalizzazione dei server degli strumenti MCP (Model Context Protocol) e della produzione di oggetti di configurazione utilizzabili da Claude SDK.
Costruttori
| Mcp |
Costruire un McpToolServerConfigurationService. |
Metodi
| get |
Connettersi al server MCP e restituire strumenti con nomi preceduti dal nome del server. Genera un'eccezione se l'URL del server è mancante o il client non riesce ad elencare gli strumenti. |
| list |
Restituisce le definizioni del server MCP per l'agente specificato. In fase di sviluppo (NODE_ENV=Sviluppo) viene letto il ToolingManifest.jsonlocale; in caso contrario, esegue una query sul gateway di strumenti remoti. |
| list |
Restituisce le definizioni del server MCP per l'agente specificato. In fase di sviluppo (NODE_ENV=Sviluppo) viene letto il ToolingManifest.jsonlocale; in caso contrario, esegue una query sul gateway di strumenti remoti. |
| list |
Restituisce le definizioni del server MCP per l'agente specificato. In fase di sviluppo (NODE_ENV=Sviluppo) viene letto il ToolingManifest.jsonlocale; in caso contrario, esegue una query sul gateway di strumenti remoti. Questo overload risolve automaticamente l'agentecAppId da TurnContext e genera il token di autenticazione, se non specificato. |
| send |
Invia la cronologia delle chat alla piattaforma MCP per la protezione dalle minacce in tempo reale. |
| send |
Invia la cronologia delle chat alla piattaforma MCP per la protezione dalle minacce in tempo reale. |
Dettagli costruttore
McpToolServerConfigurationService(IConfigurationProvider<ToolingConfiguration>)
Costruire un McpToolServerConfigurationService.
new McpToolServerConfigurationService(configProvider?: IConfigurationProvider<ToolingConfiguration>)Parametri
- configProvider
Provider di configurazione facoltativo. Il valore predefinito è DefaultToolingConfigurationProvider, se non specificato.
Dettagli metodo
getMcpClientTools(string, MCPServerConfig)
Connettersi al server MCP e restituire strumenti con nomi preceduti dal nome del server. Genera un'eccezione se l'URL del server è mancante o il client non riesce ad elencare gli strumenti.
function getMcpClientTools(mcpServerName: string, mcpServerConfig: MCPServerConfig): Promise<McpClientTool[]>Parametri
- mcpServerName
-
string
- mcpServerConfig
- MCPServerConfig
Valori restituiti
Promise<McpClientTool[]>
listToolServers(string, string)
Avviso
Questa API è ora deprecata.
Use the overload with TurnContext and Authorization parameters instead to enable x-ms-agentid header support and automatic token generation.
Restituisce le definizioni del server MCP per l'agente specificato. In fase di sviluppo (NODE_ENV=Sviluppo) viene letto il ToolingManifest.jsonlocale; in caso contrario, esegue una query sul gateway di strumenti remoti.
function listToolServers(agenticAppId: string, authToken: string): Promise<MCPServerConfig[]>Parametri
- agenticAppId
-
string
ID app agentic per cui individuare i server.
- authToken
-
string
Token di connessione usato per l'esecuzione di query sul gateway di strumenti remoti.
Valori restituiti
Promise<MCPServerConfig[]>
Promessa che si risolve in una matrice di oggetti di configurazione del server MCP normalizzati.
listToolServers(string, string, ToolOptions)
Avviso
Questa API è ora deprecata.
Use the overload with TurnContext and Authorization parameters instead to enable x-ms-agentid header support and automatic token generation.
Restituisce le definizioni del server MCP per l'agente specificato. In fase di sviluppo (NODE_ENV=Sviluppo) viene letto il ToolingManifest.jsonlocale; in caso contrario, esegue una query sul gateway di strumenti remoti.
function listToolServers(agenticAppId: string, authToken: string, options?: ToolOptions): Promise<MCPServerConfig[]>Parametri
- agenticAppId
-
string
ID app agentic per cui individuare i server.
- authToken
-
string
Token di connessione usato per l'esecuzione di query sul gateway di strumenti remoti.
- options
- ToolOptions
Opzioni facoltative dello strumento quando si chiama il gateway.
Valori restituiti
Promise<MCPServerConfig[]>
Promessa che si risolve in una matrice di oggetti di configurazione del server MCP normalizzati.
listToolServers(TurnContext, Authorization, string, string, ToolOptions)
Restituisce le definizioni del server MCP per l'agente specificato. In fase di sviluppo (NODE_ENV=Sviluppo) viene letto il ToolingManifest.jsonlocale; in caso contrario, esegue una query sul gateway di strumenti remoti. Questo overload risolve automaticamente l'agentecAppId da TurnContext e genera il token di autenticazione, se non specificato.
function listToolServers(turnContext: TurnContext, authorization: Authorization, authHandlerName: string, authToken?: string, options?: ToolOptions): Promise<MCPServerConfig[]>Parametri
- turnContext
- TurnContext
TurnContext della richiesta corrente.
- authorization
- Authorization
Oggetto di autorizzazione per lo scambio di token.
- authHandlerName
-
string
Nome del gestore di autenticazione da usare per lo scambio di token.
- authToken
-
string
Token di connessione facoltativo. Se non specificato, verrà generato automaticamente tramite lo scambio di token.
- options
- ToolOptions
Opzioni facoltative dello strumento quando si chiama il gateway.
Valori restituiti
Promise<MCPServerConfig[]>
Promessa che si risolve in una matrice di oggetti di configurazione del server MCP normalizzati.
sendChatHistory(TurnContext, ChatHistoryMessage[])
Invia la cronologia delle chat alla piattaforma MCP per la protezione dalle minacce in tempo reale.
function sendChatHistory(turnContext: TurnContext, chatHistoryMessages: ChatHistoryMessage[]): Promise<OperationResult>Parametri
- turnContext
- TurnContext
Contesto del turno contenente informazioni sulla conversazione.
- chatHistoryMessages
Messaggi della cronologia delle chat da inviare.
Valori restituiti
Promise<OperationResult>
Promessa che viene risolta in operationResult che indica l'esito positivo o negativo.
Commenti
Le eccezioni HTTP (errori di rete, timeout) vengono rilevate e registrate ma non rigenerate. Al contrario, il metodo restituisce un operationResult che indica se l'operazione è riuscita o non è riuscita. I chiamanti possono scegliere di esaminare il risultato per la gestione degli errori o ignorarlo se i dettagli dell'errore non sono necessari.
sendChatHistory(TurnContext, ChatHistoryMessage[], ToolOptions)
Invia la cronologia delle chat alla piattaforma MCP per la protezione dalle minacce in tempo reale.
function sendChatHistory(turnContext: TurnContext, chatHistoryMessages: ChatHistoryMessage[], options?: ToolOptions): Promise<OperationResult>Parametri
- turnContext
- TurnContext
Contesto del turno contenente informazioni sulla conversazione.
- chatHistoryMessages
Messaggi della cronologia delle chat da inviare.
- options
- ToolOptions
Opzioni facoltative dello strumento per l'invio della cronologia delle chat.
Valori restituiti
Promise<OperationResult>
Promessa che viene risolta in operationResult che indica l'esito positivo o negativo.
Commenti
Le eccezioni HTTP (errori di rete, timeout) vengono rilevate e registrate ma non rigenerate. Al contrario, il metodo restituisce un operationResult che indica se l'operazione è riuscita o non è riuscita. I chiamanti possono scegliere di esaminare il risultato per la gestione degli errori o ignorarlo se i dettagli dell'errore non sono necessari.