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

BuildMcpServerUrl(string, IConfigurationProvider<ToolingConfiguration>)

Luo koko URL-osoite tietyn MCP-palvelimen käyttöä varten.

Esimerkki: Utility.BuildMcpServerUrl('MyServer') // => "https://agent365.svc.cloud.microsoft/agents/servers/MyServer/"

GetChatHistoryEndpoint(IConfigurationProvider<ToolingConfiguration>)

Muodostaa päätepisteen URL-osoitteen keskusteluhistorian lähettämiseksi MCP-ympäristöön reaaliaikaista uhkien suojausta varten.

GetMcpBaseUrl(IConfigurationProvider<ToolingConfiguration>)

Hanki URL-perusosoite, jota käytetään MCP-ympäristöjen kyselyihin.

GetToolingGatewayForDigitalWorker(string, IConfigurationProvider<ToolingConfiguration>)

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"

GetToolRequestHeaders(string, TurnContext, ToolOptions)

Vakiootsikoiden luominen MCP-työkalupyynnöille. Sisältää tarvittaessa Valtuutus-haltijatunnuksen ja valinnaisesti myös kanava- ja alikanavatunnisteet reititystä varten.

ValidateAuthToken(undefined | string)

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

IConfigurationProvider<ToolingConfiguration>

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

IConfigurationProvider<ToolingConfiguration>

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

IConfigurationProvider<ToolingConfiguration>

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

IConfigurationProvider<ToolingConfiguration>

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.