BxAgents
Construye agentes de IA por convención — un framework basado en convenciones para agentes de IA con BoxLang AI.
BxAgents es un framework de agentes de IA basado en convenciones para BoxLang,
construido sobre ColdBox y
BX AI. Describes un agente
con archivos y carpetas - no con la superficie de API de un framework - y bxAgents build
ensambla con ello una aplicación ColdBox real y ejecutable.
El descubrimiento, la validación y la generación de código se ejecutan una sola vez, no en cada arranque. Lo que ejecutas después es una aplicación ColdBox normal.
Agent.bx e instructions.md son los únicos archivos obligatorios. Cualquier otra carpeta
de convención es opcional y solo da forma a la salida si existe.
Coloca una función anotada con @AITool en tools/, o una carpeta con SKILL.md en
skills/ - ambas se descubren y se cablean por ti.
subagents/ anida exactamente el mismo árbol de convenciones, asà que un equipo de
especialistas son simplemente más carpetas - construidas de la hoja hacia la raÃz.
Telegram, Slack, Discord, Email, WhatsApp, Teams, Twilio, GitHub y Signal, además de http,
cli y mock.
PÃdela en Agent.bx y el build produce un front end de chat con streaming, tematizable y
con historial de sesión.
Construye uno en cuatro pasos
install-bx-module bx-ai bx-agents
box install bx-ai,bx-agents
bxAgents new my-agent --model=openai/gpt-5
Después edita instructions.md y añade las carpetas de convención que necesites.
bxAgents build
Descubrimiento, validación, manifiesto y generación de código - dentro de .build/app/.
bxAgents chat
# o sÃrvelo sobre HTTP:
bxAgents serve --port=8080
Empieza desde algo, no desde cero
new no solo crea el andamiaje de un agente vacÃo - elige una de las 8 plantillas
integradas, clona un repositorio de GitHub existente, o instala un paquete de ForgeBox.
--template=webui-chat|slack-bot|telegram-bot|github-bot|mcp-server|scheduled|multi-agent -
contenido real y funcional sobre el mismo esqueleto base.
--repo=owner/repo - un cliente JGit incluido lo clona; no hace falta el binario git.
--forgebox=<slug> - habla directamente con la API REST de ForgeBox; no hace falta la CLI box.
Consulta Plantillas de agentes para ver en detalle cada archivo generado, y cómo publicar las tuyas.
Una UI de chat que no tuviste que construir
Pon exposes: "webui" en un gateway y el build emite un front end completo - historial de
conversaciones, respuestas en streaming, temas claro/oscuro y una disposición móvil -
conectado a tu agente.
Es CSS generado y marcado generado - tematizable desde Agent.bx,
sin ningún paso de build de front end por tu parte.
Qué produce realmente build
Tu árbol de convenciones, y la aplicación ColdBox normal en la que build lo convierte.
your-agent/
├── Agent.bx # nombre, modelo, descripción
├── instructions.md # el system prompt
├── tools/ # funciones @AITool
├── skills/ # capacidades SKILL.md
├── subagents/ # árboles de agentes anidados
├── models/ # configuraciones de modelo con nombre
├── gateways/ # exposición HTTP/MCP/chat
├── schedules/ # un scheduler ColdBox real
├── mcp/ # servidores MCP que alojas
├── interceptors/ # hooks de ciclo de vida
└── modules/ # dependencias de módulos
.build/app/
├── Application.bx
├── config/
│ ├── ColdBox.bx
│ ├── WireBox.bx
│ ├── Router.bx
│ └── Scheduler.bx
├── agent/
│ └── GeneratedAgentFactory.bx
├── tools/ skills/ mcp/
├── handlers/ interceptors/
└── index.bxm
Solo Agent.bx es obligatorio. instructions.md es opcional - define las instrucciones
directamente en la clase, o coloca el archivo y deja que el build lo conecte. Cualquier
otra carpeta solo afecta a la salida generada si existe y tiene contenido - asà que
añades convenciones a medida que realmente las necesitas.
Agent.bx extiende directamente el propio AiAgent de BX AI - el build instancia tu
clase en lugar de reconstruir una a partir de un struct de configuración, asà que lo que
escribes es lo que se ejecuta, y un IDE puede introspeccionarla como cualquier otra
clase. Consulta Agent.bx.
Alcánzalo desde cualquier sitio
Nueve gateways de tipo push - Telegram, Slack, Discord, Email, WhatsApp Cloud, Teams, Twilio,
GitHub y Signal - coordinados por una sola sesión con polÃticas queue / steer / interrupt.
Expón el agente mediante rutas HTTP, o aloja servidores MCP locales desde mcp/ para que
otros clientes puedan llamar a tus tools.
Empaqueta un .bxa portable y despliégalo con local, ssh, docker, digitalocean,
ftp o sftp - los secretos siguen siendo variables de entorno, nunca artefactos de build.
Comprueba tu instalación en cualquier momento
Dónde ir a continuación
Instala BoxLang, BX AI y BxAgents.
Crea el andamiaje, construye y chatea con tu primer agente.
Una página por carpeta de convención, de principio a fin.
Exactamente qué hace build, y en qué orden.
Cada verbo y sus flags.
Cada plantilla integrada, el origen desde GitHub/ForgeBox, y cómo publicar la tuya.
Empaqueta un .bxa y publÃcalo, de forma segura.
Cada carpeta de convención tiene además un ejemplo funcional y construible bajo
examples/.
BxAgents está en desarrollo activo. Limitaciones conocidas recoge
las carencias con honestidad - qué está probado contra una aplicación real en ejecución,
qué sigue ejecutándose solo contra el proveedor "mock" de BX AI, y una peculiaridad real
de ColdBox con la que este proyecto se topó y que tuvo que sortear.