Introducción a BxAgents
Un curso de 20 lecciones, desde "qué es BxAgents" hasta un agente multicanal desplegado.
Introducción a BxAgents
Veinte lecciones, de principio a fin: instala la CLI, crea el andamiaje de un proyecto,
entiende Agent.bx, conecta tools, skills y subagentes, expón tu agente por HTTP y a
plataformas de chat, publica la UI web generada, programa trabajo en segundo plano, pruébalo de
verdad, y empaquétalo y despliégalo. Cada lección enlaza de vuelta a la referencia completa de
Convenciones para la inmersión profunda - este curso es el camino
guiado a través de ella.
Cada lección guarda tu progreso en este navegador (sin necesidad de cuenta) - visita una lección y queda marcada como leÃda, y Continuar donde lo dejaste, más abajo, retoma justo donde paraste.
- Lección 1: Bienvenido a BxAgentsQué cubre este curso, qué vas a construir, y cómo está organizada cada lección.
- Lección 2: ¿Qué es BxAgents?Por qué convenciones en lugar de configuración, y por qué el ensamblado ocurre una sola vez en tiempo de build.
- Lección 3: Instalar BxAgentsInstala BoxLang, bx-ai y BxAgents, y comprueba que el comando bxAgents funciona.
- Lección 4: Crear el andamiaje de tu primer agenteEjecuta bxAgents new y mira exactamente qué te crea.
- Lección 5: Agent.bx - el agente en síEl único archivo obligatorio - una clase real que el build instancia, no un struct de configuración.
- Lección 6: instructions.md y el system promptEl archivo opcional que se convierte en el system prompt de tu agente.
- Lección 7: Construir tu agentebxAgents build y el pipeline de cinco fases que convierte tu proyecto en una aplicación.
- Lección 8: Hablar con tu agentechat, invoke y serve - tres formas de ejecutar exactamente el mismo agente construido.
- Lección 9: Dar tools a tu agenteCualquier función anotada con @AITool bajo tools/ se convierte en una tool invocable.
- Lección 10: Empaquetar skillsClaude Agent Skills - una subcarpeta por SKILL.md, cargadas bajo demanda.
- Lección 11: Componer subagentesAgentes anidados, cada uno un proyecto BxAgents corriente por sí mismo, cableados como tools invocables.
- Lección 12: Configuraciones de modelo con nombreConfiguraciones de modelo reutilizables y con nombre, referenciadas desde Agent.bx por su nombre.
- Lección 13: Exponer tu agente por HTTP y MCPLas entradas de gateways/ con una clave exposes convierten tu agente en una ruta HTTP real.
- Lección 14: Conectar plataformas de chatGateways adaptadores de canal - nueve plataformas de chat más http/cli/mock, todos en una GatewaySession.
- Lección 15: La UI web de chat generadaUn cliente de chat completo para navegador - barra lateral, streaming, aprobaciones, almacén SQLite.
- Lección 16: Programar trabajo en segundo planoschedules/Scheduler.bx - un scheduler ColdBox real, escrito a mano, que pasa intacto.
- Lección 17: Alojar y consumir servidores MCPMCP en ambos sentidos - consume servidores remotos desde Agent.bx, aloja los tuyos bajo mcp/.
- Lección 18: Interceptores y dependencias de módulosHooks de ciclo de vida de ColdBox acotados con @scope, y dependencias de módulos de BoxLang bajo modules/.
- Lección 19: Probar tu agenteUna suite TestBox lista para ejecutar, mockResponses(), y matchers pensados para el comportamiento de agentes.
- Lección 20: Empaquetar, desplegar y cerrarEmpaqueta un .bxa, envíalo a un destino real, y hacia dónde seguir desde aquí.
Para quién es esto
Para cualquiera que quiera construir un agente de IA sin cablear a mano la superficie de API de
un framework - describes un agente con archivos y carpetas, y bxAgents build ensambla con
ello una aplicación ColdBox real y ejecutable. No se presupone
experiencia previa con BoxLang ni ColdBox, aunque ayuda.
Qué habrás construido al llegar a la Lección 20
Un agente con sus propias tools y una skill empaquetada, accesible desde la CLI, desde una UI
de chat en el navegador y desde una API HTTP, con una suite de pruebas que se ejecuta sin
ninguna clave de API, y un .bxa empaquetado listo para desplegar.
¿Listo? Empieza con la Lección 1: Bienvenido a BxAgents.