185 lines
4.9 KiB
Markdown
185 lines
4.9 KiB
Markdown
# Guide de Démarrage Rapide - RPA Vision V2
|
|
|
|
Ce guide vous permet de démarrer avec RPA Vision V2 en quelques minutes.
|
|
|
|
## Installation Express (5 minutes)
|
|
|
|
```bash
|
|
# 1. Cloner ou naviguer vers le projet
|
|
cd geniusia2
|
|
|
|
# 2. Lancer l'installation automatique
|
|
./setup.sh
|
|
|
|
# 3. C'est tout ! Le script configure tout automatiquement
|
|
```
|
|
|
|
## Premier Lancement (2 minutes)
|
|
|
|
```bash
|
|
# Activer l'environnement virtuel
|
|
source venv/bin/activate
|
|
|
|
# Lancer l'application
|
|
python3 main.py
|
|
```
|
|
|
|
L'interface graphique s'ouvre automatiquement.
|
|
|
|
## Première Utilisation (10 minutes)
|
|
|
|
### Étape 1: Configuration de la Liste Blanche
|
|
|
|
Avant de commencer, ajoutez les applications que vous souhaitez automatiser:
|
|
|
|
1. Cliquez sur **"Gérer Liste Blanche"**
|
|
2. Ajoutez une application de test (ex: "Firefox", "gedit")
|
|
3. Confirmez l'ajout
|
|
|
|
⚠️ **Important**: Ne jamais ajouter d'applications sensibles (banque, admin système)
|
|
|
|
### Étape 2: Mode Shadow (Apprentissage)
|
|
|
|
1. Cliquez sur **"Start"**
|
|
2. Le mode 👀 **Shadow** est activé par défaut
|
|
3. Effectuez une tâche répétitive dans l'application autorisée
|
|
4. Le système observe et apprend silencieusement
|
|
5. Répétez la tâche au moins 20 fois
|
|
|
|
**Exemple de tâche simple**:
|
|
- Ouvrir Firefox
|
|
- Cliquer sur la barre d'adresse
|
|
- Taper "example.com"
|
|
- Appuyer sur Entrée
|
|
|
|
### Étape 3: Transition vers Mode Assisté
|
|
|
|
Après ≥20 observations avec ≥95% de concordance:
|
|
|
|
1. Une notification propose le passage en mode 🤝 **Assisté**
|
|
2. Acceptez la transition
|
|
3. Le système suggère maintenant les actions
|
|
4. Validez avec **Entrée** ou rejetez avec **Échap**
|
|
|
|
### Étape 4: Mode Autopilot (Automatisation)
|
|
|
|
Après ≥20 validations avec ≥95% de concordance:
|
|
|
|
1. Une notification propose le passage en mode 🤖 **Autopilot**
|
|
2. Acceptez la transition
|
|
3. Le système exécute automatiquement la tâche
|
|
4. Surveillez les notifications de succès/échec
|
|
|
|
## Raccourcis Essentiels
|
|
|
|
| Raccourci | Action |
|
|
|-----------|--------|
|
|
| **Ctrl+Pause** | 🛑 Arrêt d'urgence |
|
|
| **Entrée** | ✅ Valider suggestion |
|
|
| **Échap** | ❌ Rejeter suggestion |
|
|
| **Alt+C** | 🔧 Corriger action |
|
|
|
|
## Tableau de Bord
|
|
|
|
Appuyez sur **Ctrl+D** pour ouvrir le tableau de bord:
|
|
|
|
- Vue d'ensemble des tâches apprises
|
|
- Métriques de performance (confiance, concordance)
|
|
- Historique des corrections
|
|
- Alertes et recommandations
|
|
|
|
## Cas d'Usage Simples
|
|
|
|
### 1. Automatiser une Recherche Web
|
|
|
|
**Tâche**: Rechercher "météo Paris" sur Google
|
|
|
|
1. Mode Shadow: Effectuez la recherche 20 fois
|
|
2. Mode Assisté: Validez les suggestions 20 fois
|
|
3. Mode Autopilot: Laissez le système faire
|
|
|
|
**Temps d'apprentissage**: ~10 minutes
|
|
|
|
### 2. Remplir un Formulaire
|
|
|
|
**Tâche**: Remplir un formulaire avec des données fixes
|
|
|
|
1. Mode Shadow: Remplissez le formulaire 20 fois
|
|
2. Mode Assisté: Validez les suggestions
|
|
3. Mode Autopilot: Automatisation complète
|
|
|
|
**Temps d'apprentissage**: ~15 minutes
|
|
|
|
### 3. Copier-Coller entre Applications
|
|
|
|
**Tâche**: Copier du texte de Firefox vers LibreOffice
|
|
|
|
1. Ajoutez Firefox et LibreOffice à la liste blanche
|
|
2. Mode Shadow: Effectuez l'opération 20 fois
|
|
3. Mode Assisté: Validez les suggestions
|
|
4. Mode Autopilot: Automatisation
|
|
|
|
**Temps d'apprentissage**: ~15 minutes
|
|
|
|
## Résolution de Problèmes Rapide
|
|
|
|
### Le système ne détecte pas mes actions
|
|
|
|
- Vérifiez que l'application est dans la liste blanche
|
|
- Assurez-vous que le mode Shadow est actif
|
|
- Vérifiez les logs dans le tableau de bord
|
|
|
|
### Les suggestions sont imprécises
|
|
|
|
- Fournissez plus d'exemples en mode Shadow (>20)
|
|
- Vérifiez que l'UI n'a pas changé
|
|
- Ajustez les seuils dans `core/config.py`
|
|
|
|
### Latence élevée
|
|
|
|
- Vérifiez que le GPU est utilisé
|
|
- Utilisez un modèle plus léger (qwen2.5-vl:3b)
|
|
- Réduisez la résolution de capture
|
|
|
|
### Erreur "Application not whitelisted"
|
|
|
|
- Ajoutez l'application à la liste blanche
|
|
- Vérifiez le titre exact de la fenêtre
|
|
- Redémarrez l'application
|
|
|
|
## Prochaines Étapes
|
|
|
|
1. **Explorez le tableau de bord**: Ctrl+D pour voir les métriques
|
|
2. **Testez le rollback**: Ctrl+Z pour annuler les 3 dernières actions
|
|
3. **Personnalisez la config**: Éditez `core/config.py`
|
|
4. **Lisez la doc complète**: `README.md`
|
|
|
|
## Conseils de Sécurité
|
|
|
|
✅ **À FAIRE**:
|
|
- Tester en mode Shadow avant Autopilot
|
|
- Surveiller le tableau de bord régulièrement
|
|
- Sauvegarder `data/` périodiquement
|
|
- Utiliser l'arrêt d'urgence (Ctrl+Pause) si nécessaire
|
|
|
|
❌ **À NE PAS FAIRE**:
|
|
- Ajouter des applications sensibles à la liste blanche
|
|
- Laisser tourner en Autopilot sans surveillance
|
|
- Modifier les fichiers dans `data/` manuellement
|
|
- Désactiver les mécanismes de sécurité
|
|
|
|
## Support
|
|
|
|
- **Documentation**: `README.md`
|
|
- **Architecture**: `.kiro/specs/rpa-vision-v2/design.md`
|
|
- **Logs**: `data/logs/` (chiffrés)
|
|
- **Métriques**: Tableau de bord (Ctrl+D)
|
|
|
|
---
|
|
|
|
**Temps total pour être opérationnel**: ~20 minutes
|
|
|
|
**Temps pour première automatisation**: ~30 minutes
|
|
|
|
Bon apprentissage ! 🚀
|