CLI-Referenz
DROID+ wird als einzelne Binärdatei mit einer Reihe von Unterbefehlen zur Verwaltung von KI-Agenten-Laufzeiten ausgeliefert.
droid
DROID+ — Headless KI-Agenten-Laufzeitumgebung. So wie nginx Websites bereitstellt, stellt DROID+ KI-Agenten bereit. Eine Binärdatei, eine Konfiguration, produktionsbereite Agenten in wenigen Minuten.
Verwendung:
droid [command]
Verfügbare Befehle:
| Befehl | Beschreibung |
|---|---|
init | Ein neues DROID+-Projekt initialisieren |
up | Die DROID+-Laufzeitumgebung starten |
down | Eine laufende DROID+-Instanz stoppen |
agents | Laufende Agenten auflisten |
agents reload | Agenten-Konfigurationen im laufenden Betrieb neu laden (Hot-Reload) |
health | Den Zustand des DROID+-Servers prüfen |
version | Versionsinformationen ausgeben |
Globale Flags:
| Flag | Beschreibung |
|---|---|
-h, --help | Hilfe für droid |
droid init
Erstellt ein neues Verzeichnis mit einer minimalen DROID+-Konfiguration, einem Beispiel-Agenten und einer .env-Vorlage.
Verwendung:
droid init [project-name]
Argumente:
project-name— Name des zu erstellenden Verzeichnisses (Standard:my-agent)
Beispiel:
droid init skincare-bot
cd skincare-bot
Erstellte Dateien:
droid.yaml— Hauptkonfigurationconfigs/agents/example.yaml— Beispiel-Agentenkonfiguration.env.example— Vorlage für Umgebungsvariablen
droid up
Startet die DROID+ KI-Agenten-Laufzeitumgebung mit OpenAI-kompatibler API und Management-API.
Verwendung:
droid up [flags]
Flags:
| Flag | Typ | Standard | Beschreibung |
|---|---|---|---|
--config, -c | string | auto-detect | Pfad zur Konfigurationsdatei |
--daemon, -d | bool | false | Im Hintergrund ausführen (verwenden Sie systemd/docker für die Produktion) |
Beispiele:
# Start mit automatisch erkannter Konfiguration
droid up
# Start mit spezifischer Konfigurationsdatei
droid up --config /etc/droid/droid.yaml
# Im Hintergrund starten
droid up -d
droid down
Sendet SIGTERM an den laufenden DROID+-Prozess unter Verwendung der PID-Datei.
Verwendung:
droid down
Beispiel:
droid down
droid agents
Fragt die Management-API ab, um alle geladenen Agenten und deren Status aufzulisten.
Verwendung:
droid agents [flags]
Flags:
| Flag | Typ | Standard | Beschreibung |
|---|---|---|---|
--port | int | 8081 | Port der Management-API |
Beispiel: |
# Agenten auf dem Standard-Port auflisten
droid agents
# Agenten auf einem benutzerdefinierten Management-Port auflisten
droid agents --port 9091
droid agents reload
Lädt Agenten-Konfigurationen neu, ohne die Laufzeitumgebung neu zu starten. Liest das Agentenverzeichnis und wendet alle Änderungen an.
Verwendung:
droid agents reload
Beispiel:
# Eine neue Agenten-YAML hinzufügen, dann neu laden
cp new-agent.yaml configs/agents/
droid agents reload
droid health
Prüft die Health-Endpunkte der OpenAI-kompatiblen API und der Management-API.
Verwendung:
droid health [flags]
Flags:
| Flag | Typ | Standard | Beschreibung |
|---|---|---|---|
--openai-port | int | 8080 | OpenAI API-Port |
--management-port | int | 8081 | Management API-Port |
Beispiel:
# Zustand auf Standard-Ports prüfen
droid health
# Zustand auf benutzerdefinierten Ports prüfen
droid health --openai-port 9080 --management-port 9081
droid version
Gibt DROID+-Versionsinformationen aus.
Verwendung:
droid version [flags]
Flags:
| Flag | Beschreibung |
|---|---|
--json | Ausgabe als JSON |
Beispiel:
droid version
# DROID+ v0.5.0 (community) built ...
droid version --json
# {"version":"0.5.0","edition":"community","commit":"...","build_time":"..."}