Utility class

패키지:

@microsoft/agents-a365-tooling

속성

HEADER_AGENT_ID	로깅/분석을 위해 MCP 플랫폼으로 에이전트 식별자를 보내기 위한 헤더 이름입니다.
HEADER_CHANNEL_ID
HEADER_SUBCHANNEL_ID
HEADER_USER_AGENT

메서드

BuildMcpServerUrl(string, IConfigurationProvider<ToolingConfiguration>)	특정 MCP 서버에 액세스하기 위한 전체 URL을 빌드합니다. 예: Utility.BuildMcpServerUrl('MyServer') // => "https://agent365.svc.cloud.microsoft/agents/servers/MyServer/"
GetChatHistoryEndpoint(IConfigurationProvider<ToolingConfiguration>)	실시간 위협 방지를 위해 MCP 플랫폼으로 채팅 기록을 보내기 위한 엔드포인트 URL을 생성합니다.
GetMcpBaseUrl(IConfigurationProvider<ToolingConfiguration>)	MCP 환경을 쿼리하는 데 사용되는 기본 URL을 가져옵니다.
GetToolingGatewayForDigitalWorker(string, IConfigurationProvider<ToolingConfiguration>)	지정된 에이전트 ID에 대한 도구 게이트웨이 URL을 생성합니다. 이 엔드포인트는 지정된 에이전트 ID와 연결된 MCP 서버를 검색하는 데 사용됩니다. 예: Utility.GetToolingGatewayForDigitalWorker(agenticAppId) // => "https://agent365.svc.cloud.microsoft/agents/v2/{agenticAppId}/mcpServers"
GetToolRequestHeaders(string, TurnContext, ToolOptions)	MCP 도구 요청에 대한 표준 헤더를 작성합니다. 제공될 때 권한 부여 전달자 토큰을 포함하며, 필요에 따라 라우팅을 위한 채널 및 하위 채널 식별자를 포함합니다.
ValidateAuthToken(undefined | string)	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.

특정 MCP 서버에 액세스하기 위한 전체 URL을 빌드합니다.

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

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

매개 변수

serverName

string

MCP 서버 리소스 이름입니다.

configProvider

IConfigurationProvider<ToolingConfiguration>

선택적 구성 공급자입니다. 기본값은 defaultToolingConfigurationProvider입니다.

반품

string

후행 슬래시를 포함한 정규화된 MCP 서버 URL입니다.

GetChatHistoryEndpoint(IConfigurationProvider<ToolingConfiguration>)

경고

이 API는 이제 사용되지 않습니다.

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

실시간 위협 방지를 위해 MCP 플랫폼으로 채팅 기록을 보내기 위한 엔드포인트 URL을 생성합니다.

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

매개 변수

configProvider

IConfigurationProvider<ToolingConfiguration>

선택적 구성 공급자입니다. 기본값은 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.

MCP 환경을 쿼리하는 데 사용되는 기본 URL을 가져옵니다.

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

매개 변수

configProvider

IConfigurationProvider<ToolingConfiguration>

선택적 구성 공급자입니다. 기본값은 defaultToolingConfigurationProvider입니다.

반품

string

기본 MCP 환경 URL입니다.

GetToolingGatewayForDigitalWorker(string, IConfigurationProvider<ToolingConfiguration>)

경고

이 API는 이제 사용되지 않습니다.

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

지정된 에이전트 ID에 대한 도구 게이트웨이 URL을 생성합니다. 이 엔드포인트는 지정된 에이전트 ID와 연결된 MCP 서버를 검색하는 데 사용됩니다.

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

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

매개 변수

agenticAppId

string

에이전트 ID의 고유 식별자입니다.

configProvider

IConfigurationProvider<ToolingConfiguration>

선택적 구성 공급자입니다. 기본값은 defaultToolingConfigurationProvider입니다.

반품

string

에이전트의 도구 게이트웨이를 가리키는 정규화된 URL입니다.

GetToolRequestHeaders(string, TurnContext, ToolOptions)

MCP 도구 요청에 대한 표준 헤더를 작성합니다. 제공될 때 권한 부여 전달자 토큰을 포함하며, 필요에 따라 라우팅을 위한 채널 및 하위 채널 식별자를 포함합니다.

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

매개 변수

authToken

string

권한 부여 헤더에 대한 전달자 토큰입니다.

turnContext

TurnContext

채널 및 하위 채널 ID가 추출되는 선택적 TurnContext 개체입니다.

options

ToolOptions

추가 요청 구성을 위한 선택적 ToolOptions 개체입니다.

반품

Record<string, string>

HTTP 요청에 적합한 헤더 레코드입니다.

ValidateAuthToken(undefined | string)

JWT 인증 토큰의 유효성을 검사합니다. 토큰이 유효한 JWT이고 만료되지 않았는지 확인합니다.

static function ValidateAuthToken(authToken: undefined | string)

매개 변수

authToken

undefined | string

유효성을 검사할 JWT 토큰입니다.