ClaudeToolingConfiguration class

Paket:
@microsoft/agents-a365-tooling-extensions-claude

Konfiguration für Claude Tooling Erweiterungspaket. Erbt alle Tools und Laufzeiteinstellungen.

Warum diese Klasse vorhanden ist

Obwohl diese Klasse derzeit keine neuen Einstellungen hinzufügt, die über die von ToolingConfiguration bereitgestellt werden, gibt es aus mehreren wichtigen Gründen:

  1. Typsicherheit: Ermöglicht Claude-spezifischen Diensten, ihre Abhängigkeit IConfigurationProvider<ClaudeToolingConfiguration>zu deklarieren und den Konfigurationsvertrag explizit zu machen und die Kompilierungszeitüberprüfung zu ermöglichen.

  2. Erweiterungspunkt: Stellt einen klaren Ort zum Hinzufügen von Claude-spezifischen Einstellungen (z. B. Claude-API-Timeouts, Modelleinstellungen, Wiederholungsrichtlinien) bereit, ohne vorhandenen Code zu unterbrechen, wenn diese Anforderungen auftreten.

  3. Konsistentes Muster: Behält die Symmetrie mit anderen Erweiterungspaketen (LangChain, OpenAI) bei, wodurch das SDK einfacher zu verstehen und zu navigieren ist.

  4. Abhängigkeitsinjektion: Dienste können so konzipiert werden, dass sie diesen spezifischen Konfigurationstyp akzeptieren und die ordnungsgemäße IoC-Muster und Testbarkeit ermöglichen.

Beispiel

// Service declares explicit dependency on Claude configuration
class ClaudeService {
  constructor(private configProvider: IConfigurationProvider<ClaudeToolingConfiguration>) {}
}

// Future: Add Claude-specific settings without breaking changes
class ClaudeToolingConfiguration extends ToolingConfiguration {
  get claudeApiTimeout(): number { ... }
}
Extends
ToolingConfiguration

Konstruktoren

ClaudeToolingConfiguration(ToolingConfigurationOptions)

Eigenschaften

clusterCategory
isDevelopmentEnvironment

Ob es sich bei dem Cluster um eine Entwicklungsumgebung (lokal oder dev) handelt. Basierend auf clusterCategory.
isNodeEnvDevelopment

Gibt an, ob NODE_ENV den Entwicklungsmodus angibt. Gibt true zurück, wenn NODE_ENV "Development" ist (Groß-/Kleinschreibung wird nicht beachtet). Dies ist die Standard-Node.js Möglichkeit, den Entwicklungsmodus anzugeben.
mcpPlatformAuthenticationScope

Ruft den Authentifizierungsbereich der MCP-Plattform ab. Wird von AgenticAuthenticationService für den Tokenaustausch verwendet. Kürzet Leerzeichen, um Tokenaustauschfehler zu verhindern.
mcpPlatformEndpoint
useToolingManifest

Gibt an, ob die ToolingManifest.json-Datei anstelle der Gatewayermittlung verwendet werden soll. Gibt "true" zurück, wenn NODE_ENV auf "Development" (Groß-/Kleinschreibung) festgelegt ist oder wenn dies explizit über die Konfiguration außer Kraft gesetzt wird.

Geerbte Methoden

getBearerTokenForServer(string)

Gibt das Entwicklermodus-Bearertoken für einen MCP-Server anhand des Namens zurück. Überprüft zuerst BEARER_TOKEN_<SERVERNAME_UPPER> und greift dann auf BEARER_TOKEN zurück. Gibt nicht definiert zurück, wenn die Variable nicht festgelegt ist (kein Autorisierungsheader wird angefügt).
hasPerServerBearerToken(string)

Gibt true zurück, wenn ein env var (BEARER_TOKEN_<SERVERNAME_UPPER>) pro Server explizit für den angegebenen Server festgelegt wird, "false", wenn nur der freigegebene BEARER_TOKEN Fallback verwendet wird. Wird verwendet, um V2-Server zu erkennen, die im Entwicklermodus automatisch auf ein falsches Benutzergruppentoken zurückfallen.
parseEnvBoolean(undefined | string)

