Référence CLI
DROID+ est livré sous la forme d'un binaire unique avec un ensemble de sous-commandes pour gérer les moteurs d'exécution des agents IA.
droid
DROID+ — Moteur d'exécution d'agents IA headless. Tout comme nginx sert des sites web, DROID+ sert des agents IA. Un binaire, une config, des agents prêts pour la production en quelques minutes.
Utilisation :
droid [command]
Commandes disponibles :
| Commande | Description |
|---|---|
init | Initialiser un nouveau projet DROID+ |
up | Démarrer le moteur d'exécution DROID+ |
down | Arrêter une instance DROID+ en cours d'exécution |
agents | Lister les agents en cours d'exécution |
agents reload | Rechargement à chaud des configurations des agents |
health | Vérifier l'état de santé du serveur DROID+ |
version | Afficher les informations de version |
Flags globaux :
| Flag | Description |
|---|---|
-h, --help | Aide pour droid |
droid init
Créer un nouveau répertoire avec une configuration DROID+ minimale, un exemple d'agent et un modèle .env.
Utilisation :
droid init [project-name]
Arguments :
project-name— Nom du répertoire à créer (par défaut :my-agent)
Exemple :
droid init skincare-bot
cd skincare-bot
Fichiers créés :
droid.yaml— Configuration principaleconfigs/agents/example.yaml— Configuration de l'agent d'exemple.env.example— Modèle de variables d'environnement
droid up
Démarrer le moteur d'exécution des agents IA DROID+ avec l'API compatible OpenAI et l'API de gestion.
Utilisation :
droid up [flags]
Flags :
| Flag | Type | Par défaut | Description |
|---|---|---|---|
--config, -c | string | auto-détection | Chemin vers le fichier de configuration |
--daemon, -d | bool | false | Exécuter en arrière-plan (utiliser systemd/docker pour la production) |
Exemples :
# Démarrer avec la configuration auto-détectée
droid up
# Démarrer avec un fichier de configuration spécifique
droid up --config /etc/droid/droid.yaml
# Démarrer en arrière-plan
droid up -d
droid down
Envoyer SIGTERM au processus DROID+ en cours d'exécution en utilisant le fichier PID.
Utilisation :
droid down
Exemple :
droid down
droid agents
Interroger l'API de gestion pour lister tous les agents chargés et leur statut.
Utilisation :
droid agents [flags]
Flags :
| Flag | Type | Par défaut | Description |
|---|---|---|---|
--port | int | 8081 | Port de l'API de gestion |
Exemple :
# Lister les agents sur le port par défaut
droid agents
# Lister les agents sur un port de gestion personnalisé
droid agents --port 9091
droid agents reload
Rechargement à chaud des configurations des agents sans redémarrer le moteur d'exécution. Lit le répertoire des agents et applique les modifications.
Utilisation :
droid agents reload
Exemple :
# Ajouter un nouveau YAML d'agent, puis recharger
cp new-agent.yaml configs/agents/
droid agents reload
droid health
Sonder les points de terminaison de santé de l'API compatible OpenAI et de l'API de gestion.
Utilisation :
droid health [flags]
Flags :
| Flag | Type | Par défaut | Description |
|---|---|---|---|
--openai-port | int | 8080 | Port de l'API OpenAI |
--management-port | int | 8081 | Port de l'API de gestion |
Exemple :
# Vérifier la santé sur les ports par défaut
droid health
# Vérifier la santé sur des ports personnalisés
droid health --openai-port 9080 --management-port 9081
droid version
Afficher les informations de version de DROID+.
Utilisation :
droid version [flags]
Flags :
| Flag | Description |
|---|---|
--json | Sortie au format JSON |
Exemple :
droid version
# DROID+ v0.5.0 (community) built ...
droid version --json
# {"version":"0.5.0","edition":"community","commit":"...","build_time":"..."}