ToolingConfiguration class

Pacote:

@microsoft/agents-a365-tooling

Configuração para o pacote de ferramentas. Herda definições de runtime e adiciona definições específicas da ferramenta.

Extends

RuntimeConfiguration

Construtores

ToolingConfiguration(ToolingConfigurationOptions)

Propriedades

clusterCategory
isDevelopmentEnvironment	Se o cluster é um ambiente de desenvolvimento (local ou de desenvolvimento). Baseado no clusterCategory.
isNodeEnvDevelopment	Se NODE_ENV indica modo de desenvolvimento. Retorna verdadeiro quando NODE_ENV é 'desenvolvimento' (indistinto a maiúsculas minúsculas). Esta é a forma padrão Node.js de indicar o modo de desenvolvimento.
mcpPlatformAuthenticationScope	Recebe o âmbito de autenticação da plataforma MCP. Usado pelo AgenticAuthenticationService para troca de tokens. Corta o espaço em branco para evitar falhas na troca de tokens.
mcpPlatformEndpoint
useToolingManifest	Se devo usar o ficheiro ToolingManifest.json em vez da descoberta do gateway. Retorna verdadeiro quando NODE_ENV está definido como 'desenvolvimento' (indistinto a maiúsculas), ou quando é explicitamente sobreposto via configuração.

Métodos

getBearerTokenForServer(string)	Devolve o token portador do modo de desenvolvimento para um servidor MCP pelo nome. Verifica BEARER_TOKEN_<SERVERNAME_UPPER> primeiro, depois volta a BEARER_TOKEN. Devolve indefinido quando a variável não está definida (não será anexado cabeçalho de Autorização).
hasPerServerBearerToken(string)	Retorna verdadeiro quando um token portador por servidor env var (BEARER_TOKEN_<SERVERNAME_UPPER>) está explicitamente definido para o servidor dado, sendo falso quando apenas o recurso de BEARER_TOKEN partilhado seria usado. Usado para detetar servidores V2 que estão silenciosamente a recuar para um token de audiência errada no modo dev.

Métodos Herdados

parseEnvBoolean(undefined | string)	Analisa uma variável de ambiente como uma booleana. Reconhece 'verdadeiro', '1', 'sim', 'on' (indistinto a maiúsculas) como verdadeiro; todos os outros valores são falsos.
parseEnvInt(undefined | string, number)	Analise uma variável de ambiente como um inteiro, retornando o fallback se for inválido ou não definido.

Detalhes do Construtor

ToolingConfiguration(ToolingConfigurationOptions)

new ToolingConfiguration(overrides?: ToolingConfigurationOptions)

Parâmetros

overrides

ToolingConfigurationOptions

Detalhes de Propriedade

clusterCategory

ClusterCategory clusterCategory

Valor de Propriedade

ClusterCategory

isDevelopmentEnvironment

Se o cluster é um ambiente de desenvolvimento (local ou de desenvolvimento). Baseado no clusterCategory.

boolean isDevelopmentEnvironment

Valor de Propriedade

boolean

isNodeEnvDevelopment

Se NODE_ENV indica modo de desenvolvimento. Retorna verdadeiro quando NODE_ENV é 'desenvolvimento' (indistinto a maiúsculas minúsculas). Esta é a forma padrão Node.js de indicar o modo de desenvolvimento.

boolean isNodeEnvDevelopment

Valor de Propriedade

boolean

mcpPlatformAuthenticationScope

Recebe o âmbito de autenticação da plataforma MCP. Usado pelo AgenticAuthenticationService para troca de tokens. Corta o espaço em branco para evitar falhas na troca de tokens.

string mcpPlatformAuthenticationScope

Valor de Propriedade

string

mcpPlatformEndpoint

string mcpPlatformEndpoint

Valor de Propriedade

string

useToolingManifest

Se devo usar o ficheiro ToolingManifest.json em vez da descoberta do gateway. Retorna verdadeiro quando NODE_ENV está definido como 'desenvolvimento' (indistinto a maiúsculas), ou quando é explicitamente sobreposto via configuração.

boolean useToolingManifest

Valor de Propriedade

boolean

Detalhes de Método

getBearerTokenForServer(string)

Devolve o token portador do modo de desenvolvimento para um servidor MCP pelo nome. Verifica BEARER_TOKEN_<SERVERNAME_UPPER> primeiro, depois volta a BEARER_TOKEN. Devolve indefinido quando a variável não está definida (não será anexado cabeçalho de Autorização).

function getBearerTokenForServer(mcpServerName: string): undefined | string

Parâmetros

mcpServerName

string

Devoluções

undefined | string

hasPerServerBearerToken(string)

Retorna verdadeiro quando um token portador por servidor env var (BEARER_TOKEN_<SERVERNAME_UPPER>) está explicitamente definido para o servidor dado, sendo falso quando apenas o recurso de BEARER_TOKEN partilhado seria usado. Usado para detetar servidores V2 que estão silenciosamente a recuar para um token de audiência errada no modo dev.

function hasPerServerBearerToken(mcpServerName: string): boolean

Parâmetros

mcpServerName

string

Devoluções

boolean

Detalhes do Método Herdado

parseEnvBoolean(undefined | string)

Analisa uma variável de ambiente como uma booleana. Reconhece 'verdadeiro', '1', 'sim', 'on' (indistinto a maiúsculas) como verdadeiro; todos os outros valores são falsos.

static function parseEnvBoolean(envValue: undefined | string): boolean

Parâmetros

envValue

undefined | string

Devoluções

boolean

Herdado de RuntimeConfiguration.parseEnvBoolean

parseEnvInt(undefined | string, number)

Analise uma variável de ambiente como um inteiro, retornando o fallback se for inválido ou não definido.

static function parseEnvInt(envValue: undefined | string, fallback: number): number

Parâmetros

envValue

undefined | string

fallback

number

Devoluções

number

Herdado de RuntimeConfiguration.parseEnvInt