OpenAIProviders

Resumen

The OpenAIProviders class manages AI provider configurations by loading configuration and handling resolution of model strings in the provider:model format.

For complete usage documentation, see Provider Model Aliases.

Descripción

This class enables multi-provider support by:

• Loading provider configurations from a single JSON file
• la carga de los alias de modelos con nombre que se asignan a proveedores y a los identificadores de modelos
• la resolución de la sintaxis provider:model en configuración completa de la API
• Resolving named model aliases by bare name to full provider + model configurations

The OpenAI class automatically loads provider configurations when instantiated.

Constructor

var $providers := cs.AIKit.OpenAIProviders.new()

Creates a new instance that loads provider configuration from the AIProviders.json file (see Configuration Files in the "Provider Model Aliases" page for details on file locations and format).

Important:

• Only the first existing file is loaded. There is no merging of multiple files.
• La configuración se lee una vez en el momento de la instanciación. Si el archivo AIProviders.json se modifica posteriormente, esos cambios no se reflejarán en la instancia existente. Debe crear una nueva instancia de OpenAIProviders para recargar la configuración actualizada.

Utilización

Integración con la clase OpenAI

var $client := cs.AIKit.OpenAI.new()

// Use model aliases with provider:model syntax
var $result := $client.chat.completions.create($messages; {model: "openai:gpt-5.1"})
var $result := $client.chat.completions.create($messages; {model: "anthropic:claude-3-opus"})
var $result := $client.chat.completions.create($messages; {model: "local:llama3"})

Acceso directo de proveedores

var $providers := cs.AIKit.OpenAIProviders.new()

// Get a specific provider configuration
var $config := $providers.get("openai")
// Returns: {baseURL: "...", apiKey: "...", modelAliases: [...], ...} or Null

// Get all provider names
var $names := $providers.list()
// Returns: ["openai", "anthropic", "mistral", "local"]

Funciones

get()

get(name : Text) : Object

Get a provider configuration by name.

Parámetros	Tipo	Descripción
name	Text	El nombre del proveedor
Resultado	Object	Objeto de configuración del proveedor, o Null si no se encuentra

Ejemplo

var $config := $providers.get("openai")
If ($config # Null)
    // Use $config.baseURL, $config.apiKey, etc.

    // We could build a client with it
    var $client:=cs.AIKit.OpenAI.new($config)
End if

lista()

list() : Collection

Obtener todos los nombres de proveedores.

Parámetros	Tipo	Descripción
Resultado	Collection	Colección de nombres de proveedores

Ejemplo

var $names := $providers.list()
// Devuelve: ["openai", "anthropic", ...]

For each ($name; $names)
    var $config := $providers.get($name)
End for each

modelAliases()

modelAliases() : Collection

Recuperar todos los alias de modelo configurados.

Parámetros	Tipo	Descripción
Resultado	Collection	Colección de objetos de alias de modelos

Each object in the collection contains:

Propiedad	Tipo	Descripción
name	Text	Nombre del alias del modelo
proveedor	Text	Nombre del proveedor
model	Text	ID del modelo a utilizar con el proveedor

Ejemplo

var $models := $providers.modelAliases()
// Returns: [{name: "my-gpt", provider: "openai", model: "gpt-5.1"}, ...]

For each ($model; $models)
    // $m.name, $m.provider, $m.model
End for each

Resolución del modelo

Two syntaxes are supported for model resolution:

Alias de proveedor (provider:model)

Specify the provider and model name directly:

var $client := cs.AIKit.OpenAI.new()
$client.chat.completions.create($messages; {model: "openai:gpt-5.1"})

Esto se resuelve internamente:

1. Separación "openai:gpt-5.1" en provider="openai" y model="gpt-5.1".
2. Look up the "openai" provider configuration
3. Extracción de baseURL y apiKey
4. Haga la solicitud de API utilizando la configuración resuelta

Ejemplos:

• "openai:gpt-5.1" → Utilizar el proveedor OpenAI con el modelo gpt-5.1
• "anthropic:claude-3-opus" → Utiliza el proveedor Anthropic con claude-3-opus
• "local:llama3" → Use local provider with llama3 model

Alias de modelo (nombre simple)

Use a named model by its bare name from the models section of the configuration:

var $client := cs.AIKit.OpenAI.new()
$client.chat.completions.create($messages; {model: ":my-gpt"})

Esto se resuelve internamente:

1. Look up "my-gpt" in the models configuration
2. Recuperación de su provider (por ejemplo, "openai") y de su model (por ejemplo, "gpt-5.1")
3. Resolución del proveedor para obtener baseURL y apiKey
4. Haga la solicitud de API utilizando la configuración resuelta

Ejemplos:

• "my-gpt" → Utilizar el alias de modelo "my-gpt" (resuelve a su proveedor y modelo configurados)
• "my-embedding" → Usar el alias del modelo "my-embedding" para las operaciones de embebido