Utility class
Ominaisuudet
| HEADER_AGENT_ID | Otsikon nimi agentin tunnisteen lähettämiseksi MCP-ympäristöön kirjaamista/analysointia varten. |
| HEADER_CHANNEL_ID | |
| HEADER_SUBCHANNEL_ID | |
| HEADER_USER_AGENT |
Menetelmät
| Build |
Luo koko URL-osoite tietyn MCP-palvelimen käyttöä varten. Esimerkki: Utility.BuildMcpServerUrl('MyServer') // => "https://agent365.svc.cloud.microsoft/agents/servers/MyServer/" |
| Get |
Muodostaa päätepisteen URL-osoitteen keskusteluhistorian lähettämiseksi MCP-ympäristöön reaaliaikaista uhkien suojausta varten. |
| Get |
Hanki URL-perusosoite, jota käytetään MCP-ympäristöjen kyselyihin. |
| Get |
Muodosta työkaluyhdyskäytävän URL-osoite tietylle agentin käyttäjätietolle. Tämän päätepisteen avulla löydetään määritettyihin agentin käyttäjätietoihin liittyviä MCP-palvelimia. Esimerkki: Utility.GetToolingGatewayForDigitalWorker(agenticAppId) // => "https://agent365.svc.cloud.microsoft/agents/v2/{agenticAppId}/mcpServers" |
| Get |
Vakiootsikoiden luominen MCP-työkalupyynnöille. Sisältää tarvittaessa Valtuutus-haltijatunnuksen ja valinnaisesti myös kanava- ja alikanavatunnisteet reititystä varten. |
| Validate |
Vahvistaa JWT-todennustunnuksen. Tarkistaa, että tunnus on kelvollinen JWT-tiedosto eikä se ole vanhentunut. |
Ominaisuuden tiedot
HEADER_AGENT_ID
Otsikon nimi agentin tunnisteen lähettämiseksi MCP-ympäristöön kirjaamista/analysointia varten.
static HEADER_AGENT_ID: "x-ms-agentid" = "x-ms-agentid"
Ominaisuuden arvo
"x-ms-agentid"
HEADER_CHANNEL_ID
static HEADER_CHANNEL_ID: "x-ms-channel-id" = "x-ms-channel-id"
Ominaisuuden arvo
"x-ms-channel-id"
HEADER_SUBCHANNEL_ID
static HEADER_SUBCHANNEL_ID: "x-ms-subchannel-id" = "x-ms-subchannel-id"
Ominaisuuden arvo
"x-ms-subchannel-id"
HEADER_USER_AGENT
static HEADER_USER_AGENT: "User-Agent" = "User-Agent"
Ominaisuuden arvo
"User-Agent"
Menetelmän tiedot
BuildMcpServerUrl(string, IConfigurationProvider<ToolingConfiguration>)
Varoitus
Tämä ohjelmointirajapinta on nyt vanhentunut.
This method is for internal use only. Use McpToolServerConfigurationService instead.
Luo koko URL-osoite tietyn MCP-palvelimen käyttöä varten.
Esimerkki: Utility.BuildMcpServerUrl('MyServer') // => "https://agent365.svc.cloud.microsoft/agents/servers/MyServer/"
static function BuildMcpServerUrl(serverName: string, configProvider?: IConfigurationProvider<ToolingConfiguration>): string
Parametrit
- serverName
-
string
MCP-palvelimen resurssin nimi.
- configProvider
Valinnainen määrityspalvelu. Oletusarvo on defaultToolingConfigurationProvider.
Palautukset
string
Täydellinen MCP-palvelimen URL-osoite, mukaan lukien vinoviiva.
GetChatHistoryEndpoint(IConfigurationProvider<ToolingConfiguration>)
Varoitus
Tämä ohjelmointirajapinta on nyt vanhentunut.
This method is for internal use only. Use McpToolServerConfigurationService.sendChatHistory() instead.
Muodostaa päätepisteen URL-osoitteen keskusteluhistorian lähettämiseksi MCP-ympäristöön reaaliaikaista uhkien suojausta varten.
static function GetChatHistoryEndpoint(configProvider?: IConfigurationProvider<ToolingConfiguration>): string
Parametrit
- configProvider
Valinnainen määrityspalvelu. Oletusarvo on defaultToolingConfigurationProvider.
Palautukset
string
Absoluuttinen URL-osoite, jota työkalukomponentit voivat käyttää reaaliaikaisten uhkien suojausskenaarioiden lähettämiseen tai noutamiseen.
Huomautukset
Kutsu tätä menetelmää luotaessa HTTP-pyyntöjä, joiden on käytettävä reaaliaikaista uhkien suojausta keskusteluviestihistoriaa. Palautettu URL-osoite sisältää jo MCP-ympäristön perusosoitteen ja kiinteän polun segmentin /agents/real-time-threat-protection/chat-message.
GetMcpBaseUrl(IConfigurationProvider<ToolingConfiguration>)
Varoitus
Tämä ohjelmointirajapinta on nyt vanhentunut.
This method is for internal use only. Use McpToolServerConfigurationService instead.
Hanki URL-perusosoite, jota käytetään MCP-ympäristöjen kyselyihin.
static function GetMcpBaseUrl(configProvider?: IConfigurationProvider<ToolingConfiguration>): string
Parametrit
- configProvider
Valinnainen määrityspalvelu. Oletusarvo on defaultToolingConfigurationProvider.
Palautukset
string
MCP-perusympäristöjen URL-osoite.
GetToolingGatewayForDigitalWorker(string, IConfigurationProvider<ToolingConfiguration>)
Varoitus
Tämä ohjelmointirajapinta on nyt vanhentunut.
This method is for internal use only. Use McpToolServerConfigurationService.listToolServers() instead.
Muodosta työkaluyhdyskäytävän URL-osoite tietylle agentin käyttäjätietolle. Tämän päätepisteen avulla löydetään määritettyihin agentin käyttäjätietoihin liittyviä MCP-palvelimia.
Esimerkki: Utility.GetToolingGatewayForDigitalWorker(agenticAppId) // => "https://agent365.svc.cloud.microsoft/agents/v2/{agenticAppId}/mcpServers"
static function GetToolingGatewayForDigitalWorker(agenticAppId: string, configProvider?: IConfigurationProvider<ToolingConfiguration>): string
Parametrit
- agenticAppId
-
string
Agentin käyttäjätietojen yksilöllinen tunnus.
- configProvider
Valinnainen määrityspalvelu. Oletusarvo on defaultToolingConfigurationProvider.
Palautukset
string
Täydellinen URL-osoite, joka osoittaa agentin työkaluyhdyskäytävään.
GetToolRequestHeaders(string, TurnContext, ToolOptions)
Vakiootsikoiden luominen MCP-työkalupyynnöille. Sisältää tarvittaessa Valtuutus-haltijatunnuksen ja valinnaisesti myös kanava- ja alikanavatunnisteet reititystä varten.
static function GetToolRequestHeaders(authToken?: string, turnContext?: TurnContext, options?: ToolOptions): Record<string, string>
Parametrit
- authToken
-
string
Valtuutusotsikon haltijatunnus.
- turnContext
- TurnContext
Valinnainen TurnContext-objekti, josta kanavan ja alikanavan tunnukset poimitaan.
- options
- ToolOptions
Valinnainen TyökaluAsetukset-objekti lisäpyyntöjen määritystä varten.
Palautukset
Record<string, string>
HTTP-pyynnöille soveltuva otsikkotietue.
ValidateAuthToken(undefined | string)
Vahvistaa JWT-todennustunnuksen. Tarkistaa, että tunnus on kelvollinen JWT-tiedosto eikä se ole vanhentunut.
static function ValidateAuthToken(authToken: undefined | string)
Parametrit
- authToken
-
undefined | string
Vahvistettava JWT-tunnus.