Lección 4: Crear el andamiaje de tu primer agente

Ejecuta bxAgents new y mira exactamente qué te crea.

Crear el andamiaje de tu primer agente

Con BoxLang, bx-ai y BxAgents instalados (Lección 3), crea el andamiaje de tu primer proyecto:

bxAgents new my-agent --model=openai/gpt-5

--model es obligatorio - un slug provider/model (verás exactamente cómo se interpreta en la Lección 5). --name y --description son opcionales; --name toma por defecto el nombre del propio directorio de destino. new se niega a ejecutarse si el destino ya contiene un Agent.bx.

Qué se crea

my-agent/
├── Agent.bx
├── instructions.md
├── tools/
├── skills/
├── subagents/
├── models/
├── gateways/
├── schedules/
├── mcp/
├── interceptors/
├── modules/
└── tests/
    ├── box.json
    └── specs/
        └── AgentSpec.bx

Más un .env que declara BOXLANG_HOME=.build/runtime (coincidiendo con el propio directorio de runtime acotado de serve) y un .gitignore (.build/, dist/, .env) - new nunca sobrescribe ninguno de los dos si ya existen.

Todas las carpetas de convención se crean vacías. Añades archivos a las que tu agente realmente necesita y dejas el resto en paz - una carpeta tools/ vacía no tiene ningún efecto sobre la aplicación generada.

Agent.bx tiene este aspecto

class extends="bxModules.bxai.models.runnables.AiAgent" {

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

}

extends directamente el propio AiAgent de bx-ai - más sobre qué significa eso exactamente en la Lección 5.

La suite de pruebas se prepara sola

new también ejecuta box install dentro de la carpeta tests/ creada, de modo que bxAgents test (Lección 19) funciona de inmediato sin ningún paso aparte. Esto es de mejor esfuerzo - si box no está en el PATH o la instalación falla, new sigue teniendo éxito y simplemente te dice que lo ejecutes tú. Pasa --skipInstall para desactivarlo por completo.

Pruébalo

bxAgents new my-agent --model=openai/gpt-5
cd my-agent
ls

Ya tienes un proyecto BxAgents real, aunque mínimo. Las cuatro lecciones siguientes recorren lo que hace falta de verdad para ejecutarlo.

Siguiente: Lección 5 - Agent.bx: el agente en sí