models/

Configuraciones de modelo reutilizables y nombradas, referenciadas desde Agent.bx por nombre.

models/

models/ te permite definir configuraciones de modelo reutilizables y nombradas como un archivo .bx o .json cada una, referenciadas desde el campo model de Agent.bx por nombre (sin /, así no se confunde con un slug provider/model):

// models/summarizer.bx
class {

	function configure() {
		return {
			provider : "openai",
			model    : "gpt-5-mini"
		};
	}

}

// Agent.bx
class extends="bxModules.bxai.models.runnables.AiAgent" {

	function init() {
		super.init( name: "my-agent", model: aiModel( provider: "openai", params: { model: "gpt-5-mini" } ) )
		return this
	}

	// Sobreescribe el propio modelo de la clase de arriba - se resuelve contra models/summarizer.bx
	function configure() {
		return {
			model : "summarizer"
		};
	}

}

Reglas de descubrimiento

• Una entrada por cada archivo .bx o .json de nivel superior directamente bajo models/ (no recursivo).
• El nombre de la entrada es el nombre base del archivo (summarizer.bx → summarizer).
• Los dotfiles y los archivos con una extensión no reconocida (como un README.md dejado en la carpeta para tus propias notas) se ignoran.
• Dos archivos que resuelven al mismo nombre fallan la validación con un error de nombre duplicado.

Validación

Si el model de Agent.bx no tiene /, debe ser ya sea un nombre de proveedor central conocido (ver Agent.bx) o coincidir con el nombre de una entrada de models/ - cualquier otra cosa falla la validación con un error claro de "no provider and does not match any models/ entry".