Utility class

Pakiet:

@microsoft/agents-a365-tooling

Właściwości

HEADER_AGENT_ID	Nazwa nagłówka wysyłania identyfikatora agenta do platformy MCP na potrzeby rejestrowania/analizy.
HEADER_CHANNEL_ID
HEADER_SUBCHANNEL_ID
HEADER_USER_AGENT

Metody

BuildMcpServerUrl(string, IConfigurationProvider<ToolingConfiguration>)	Skompiluj pełny adres URL na potrzeby uzyskiwania dostępu do określonego serwera MCP. Przykład: Utility.BuildMcpServerUrl('MyServer') // => "https://agent365.svc.cloud.microsoft/agents/servers/MyServer/"
GetChatHistoryEndpoint(IConfigurationProvider<ToolingConfiguration>)	Tworzy adres URL punktu końcowego do wysyłania historii czatów do platformy MCP na potrzeby ochrony przed zagrożeniami w czasie rzeczywistym.
GetMcpBaseUrl(IConfigurationProvider<ToolingConfiguration>)	Pobierz podstawowy adres URL używany do wykonywania zapytań dotyczących środowisk MCP.
GetToolingGatewayForDigitalWorker(string, IConfigurationProvider<ToolingConfiguration>)	Skonstruuj adres URL bramy narzędzi dla danej tożsamości agenta. Ten punkt końcowy służy do odnajdywania serwerów MCP skojarzonych z określoną tożsamością agenta. Przykład: Utility.GetToolingGatewayForDigitalWorker(agenticAppId) // => "https://agent365.svc.cloud.microsoft/agents/v2/{agenticAppId}/mcpServers"
GetToolRequestHeaders(string, TurnContext, ToolOptions)	Redaguj standardowe nagłówki dla żądań narzędzi MCP. Obejmuje token elementu nośnego autoryzacji w przypadku podania i opcjonalnie zawiera identyfikatory kanału i podkanałów na potrzeby routingu.
ValidateAuthToken(undefined | string)	Weryfikuje token uwierzytelniania JWT. Sprawdza, czy token jest prawidłowym zestawem JWT i nie wygasł.

Szczegóły właściwości

HEADER_AGENT_ID

Nazwa nagłówka wysyłania identyfikatora agenta do platformy MCP na potrzeby rejestrowania/analizy.

static HEADER_AGENT_ID: "x-ms-agentid" = "x-ms-agentid"

Wartość właściwości

"x-ms-agentid"

HEADER_CHANNEL_ID

static HEADER_CHANNEL_ID: "x-ms-channel-id" = "x-ms-channel-id"

Wartość właściwości

"x-ms-channel-id"

HEADER_SUBCHANNEL_ID

static HEADER_SUBCHANNEL_ID: "x-ms-subchannel-id" = "x-ms-subchannel-id"

Wartość właściwości

"x-ms-subchannel-id"

HEADER_USER_AGENT

static HEADER_USER_AGENT: "User-Agent" = "User-Agent"

Wartość właściwości

"User-Agent"

Szczegóły metody

BuildMcpServerUrl(string, IConfigurationProvider<ToolingConfiguration>)

Ostrzeżenie

Ten interfejs API jest już przestarzały.

This method is for internal use only. Use McpToolServerConfigurationService instead.

Skompiluj pełny adres URL na potrzeby uzyskiwania dostępu do określonego serwera MCP.

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

static function BuildMcpServerUrl(serverName: string, configProvider?: IConfigurationProvider<ToolingConfiguration>): string

Parametry

serverName

string

Nazwa zasobu serwera MCP.

configProvider

IConfigurationProvider<ToolingConfiguration>

Opcjonalny dostawca konfiguracji. Domyślnie wartość defaultToolingConfigurationProvider.

Zwraca

string

W pełni kwalifikowany adres URL serwera MCP, w tym końcowy ukośnik.

GetChatHistoryEndpoint(IConfigurationProvider<ToolingConfiguration>)

Ostrzeżenie

Ten interfejs API jest już przestarzały.

This method is for internal use only. Use McpToolServerConfigurationService.sendChatHistory() instead.

