From c9ac43c9bc0b6434953c186028cf0a5c6a80e77c Mon Sep 17 00:00:00 2001 From: sylvain Date: Sun, 15 Mar 2026 19:54:23 +0000 Subject: [PATCH] docs: update README with from_git deployment and script skill Co-Authored-By: Claude Sonnet 4.6 --- README.md | 46 ++++++++++++++++++++++++++++++++-------------- 1 file changed, 32 insertions(+), 14 deletions(-) diff --git a/README.md b/README.md index 12f7398..689e580 100644 --- a/README.md +++ b/README.md @@ -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 password|key [main_script] +``` + +### Depuis une URL git (local) +``` +SKILL:deploy ARGS:from_git_local [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.