Lección 1: Bienvenido a BxAgents

Qué cubre este curso, qué vas a construir, y cómo está organizada cada lección.

Bienvenido a BxAgents

¡Bienvenido! Este es un curso de 20 lecciones sobre BxAgents, un framework de agentes de IA basado en convenciones para BoxLang, construido sobre ColdBox y BX AI.

La idea detrás de BxAgents es sencilla: describes un agente con archivos y carpetas, no con la superficie de API de un framework, y un solo comando - bxAgents build - ensambla con ello una aplicación ColdBox real y ejecutable.

my-agent/
├── Agent.bx           # name, model, description
├── instructions.md    # the system prompt
├── tools/             # @AITool functions
├── skills/            # SKILL.md capabilities
├── subagents/         # nested agent trees
├── models/            # named model configs
├── gateways/           # HTTP/MCP/chat exposure
├── schedules/          # a real ColdBox scheduler
├── mcp/                # MCP servers you host
├── interceptors/        # lifecycle hooks
└── modules/            # module dependencies

Todas las carpetas de arriba son opcionales excepto Agent.bx. Añade las que tu agente realmente necesite; el resto pueden quedarse vacías o simplemente no existir.

Cómo está organizado este curso

Las 20 lecciones siguen el orden en el que construirías de forma natural un proyecto real:

1. Lecciones 1-4 - orientación, instalación, y tu primer proyecto creado con el andamiaje.
2. Lecciones 5-8 - las piezas obligatorias: Agent.bx, las instrucciones, construir, y ejecutar el agente desde la terminal.
3. Lecciones 9-12 - dar capacidades a tu agente: tools, skills, subagentes y modelos con nombre.
4. Lecciones 13-16 - alcanzar tu agente: exposición HTTP/MCP, plataformas de chat, la UI web generada, y el trabajo programado en segundo plano.
5. Lecciones 17-18 - alojar tus propios servidores MCP, interceptores de ciclo de vida, y dependencias de módulos.
6. Lecciones 19-20 - probarlo de verdad, y después empaquetar y desplegar lo construido.

Qué necesitas

• Una terminal.
• Entre 30 y 60 minutos por lección si la sigues con las manos en el teclado (la mayoría funcionan bien también en modo lectura).
• No hace falta experiencia previa con BoxLang ni ColdBox - la lección 3 instala todo lo que necesitas.

Cada lección enlaza de vuelta a la referencia completa de Convenciones para todo lo que este curso solo resume - el curso es el camino guiado, y la sección de Convenciones es la referencia exhaustiva a la que volverás más adelante.

Siguiente: Lección 2 - ¿Qué es BxAgents?