Analysieren Sie eine Umgebungsvariable als booleschen Wert. Erkennt 'true', '1', 'yes', 'on' (Groß-/Kleinschreibung) als wahr; alle anderen Werte als "false".
parseEnvInt(undefined | string, number)

Analysieren Sie eine Umgebungsvariable als ganze Zahl, und geben Sie Fallback zurück, wenn ungültig oder nicht festgelegt.

Details zum Konstruktor

ClaudeToolingConfiguration(ToolingConfigurationOptions) 

new ClaudeToolingConfiguration(overrides?: ToolingConfigurationOptions)

Parameter

overrides
ToolingConfigurationOptions

Details zur Eigenschaft

clusterCategory 

ClusterCategory clusterCategory

Eigenschaftswert

ClusterCategory

isDevelopmentEnvironment

Ob es sich bei dem Cluster um eine Entwicklungsumgebung (lokal oder dev) handelt. Basierend auf clusterCategory.

boolean isDevelopmentEnvironment

Eigenschaftswert

boolean

isNodeEnvDevelopment

Gibt an, ob NODE_ENV den Entwicklungsmodus angibt. Gibt true zurück, wenn NODE_ENV "Development" ist (Groß-/Kleinschreibung wird nicht beachtet). Dies ist die Standard-Node.js Möglichkeit, den Entwicklungsmodus anzugeben.

boolean isNodeEnvDevelopment

Eigenschaftswert

boolean

mcpPlatformAuthenticationScope

Ruft den Authentifizierungsbereich der MCP-Plattform ab. Wird von AgenticAuthenticationService für den Tokenaustausch verwendet. Kürzet Leerzeichen, um Tokenaustauschfehler zu verhindern.

string mcpPlatformAuthenticationScope

Eigenschaftswert

string

mcpPlatformEndpoint 

string mcpPlatformEndpoint

Eigenschaftswert

string

useToolingManifest

Gibt an, ob die ToolingManifest.json-Datei anstelle der Gatewayermittlung verwendet werden soll. Gibt "true" zurück, wenn NODE_ENV auf "Development" (Groß-/Kleinschreibung) festgelegt ist oder wenn dies explizit über die Konfiguration außer Kraft gesetzt wird.

boolean useToolingManifest

Eigenschaftswert

boolean

Details zur geerbten Methode

getBearerTokenForServer(string)

Gibt das Entwicklermodus-Bearertoken für einen MCP-Server anhand des Namens zurück. Überprüft zuerst BEARER_TOKEN_<SERVERNAME_UPPER> und greift dann auf BEARER_TOKEN zurück. Gibt nicht definiert zurück, wenn die Variable nicht festgelegt ist (kein Autorisierungsheader wird angefügt).

function getBearerTokenForServer(mcpServerName: string): undefined | string

Parameter

mcpServerName

string

Gibt zurück

undefined | string

Geerbt von ToolingConfiguration.getBearerTokenForServer

hasPerServerBearerToken(string)

Gibt true zurück, wenn ein env var (BEARER_TOKEN_<SERVERNAME_UPPER>) pro Server explizit für den angegebenen Server festgelegt wird, "false", wenn nur der freigegebene BEARER_TOKEN Fallback verwendet wird. Wird verwendet, um V2-Server zu erkennen, die im Entwicklermodus automatisch auf ein falsches Benutzergruppentoken zurückfallen.

function hasPerServerBearerToken(mcpServerName: string): boolean

Parameter

mcpServerName

string

Gibt zurück

boolean

Geerbt von ToolingConfiguration.hasPerServerBearerToken

parseEnvBoolean(undefined | string)

Analysieren Sie eine Umgebungsvariable als booleschen Wert. Erkennt 'true', '1', 'yes', 'on' (Groß-/Kleinschreibung) als wahr; alle anderen Werte als "false".

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

Parameter

envValue

undefined | string

Gibt zurück

boolean

Geerbt von ToolingConfiguration.parseEnvBoolean

parseEnvInt(undefined | string, number)

Analysieren Sie eine Umgebungsvariable als ganze Zahl, und geben Sie Fallback zurück, wenn ungültig oder nicht festgelegt.

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

Parameter

envValue

undefined | string

fallback

number

Gibt zurück

number

Geerbt von ToolingConfiguration.parseEnvInt