docs: update README with from_git deployment and script skill

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-03-15 19:54:23 +00:00
parent 52eefac295
commit c9ac43c9bc
+32 -14
View File
@@ -1,6 +1,6 @@
# agent_deploy
Agent de déploiement d'agents IA sur des serveurs distants via SSH. Installe, configure et démarre de nouveaux agents sur des machines cibles à partir d'un catalogue.
Agent de déploiement d'agents IA sur des serveurs distants ou en local via SSH. Installe, configure et démarre de nouveaux agents à partir d'un catalogue ou directement depuis une URL git.
## Rôle
@@ -20,20 +20,42 @@ systemctl enable --now agent_deploy
| Skill | Description |
|-------|-------------|
| `deploy` | Déploie un agent sur un serveur distant via SSH |
| `deploy` | Déploie un agent depuis le catalogue sur un serveur distant (SSH) |
| `catalog` | Consulte le catalogue des agents déployables |
| `ssh` | Connexion SSH et exécution de commandes distantes |
| `script` | Bibliothèque de scripts bash (save/list/show/exec/run/delete) |
| `agents_status` | Statut des agents du système |
| `mqtt_send` | Publication sur un topic MQTT |
| `mqtt_subscribe` | Souscription dynamique à un topic MQTT |
| `muc_send` | Message dans le groupe XMPP |
## Modes de déploiement
### Depuis le catalogue
```
"Déploie un agent debian sur le serveur 10.0.0.5"
"Installe un nouvel agent ansible sur srv-infra-01"
```
### Depuis une URL git (distant)
```
SKILL:deploy ARGS:from_git <git_url> <nom> <host> <user> password|key <credential> <xmpp_jid> <xmpp_pass> <mqtt_host> [main_script]
```
### Depuis une URL git (local)
```
SKILL:deploy ARGS:from_git_local <git_url> <nom> <xmpp_jid> <xmpp_pass> <mqtt_host> [main_script]
```
L'agent détecte automatiquement le script principal dans ce ordre : `agent_*.py` > `main.py` > fichier avec `if __name__ == "__main__"` > premier `.py`.
## Structure
```
agent_deploy.py — Point d'entrée
deployer.py — Logique de déploiement (AgentCatalog)
skills/ — 7 skills
deployer.py — Logique de déploiement (AgentCatalog + from_git)
skills/ — 8 skills
scripts/ — Scripts bash persistants
config/
config.json — Configuration
system_prompt.txt — Prompt système
@@ -56,14 +78,16 @@ agent_deploy.service — Unit systemd
"mqtt": { "host": "localhost", "port": 1883 },
"llm": {
"base_url": "http://192.168.7.119:11434",
"model": "ministral-3:latest",
"model": "qwen3:8b",
"temperature": 0.3
},
"llm_profiles": {
"local": "ministral-3:latest",
"local": "qwen3:8b",
"cloud": "gpt-oss:120b-cloud"
},
"catalog": "/opt/agent_deploy/config/catalog.json"
"catalog": "/opt/agent_deploy/config/catalog.json",
"use_omemo": true,
"use_llm_coordinator": true
}
```
@@ -73,13 +97,7 @@ agent_deploy.service — Unit systemd
/catalog — Liste les agents disponibles dans le catalogue
/report — Statistiques de déploiement
/status — État de la queue de tâches
```
## Exemples de tâches (via Nexus)
```
"Déploie un agent debian sur le serveur 10.0.0.5"
"Installe un nouvel agent ansible sur srv-infra-01"
/script — Gestion de la bibliothèque de scripts bash
```
> **Note** : l'agent demande toujours confirmation de l'hôte cible. Ne jamais inventer un nom de serveur.