docs: update README with script library

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-03-15 19:54:20 +00:00
parent b70e95b71f
commit 9657d50e1e
+23 -5
View File
@@ -4,7 +4,7 @@ Agent d'administration système. Gère les paquets, services, processus, fichier
## Rôle ## Rôle
Toutes les tâches système sur **ce serveur** passent par cet agent : `apt install`, `systemctl restart`, surveillance disque/RAM, consultation des logs, gestion des crons, etc. Toutes les tâches système sur **ce serveur** passent par cet agent : `apt install`, `systemctl restart`, surveillance disque/RAM, consultation des logs, gestion des crons, exécution de scripts, etc.
## Installation ## Installation
@@ -23,7 +23,7 @@ systemctl enable --now agent_debian
| `apt` | Gestion des paquets (install, remove, update, upgrade, search) | | `apt` | Gestion des paquets (install, remove, update, upgrade, search) |
| `systemd` | Contrôle des services (start, stop, restart, status, enable) | | `systemd` | Contrôle des services (start, stop, restart, status, enable) |
| `shell` | Exécution de commandes shell arbitraires | | `shell` | Exécution de commandes shell arbitraires |
| `script` | Exécution de scripts multi-lignes | | `script` | Bibliothèque de scripts bash (save/list/show/exec/run/delete) |
| `sysinfo` | CPU, RAM, disque, uptime | | `sysinfo` | CPU, RAM, disque, uptime |
| `process` | Liste, kill, surveillance des processus | | `process` | Liste, kill, surveillance des processus |
| `filesystem` | Lecture, écriture, liste, recherche de fichiers | | `filesystem` | Lecture, écriture, liste, recherche de fichiers |
@@ -37,6 +37,20 @@ systemctl enable --now agent_debian
| `mqtt_subscribe` | Souscription dynamique à un topic MQTT | | `mqtt_subscribe` | Souscription dynamique à un topic MQTT |
| `muc_send` | Message dans le groupe XMPP | | `muc_send` | Message dans le groupe XMPP |
## Bibliothèque de scripts
Les scripts bash sont stockés dans `/opt/agent_debian/scripts/`. Ils peuvent être créés et exécutés depuis Nexus :
```
# Via Nexus
/script save debian backup | #!/bin/bash\ntar -czf /tmp/backup.tgz /etc
/script run debian backup
/script schedule daily 03:00 debian backup
/script list debian
```
Chaque exécution envoie une notification XMPP à l'admin via Nexus.
## Surveillance proactive ## Surveillance proactive
L'agent monitore en arrière-plan (toutes les 5 minutes) : L'agent monitore en arrière-plan (toutes les 5 minutes) :
@@ -60,13 +74,15 @@ Les alertes sont envoyées automatiquement à Nexus via MQTT.
"mqtt": { "host": "localhost", "port": 1883 }, "mqtt": { "host": "localhost", "port": 1883 },
"llm": { "llm": {
"base_url": "http://192.168.7.119:11434", "base_url": "http://192.168.7.119:11434",
"model": "ministral-3:latest", "model": "qwen3:8b",
"temperature": 0.3 "temperature": 0.3
}, },
"llm_profiles": { "llm_profiles": {
"local": "ministral-3:latest", "local": "qwen3:8b",
"cloud": "gpt-oss:120b-cloud" "cloud": "gpt-oss:120b-cloud"
} },
"use_omemo": true,
"use_llm_coordinator": true
} }
``` ```
@@ -78,6 +94,7 @@ Les alertes sont envoyées automatiquement à Nexus via MQTT.
/status — État de la queue de tâches /status — État de la queue de tâches
/pause — Pause du traitement des tâches /pause — Pause du traitement des tâches
/resume — Reprise /resume — Reprise
/script — Gestion de la bibliothèque de scripts bash
``` ```
## Fichiers ## Fichiers
@@ -85,6 +102,7 @@ Les alertes sont envoyées automatiquement à Nexus via MQTT.
``` ```
agent_debian.py — Point d'entrée agent_debian.py — Point d'entrée
skills/ — 16 skills système skills/ — 16 skills système
scripts/ — Scripts bash persistants
config/ — Configuration et system prompt config/ — Configuration et system prompt
agent_debian.service — Unit systemd agent_debian.service — Unit systemd
``` ```