OpenAIToolingConfiguration class
Configuración del paquete de extensión de herramientas de OpenAI. Hereda todas las herramientas y la configuración del entorno de ejecución.
¿Por qué existe esta clase?
Aunque esta clase actualmente no agrega ninguna nueva configuración más allá de lo que proporciona ToolingConfiguration, existe por varias razones importantes:
Seguridad de tipos: permite que los servicios específicos de OpenAI declaren su dependencia en
IConfigurationProvider<OpenAIToolingConfiguration>, lo que hace que el contrato de configuración sea explícito y habilite la comprobación en tiempo de compilación.Punto de extensión: proporciona un lugar claro para agregar configuraciones específicas de OpenAI (por ejemplo, tiempos de espera del SDK de agentes, intervalos de sondeo de subprocesos, límites de ejecución) sin interrumpir el código existente cuando surjan esas necesidades.
Patrón coherente: mantiene la simetría con otros paquetes de extensión (Claude, LangChain), lo que facilita la comprensión y navegación del SDK.
Inserción de dependencias: los servicios se pueden diseñar para aceptar este tipo de configuración específico, lo que permite los patrones de IoC adecuados y la capacidad de prueba.
Ejemplo
// Service declares explicit dependency on OpenAI configuration
class OpenAIService {
constructor(private configProvider: IConfigurationProvider<OpenAIToolingConfiguration>) {}
}
// Future: Add OpenAI-specific settings without breaking changes
class OpenAIToolingConfiguration extends ToolingConfiguration {
get threadPollingInterval(): number { ... }
}
- Extends
Constructores
| Open |
Propiedades
| cluster |
|
| is |
Si el clúster es un entorno de desarrollo (local o de desarrollo). Basado en clusterCategory. |
| is |
Si NODE_ENV indica el modo de desarrollo. Devuelve true cuando NODE_ENV es "development" (sin distinción entre mayúsculas y minúsculas). Esta es la forma estándar Node.js de indicar el modo de desarrollo. |
| mcp |
Obtiene el ámbito de autenticación de la plataforma MCP. Usado por AgenticAuthenticationService para el intercambio de tokens. Recorta el espacio en blanco para evitar errores de intercambio de tokens. |
| mcp |
|
| use |
Si se debe usar el archivo ToolingManifest.json en lugar de la detección de puerta de enlace. Devuelve true cuando NODE_ENV se establece en "desarrollo" (sin distinción entre mayúsculas y minúsculas) o cuando se invalida explícitamente a través de la configuración. |
Métodos heredados
| parse |
Analice una variable de entorno como un valor booleano. Reconoce 'true', '1', 'sí', 'on' (sin distinción entre mayúsculas y minúsculas) como true; todos los demás valores como false. |
| parse |
Analice una variable de entorno como un entero y devuelva la reserva si no es válida o no está establecida. |
Detalles del constructor
OpenAIToolingConfiguration(ToolingConfigurationOptions)
new OpenAIToolingConfiguration(overrides?: ToolingConfigurationOptions)Parámetros
- overrides
- ToolingConfigurationOptions
Detalles de las propiedades
clusterCategory
isDevelopmentEnvironment
Si el clúster es un entorno de desarrollo (local o de desarrollo). Basado en clusterCategory.
boolean isDevelopmentEnvironmentValor de propiedad
boolean
isNodeEnvDevelopment
Si NODE_ENV indica el modo de desarrollo. Devuelve true cuando NODE_ENV es "development" (sin distinción entre mayúsculas y minúsculas). Esta es la forma estándar Node.js de indicar el modo de desarrollo.
boolean isNodeEnvDevelopmentValor de propiedad
boolean
mcpPlatformAuthenticationScope
Obtiene el ámbito de autenticación de la plataforma MCP. Usado por AgenticAuthenticationService para el intercambio de tokens. Recorta el espacio en blanco para evitar errores de intercambio de tokens.
string mcpPlatformAuthenticationScopeValor de propiedad
string
mcpPlatformEndpoint
string mcpPlatformEndpointValor de propiedad
string
useToolingManifest
Si se debe usar el archivo ToolingManifest.json en lugar de la detección de puerta de enlace. Devuelve true cuando NODE_ENV se establece en "desarrollo" (sin distinción entre mayúsculas y minúsculas) o cuando se invalida explícitamente a través de la configuración.
boolean useToolingManifestValor de propiedad
boolean
Detalles de los métodos heredados
parseEnvBoolean(undefined | string)
Analice una variable de entorno como un valor booleano. Reconoce 'true', '1', 'sí', 'on' (sin distinción entre mayúsculas y minúsculas) como true; todos los demás valores como false.
static function parseEnvBoolean(envValue: undefined | string): booleanParámetros
- envValue
-
undefined | string
Devoluciones
boolean
Heredado de ToolingConfiguration.parseEnvBoolean
parseEnvInt(undefined | string, number)
Analice una variable de entorno como un entero y devuelva la reserva si no es válida o no está establecida.
static function parseEnvInt(envValue: undefined | string, fallback: number): numberParámetros
- envValue
-
undefined | string
- fallback
-
number
Devoluciones
number
Heredado de ToolingConfiguration.parseEnvInt