Tworzy adres URL punktu końcowego do wysyłania historii czatów do platformy MCP na potrzeby ochrony przed zagrożeniami w czasie rzeczywistym.

static function GetChatHistoryEndpoint(configProvider?: IConfigurationProvider<ToolingConfiguration>): string

Parametry

configProvider

IConfigurationProvider<ToolingConfiguration>

Opcjonalny dostawca konfiguracji. Domyślnie wartość defaultToolingConfigurationProvider.

Zwraca

string

Bezwzględny adres URL, którego składniki narzędzi mogą używać do wysyłania lub pobierania wiadomości czatu dla scenariuszy ochrony przed zagrożeniami w czasie rzeczywistym.

Uwagi

Wywołaj tę metodę podczas konstruowania żądań HTTP, które muszą uzyskać dostęp do historii wiadomości czatu w celu ochrony przed zagrożeniami w czasie rzeczywistym. Zwrócony adres URL zawiera już adres podstawowy platformy MCP i stały segment ścieżki /agents/real-time-threat-protection/chat-message.

GetMcpBaseUrl(IConfigurationProvider<ToolingConfiguration>)

Ostrzeżenie

Ten interfejs API jest już przestarzały.

This method is for internal use only. Use McpToolServerConfigurationService instead.

Pobierz podstawowy adres URL używany do wykonywania zapytań dotyczących środowisk MCP.

static function GetMcpBaseUrl(configProvider?: IConfigurationProvider<ToolingConfiguration>): string

Parametry

configProvider

IConfigurationProvider<ToolingConfiguration>

Opcjonalny dostawca konfiguracji. Domyślnie wartość defaultToolingConfigurationProvider.

Zwraca

string

Podstawowy adres URL środowisk MCP.

GetToolingGatewayForDigitalWorker(string, IConfigurationProvider<ToolingConfiguration>)

Ostrzeżenie

Ten interfejs API jest już przestarzały.

This method is for internal use only. Use McpToolServerConfigurationService.listToolServers() instead.

Skonstruuj adres URL bramy narzędzi dla danej tożsamości agenta. Ten punkt końcowy służy do odnajdywania serwerów MCP skojarzonych z określoną tożsamością agenta.

Przykład: Utility.GetToolingGatewayForDigitalWorker(agenticAppId) // => "https://agent365.svc.cloud.microsoft/agents/v2/{agenticAppId}/mcpServers"

static function GetToolingGatewayForDigitalWorker(agenticAppId: string, configProvider?: IConfigurationProvider<ToolingConfiguration>): string

Parametry

agenticAppId

string

Unikatowy identyfikator tożsamości agenta.

configProvider

IConfigurationProvider<ToolingConfiguration>

Opcjonalny dostawca konfiguracji. Domyślnie wartość defaultToolingConfigurationProvider.

Zwraca

string

W pełni kwalifikowany adres URL wskazujący bramę narzędzi dla agenta.

GetToolRequestHeaders(string, TurnContext, ToolOptions)

Redaguj standardowe nagłówki dla żądań narzędzi MCP. Obejmuje token elementu nośnego autoryzacji w przypadku podania i opcjonalnie zawiera identyfikatory kanału i podkanałów na potrzeby routingu.

static function GetToolRequestHeaders(authToken?: string, turnContext?: TurnContext, options?: ToolOptions): Record<string, string>

Parametry

authToken

string

Token elementu nośnego dla nagłówka autoryzacji.

turnContext

TurnContext

Opcjonalny obiekt TurnContext, z którego wyodrębniono identyfikatory kanału i podkanałów.

options

ToolOptions

Opcjonalny obiekt ToolOptions na potrzeby dodatkowej konfiguracji żądania.

Zwraca

Record<string, string>

Rekord nagłówków odpowiedni dla żądań HTTP.

ValidateAuthToken(undefined | string)

Weryfikuje token uwierzytelniania JWT. Sprawdza, czy token jest prawidłowym zestawem JWT i nie wygasł.

static function ValidateAuthToken(authToken: undefined | string)

Parametry

authToken

undefined | string

Token JWT do zweryfikowania.