Utility class
Свойства
| HEADER_AGENT_ID | Имя заголовка для отправки идентификатора агента на платформу MCP для ведения журнала или аналитики. |
| HEADER_CHANNEL_ID | |
| HEADER_SUBCHANNEL_ID | |
| HEADER_USER_AGENT |
Методы
| Build |
Создайте полный URL-адрес для доступа к конкретному серверу MCP. Пример: Utility.BuildMcpServerUrl('MyServer') // => "https://agent365.svc.cloud.microsoft/agents/servers/MyServer/" |
| Get |
Создает URL-адрес конечной точки для отправки журнала чата на платформу MCP для защиты от угроз в режиме реального времени. |
| Get |
Получите базовый URL-адрес, используемый для запроса сред MCP. |
| Get |
Создайте URL-адрес шлюза инструментов для заданного удостоверения агента. Эта конечная точка используется для обнаружения серверов MCP, связанных с указанным удостоверением агента. Пример: Utility.GetToolingGatewayForDigitalWorker(agenticAppId) // => "https://agent365.svc.cloud.microsoft/agents/v2/{agenticAppId}/mcpServers" |
| Get |
Создание стандартных заголовков для запросов на инструментирование MCP. Включает маркер носителя авторизации при указании и при необходимости включает идентификаторы каналов и подканальных модулей для маршрутизации. |
| Validate |
Проверяет маркер проверки подлинности JWT. Проверяет, является ли маркер допустимым JWT и срок действия не истек. |
Сведения о свойстве
HEADER_AGENT_ID
Имя заголовка для отправки идентификатора агента на платформу MCP для ведения журнала или аналитики.
static HEADER_AGENT_ID: "x-ms-agentid" = "x-ms-agentid"Значение свойства
"x-ms-agentid"
HEADER_CHANNEL_ID
static HEADER_CHANNEL_ID: "x-ms-channel-id" = "x-ms-channel-id"Значение свойства
"x-ms-channel-id"
HEADER_SUBCHANNEL_ID
static HEADER_SUBCHANNEL_ID: "x-ms-subchannel-id" = "x-ms-subchannel-id"Значение свойства
"x-ms-subchannel-id"
HEADER_USER_AGENT
static HEADER_USER_AGENT: "User-Agent" = "User-Agent"Значение свойства
"User-Agent"
Сведения о методе
BuildMcpServerUrl(string, IConfigurationProvider<ToolingConfiguration>)
Предупреждение
Теперь этот API является нерекомендуемым.
This method is for internal use only. Use McpToolServerConfigurationService instead.
Создайте полный URL-адрес для доступа к конкретному серверу MCP.
Пример: Utility.BuildMcpServerUrl('MyServer') // => "https://agent365.svc.cloud.microsoft/agents/servers/MyServer/"
static function BuildMcpServerUrl(serverName: string, configProvider?: IConfigurationProvider<ToolingConfiguration>): stringПараметры
- serverName
-
string
Имя ресурса сервера MCP.
- configProvider
Необязательный поставщик конфигурации. По умолчанию используется defaultToolingConfigurationProvider.
Возвращаемое значение
string
Полный URL-адрес сервера MCP, включая косую черту.
GetChatHistoryEndpoint(IConfigurationProvider<ToolingConfiguration>)
Предупреждение
Теперь этот API является нерекомендуемым.
This method is for internal use only. Use McpToolServerConfigurationService.sendChatHistory() instead.
Создает URL-адрес конечной точки для отправки журнала чата на платформу MCP для защиты от угроз в режиме реального времени.
static function GetChatHistoryEndpoint(configProvider?: IConfigurationProvider<ToolingConfiguration>): stringПараметры
- configProvider
Необязательный поставщик конфигурации. По умолчанию используется defaultToolingConfigurationProvider.
Возвращаемое значение
string
Абсолютный URL-адрес, который компоненты инструментов могут использовать для отправки или извлечения сообщений чата для сценариев защиты от угроз в режиме реального времени.
Комментарии
Вызовите этот метод при создании HTTP-запросов, которые должны получить доступ к журналу сообщений чата для защиты от угроз в режиме реального времени. Возвращенный URL-адрес уже включает базовый адрес платформы MCP и сегмент фиксированного пути /agents/real-time-threat-protection/chat-message.
GetMcpBaseUrl(IConfigurationProvider<ToolingConfiguration>)
Предупреждение
Теперь этот API является нерекомендуемым.
This method is for internal use only. Use McpToolServerConfigurationService instead.
Получите базовый URL-адрес, используемый для запроса сред MCP.
static function GetMcpBaseUrl(configProvider?: IConfigurationProvider<ToolingConfiguration>): stringПараметры
- configProvider
Необязательный поставщик конфигурации. По умолчанию используется defaultToolingConfigurationProvider.
Возвращаемое значение
string
URL-адрес базовых сред MCP.
GetToolingGatewayForDigitalWorker(string, IConfigurationProvider<ToolingConfiguration>)
Предупреждение
Теперь этот API является нерекомендуемым.
This method is for internal use only. Use McpToolServerConfigurationService.listToolServers() instead.
Создайте URL-адрес шлюза инструментов для заданного удостоверения агента. Эта конечная точка используется для обнаружения серверов MCP, связанных с указанным удостоверением агента.
Пример: Utility.GetToolingGatewayForDigitalWorker(agenticAppId) // => "https://agent365.svc.cloud.microsoft/agents/v2/{agenticAppId}/mcpServers"
static function GetToolingGatewayForDigitalWorker(agenticAppId: string, configProvider?: IConfigurationProvider<ToolingConfiguration>): stringПараметры
- agenticAppId
-
string
Уникальный идентификатор для удостоверения агента.
- configProvider
Необязательный поставщик конфигурации. По умолчанию используется defaultToolingConfigurationProvider.
Возвращаемое значение
string
Полный URL-адрес, указывающий на шлюз инструментов для агента.
GetToolRequestHeaders(string, TurnContext, ToolOptions)
Создание стандартных заголовков для запросов на инструментирование MCP. Включает маркер носителя авторизации при указании и при необходимости включает идентификаторы каналов и подканальных модулей для маршрутизации.
static function GetToolRequestHeaders(authToken?: string, turnContext?: TurnContext, options?: ToolOptions): Record<string, string>Параметры
- authToken
-
string
Маркер носителя для заголовка авторизации.
- turnContext
- TurnContext
Необязательный объект TurnContext, из которого извлекаются идентификаторы каналов и вложенных каналов.
- options
- ToolOptions
Необязательный объект ToolOptions для дополнительной конфигурации запроса.
Возвращаемое значение
Record<string, string>
Запись заголовков, подходящая для HTTP-запросов.
ValidateAuthToken(undefined | string)
Проверяет маркер проверки подлинности JWT. Проверяет, является ли маркер допустимым JWT и срок действия не истек.
static function ValidateAuthToken(authToken: undefined | string)Параметры
- authToken
-
undefined | string
Маркер JWT для проверки.