McpToolServerConfigurationService class
Palvelu, joka on vastuussa MCP:n (Model Context Protocol) työkalupalvelimien etsimisestä ja normalisoinnista sekä Claude SDK:n kuluttamien määritysobjektien tuottamisesta.
Konstruktorit
| Mcp |
Muodosta McpToolServerConfigurationService. |
Menetelmät
| get |
Muodosta yhteys MCP-palvelimeen ja palauta työkalut, joiden nimien etuliitteenä on palvelimen nimi. Palauttaa virheen, jos palvelimen URL-osoite puuttuu tai jos asiakas ei pysty luettelemaan työkaluja. |
| list |
Palauta tietyn agentin MCP-palvelimen määritykset. Kehitysvaiheessa (NODE_ENV=Kehitys) tämä lukee paikallinen ToolingManifest.json; muussa tapauksessa se tekee kyselyn etätyökaluyhdyskäytävään. |
| list |
Palauta tietyn agentin MCP-palvelimen määritykset. Kehitysvaiheessa (NODE_ENV=Kehitys) tämä lukee paikallinen ToolingManifest.json; muussa tapauksessa se tekee kyselyn etätyökaluyhdyskäytävään. |
| list |
Palauta tietyn agentin MCP-palvelimen määritykset. Kehitysvaiheessa (NODE_ENV=Kehitys) tämä lukee paikallinen ToolingManifest.json; muussa tapauksessa se tekee kyselyn etätyökaluyhdyskäytävään. Tämä ylikuormitus ratkaisee automaattisesti TurnContextin agenticAppId-tunnuksen ja luo todennustunnuksen, jos sitä ei ole annettu. |
| send |
Lähettää keskusteluhistorian MCP-ympäristöön reaaliaikaista uhkien suojausta varten. |
| send |
Lähettää keskusteluhistorian MCP-ympäristöön reaaliaikaista uhkien suojausta varten. |
Konstruktorin tiedot
McpToolServerConfigurationService(IConfigurationProvider<ToolingConfiguration>)
Muodosta McpToolServerConfigurationService.
new McpToolServerConfigurationService(configProvider?: IConfigurationProvider<ToolingConfiguration>)
Parametrit
- configProvider
Valinnainen määrityspalvelu. Oletusarvona on defaultToolingConfigurationProvider, jos sitä ei ole määritetty.
Menetelmän tiedot
getMcpClientTools(string, MCPServerConfig)
Muodosta yhteys MCP-palvelimeen ja palauta työkalut, joiden nimien etuliitteenä on palvelimen nimi. Palauttaa virheen, jos palvelimen URL-osoite puuttuu tai jos asiakas ei pysty luettelemaan työkaluja.
function getMcpClientTools(mcpServerName: string, mcpServerConfig: MCPServerConfig): Promise<McpClientTool[]>
Parametrit
- mcpServerName
-
string
- mcpServerConfig
- MCPServerConfig
Palautukset
Promise<McpClientTool[]>
listToolServers(string, string)
Varoitus
Tämä ohjelmointirajapinta on nyt vanhentunut.
Use the overload with TurnContext and Authorization parameters instead to enable x-ms-agentid header support and automatic token generation.
Palauta tietyn agentin MCP-palvelimen määritykset. Kehitysvaiheessa (NODE_ENV=Kehitys) tämä lukee paikallinen ToolingManifest.json; muussa tapauksessa se tekee kyselyn etätyökaluyhdyskäytävään.
function listToolServers(agenticAppId: string, authToken: string): Promise<MCPServerConfig[]>
Parametrit
- agenticAppId
-
string
Agenttisovellustunnus, josta palvelimia löydetään.
- authToken
-
string
Haltijatunnus, jota käytetään, kun etätyökaluyhdyskäytävää kyselevät.
Palautukset
Promise<MCPServerConfig[]>
Lupaus ratkaista useita normalisoituja MCP-palvelimen määritysobjekteja.
listToolServers(string, string, ToolOptions)
Varoitus
Tämä ohjelmointirajapinta on nyt vanhentunut.
Use the overload with TurnContext and Authorization parameters instead to enable x-ms-agentid header support and automatic token generation.
Palauta tietyn agentin MCP-palvelimen määritykset. Kehitysvaiheessa (NODE_ENV=Kehitys) tämä lukee paikallinen ToolingManifest.json; muussa tapauksessa se tekee kyselyn etätyökaluyhdyskäytävään.
function listToolServers(agenticAppId: string, authToken: string, options?: ToolOptions): Promise<MCPServerConfig[]>
Parametrit
- agenticAppId
-
string
Agenttisovellustunnus, josta palvelimia löydetään.
- authToken
-
string
Haltijatunnus, jota käytetään, kun etätyökaluyhdyskäytävää kyselevät.
- options
- ToolOptions
Valinnaiset työkaluvaihtoehdot yhdyskäytävää kutsuttaessa.
Palautukset
Promise<MCPServerConfig[]>
Lupaus ratkaista useita normalisoituja MCP-palvelimen määritysobjekteja.
listToolServers(TurnContext, Authorization, string, string, ToolOptions)
Palauta tietyn agentin MCP-palvelimen määritykset. Kehitysvaiheessa (NODE_ENV=Kehitys) tämä lukee paikallinen ToolingManifest.json; muussa tapauksessa se tekee kyselyn etätyökaluyhdyskäytävään. Tämä ylikuormitus ratkaisee automaattisesti TurnContextin agenticAppId-tunnuksen ja luo todennustunnuksen, jos sitä ei ole annettu.
function listToolServers(turnContext: TurnContext, authorization: Authorization, authHandlerName: string, authToken?: string, options?: ToolOptions): Promise<MCPServerConfig[]>
Parametrit
- turnContext
- TurnContext
Nykyisen pyynnön TurnContext.
- authorization
- Authorization
Valtuutusobjekti tunnuksen vaihdolle.
- authHandlerName
-
string
Sen todennuskäsittelijän nimi, jota käytetään tunnuksen vaihdossa.
- authToken
-
string
Valinnainen haltijatunnus. Jos sitä ei anneta, se luodaan automaattisesti tunnuksensiirron kautta.
- options
- ToolOptions
Valinnaiset työkaluvaihtoehdot yhdyskäytävää kutsuttaessa.
Palautukset
Promise<MCPServerConfig[]>
Lupaus ratkaista useita normalisoituja MCP-palvelimen määritysobjekteja.
sendChatHistory(TurnContext, ChatHistoryMessage[])
Lähettää keskusteluhistorian MCP-ympäristöön reaaliaikaista uhkien suojausta varten.
function sendChatHistory(turnContext: TurnContext, chatHistoryMessages: ChatHistoryMessage[]): Promise<OperationResult>
Parametrit
- turnContext
- TurnContext
Vuoron konteksti, joka sisältää keskustelutietoja.
- chatHistoryMessages
Lähetettävät keskusteluhistorian viestit.
Palautukset
Promise<OperationResult>
Lupaus, joka ratkaisee OperationResult-kohteen, joka ilmaisee onnistumisen tai epäonnistumisen.
Huomautukset
HTTP-poikkeukset (verkon virheet ja aikakatkaisut) havaitaan ja kirjataan, mutta ne eivät jää uudelleen käyttöön. Sen sijaan -menetelmä palauttaa OperationResult-arvon, joka ilmaisee, onko toiminto onnistunut vai epäonnistunut. Soittajat voivat joko tarkastaa virheenkäsittelytuloksen tai ohittaa sen, jos virhetietoja ei tarvita.
sendChatHistory(TurnContext, ChatHistoryMessage[], ToolOptions)
Lähettää keskusteluhistorian MCP-ympäristöön reaaliaikaista uhkien suojausta varten.
function sendChatHistory(turnContext: TurnContext, chatHistoryMessages: ChatHistoryMessage[], options?: ToolOptions): Promise<OperationResult>
Parametrit
- turnContext
- TurnContext
Vuoron konteksti, joka sisältää keskustelutietoja.
- chatHistoryMessages
Lähetettävät keskusteluhistorian viestit.
- options
- ToolOptions
Valinnaisia työkaluvaihtoehtoja keskusteluhistorian lähettämiseen.
Palautukset
Promise<OperationResult>
Lupaus, joka ratkaisee OperationResult-kohteen, joka ilmaisee onnistumisen tai epäonnistumisen.
Huomautukset
HTTP-poikkeukset (verkon virheet ja aikakatkaisut) havaitaan ja kirjataan, mutta ne eivät jää uudelleen käyttöön. Sen sijaan -menetelmä palauttaa OperationResult-arvon, joka ilmaisee, onko toiminto onnistunut vai epäonnistunut. Soittajat voivat joko tarkastaa virheenkäsittelytuloksen tai ohittaa sen, jos virhetietoja ei tarvita.