Installation

Die drei Dinge, die BX Agents auf der ausführenden Maschine benötigt.

On this page

Installation

BX Agents ist ein BoxLang-Modul. Es braucht drei Dinge auf der Maschine, die es ausführt:

  1. Eine BoxLang-Runtime.
  2. Das BoxLang-Modul bx-ai (BX Agents generiert Code, der es aufruft - es vendort es nicht).
  3. BX Agents selbst.
Info

serve braucht zusätzlich die eigenständige Binärdatei boxlang-miniserver im PATH. build, chat, package, inspect, clean und new brauchen sie nicht.

Info

Die Ziele ftp/sftp von deploy benötigen das BoxLang-Modul bx-ftp, installiert neben bx-ai/BX Agents (install-bx-module bx-ftp) - eine echte Laufzeitabhängigkeit, nicht vendort, dieselbe Beziehung, die dieses Modul zu bx-ai hat. Kein anderes Verb oder Deploy-Ziel braucht es.

1
BoxLang installieren

Der offiziellen BoxLang-Installationsanleitung folgen. Der Schnellinstaller richtet auch ~/.boxlang/bin im PATH ein, wo modulseitig bereitgestellte Executables (wie BX Agents' eigener bxAgents-Befehl, unten) landen.

2
bx-ai und BX Agents installieren
install-bx-module bx-ai
install-bx-module bx-agents

Das holt beide Module in das eigene BoxLang-Modulverzeichnis (standardmäßig ~/.boxlang/modules, oder boxlang_modules/ mit --local).

3
Prüfen, ob es funktioniert hat
bxAgents --version
bxAgents --help

--help listet alle 10 Verben (new, build, test, serve, chat, invoke, package, deploy, inspect, clean) mit einer Einzeiler-Zusammenfassung jedes einzelnen.

Der bxAgents-Befehl

BX Agents deklariert ein natives Executable in seiner box.json:

"boxlang": { "moduleName": "bxagents", "executable": "bxAgents" }

Der Installer macht daraus ein bxAgents-Wrapper-Skript im PATH, sodass Folgendes ausgeführt werden kann:

bxAgents new my-agent --model=openai/gpt-5

statt der längeren Form:

boxlang module:bxagents new my-agent --model=openai/gpt-5

Beide sind gleichwertig - jedes Verb dispatcht so oder so über denselben Einstiegspunkt ModuleConfig.bx main(args). Diese Dokumentation verwendet durchgehend die kurze Form bxAgents <verb>.

Siehe Schnelleinstieg, um den ersten Agenten anzulegen.

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