Instalación
Las tres cosas que BX Agents necesita en la máquina que lo ejecuta.
On this page
Instalación
BX Agents es un módulo de BoxLang. Necesita tres cosas en la máquina que lo ejecuta:
- Un runtime de BoxLang.
- El módulo de BoxLang
bx-ai(BX Agents genera código que lo llama - no lo empaqueta él mismo). - BX Agents mismo.
serve adicionalmente necesita el binario independiente boxlang-miniserver en PATH. build, chat, package, inspect, clean, y new no lo necesitan.
Los destinos ftp/sftp de deploy necesitan el módulo de BoxLang bx-ftp instalado junto a bx-ai/BX Agents (install-bx-module bx-ftp) - una dependencia de runtime genuina, no empaquetada, la misma relación que este módulo tiene con bx-ai. Ningún otro verbo o destino de deploy lo necesita.
Sigue la guía de instalación oficial de BoxLang. El instalador rápido también configura ~/.boxlang/bin en tu PATH, que es donde aterrizan los ejecutables provistos por módulos (como el propio comando bxAgents de BX Agents, abajo).
install-bx-module bx-ai
install-bx-module bx-agents
Esto obtiene ambos módulos en tu directorio de módulos de BoxLang (~/.boxlang/modules por defecto, o boxlang_modules/ con --local).
bxAgents --version
bxAgents --help
--help lista los 10 verbos (new, build, test, serve, chat, invoke, package, deploy, inspect, clean) con un resumen de una línea de cada uno.
El comando bxAgents
BX Agents declara un ejecutable nativo en su box.json:
"boxlang": { "moduleName": "bxagents", "executable": "bxAgents" }
El instalador lo convierte en un script envoltorio bxAgents en tu PATH, así que puedes ejecutar:
bxAgents new my-agent --model=openai/gpt-5
en lugar de la forma más larga:
boxlang module:bxagents new my-agent --model=openai/gpt-5
Ambas son equivalentes - cada verbo despacha a través del mismo punto de entrada ModuleConfig.bx main(args) de cualquier manera. Este documento usa la forma corta bxAgents <verb> en todo momento.
Ver Inicio rápido para generar el andamiaje de tu primer agente.