BX Agents

Describe un agente en carpetas y archivos; constrúyelo en una aplicación ColdBox real.

overview
BX Agents - Build. Constrain. Orchestrate. A conventions-based agent framework for BoxLang. Conventions first: convention over configuration for faster development. Pluggable and extensible: swap models, tools, memory and more with ease. Powerful agents: create agents that reason, act, and collaborate effectively. Production ready: built for performance, reliability, and real-world applications. The agent framework native to BoxLang.
Comenzar Ver en GitHub

BX Agents 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 una API de framework - y bxAgents build ensambla una aplicación ColdBox real y ejecutable a partir de eso.

Ensamblado en tiempo de build

El descubrimiento, la validación y la generación de código se ejecutan una vez, no en cada arranque. Lo que ejecutas después es una aplicación ColdBox normal.

Las carpetas son la API

Agent.bx e instructions.md son los únicos archivos requeridos. Cada otra carpeta de convención es opcional y solo moldea la salida si existe.

Herramientas y skills

Coloca una función anotada con @AITool en tools/, o una carpeta SKILL.md en skills/ - ambas se descubren y conectan automáticamente por ti.

Agentes hasta el fondo

subagents/ anida exactamente el mismo árbol de convenciones, así que un equipo de especialistas es solo más carpetas - construido de hojas hacia la raíz.

Doce tipos de gateway

Telegram, Slack, Discord, Email, WhatsApp, Teams, Twilio, GitHub y Signal, además de http, cli y mock.

Una interfaz web de chat, generada

Pídela en Agent.bx y el build produce un front end de chat con streaming, personalizable, con historial de sesiones.

Construye uno en cuatro pasos

1
Instalar
install-bx-module bx-ai bx-agents

box install bx-ai,bx-agents
2
Generar el andamiaje
bxAgents new my-agent --model=openai/gpt-5

Luego edita instructions.md y añade las carpetas de convención que necesites.

3
Construir
bxAgents build

Descubrimiento, validación, manifest, generación de código - en .build/app/.

4
Háblale
bxAgents chat
# o sírvelo por HTTP:
bxAgents serve --port=8080

Lo que build realmente produce

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 hospedas
├── 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
¿Por qué ensamblar en tiempo de build en lugar de en tiempo de request?

La mayoría de los frameworks de agentes conectan herramientas, skills, rutas y programaciones en tiempo de request, en cada arranque. BX Agents hace lo contrario: bxAgents build ejecuta descubrimiento, validación y generación de código exactamente una vez, produciendo una aplicación ColdBox normal bajo .build/app/.

Iniciarla - vía bxAgents serve, un proceso real de boxlang-miniserver, o un .bxa portable desplegado en cualquier lugar donde corra BoxLang - es entonces solo arrancar una aplicación ordinaria. Sin escaneo de convenciones, sin recorrido dinámico de archivos, sin trabajo de tiempo de build diferido al camino del request.

Empieza con un solo archivo

Solo Agent.bx es requerido. instructions.md es opcional - configura las instrucciones directamente en la clase, o coloca el archivo y deja que el build lo conecte por ti. Cada otra carpeta solo afecta la salida generada si existe y tiene contenido en ella - así que agregas convenciones a medida que realmente las necesitas.

Agent.bx ES el agente

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. Ver Agent.bx.

Llega a él desde cualquier lugar

Plataformas de chat

Nueve gateways de estilo push - Telegram, Slack, Discord, Email, WhatsApp Cloud, Teams, Twilio, GitHub y Signal - coordinados por una sesión con políticas queue / steer / interrupt.

HTTP y MCP

Expón el agente sobre rutas HTTP, u hospeda servidores MCP locales desde mcp/ para que otros clientes puedan llamar a tus herramientas.

Envíalo

Empaqueta un .bxa portable y despliégalo con local, ssh, docker, digitalocean, ftp o sftp - los secretos permanecen como variables de entorno, nunca como artefactos de build.

A dónde ir después

Instalación

Instala BoxLang, BX AI y BX Agents.

Inicio rápido

Genera el andamiaje, construye y habla con tu primer agente.

Convenciones

Una página por carpeta de convención, de principio a fin.

El pipeline de build

Exactamente qué hace build, en orden.

Referencia de CLI

Cada verbo y sus flags.

Despliegue y secretos

Empaqueta un .bxa y envíalo, de forma segura.

Cada carpeta de convención también tiene una muestra funcional y construible en examples/.

Warning

BX Agents está en desarrollo activo. Limitaciones conocidas rastrea los vacíos honestos - qué se ha probado contra una aplicación real en ejecución, qué todavía solo corre contra el proveedor "mock" de BX AI, y una peculiaridad real y ascendente de ColdBox con la que este proyecto se topó y solucionó.

Edit this page Download Markdown Last updated Aug 21, 2026, 6:33:28 PM