173 lines
4.7 KiB
Markdown
Executable File
173 lines
4.7 KiB
Markdown
Executable File
# 🤖 Sub-Agents H3R7Tech - Documentation
|
|
|
|
## Vue d'Ensemble
|
|
|
|
Les sub-agents sont des sessions automatisées qui peuvent exécuter des tâches en arrière-plan. Voici l'organisation proposée :
|
|
|
|
```
|
|
┌─────────────────────┐
|
|
│ 🌟 H3R7Tech │
|
|
│ (Main Session) │
|
|
└──────────┬──────────┘
|
|
│
|
|
┌──────────────────────┼──────────────────────┐
|
|
│ │ │
|
|
▼ ▼ ▼
|
|
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
|
|
│ 🤖 AgentScraper │ │ 🤖 AgentSales │ │ 🤖 AgentMailing │
|
|
│ (Sessions) │ │ (Sessions) │ │ (Sessions) │
|
|
└─────────────────┘ └─────────────────┘ └─────────────────┘
|
|
```
|
|
|
|
---
|
|
|
|
## 🎭 Rôles des Sub-Agents
|
|
|
|
### 1. 🤖 AgentScraper
|
|
**Purpose:** Collecte automatique de données prospects
|
|
|
|
**Sessions spawnables :**
|
|
- `scraper_annuaires` - Extraction PagesJaunes, Mistersuite
|
|
- `scraper_concurrents` - Veille tarifaire
|
|
- `scraper_social` - Données réseaux sociaux
|
|
|
|
**Commandes :**
|
|
```bash
|
|
# Lancer un scraping
|
|
sessions_spawn(task="Scraper les plombiers sur Paris", agentId="scraper")
|
|
|
|
# Via cron
|
|
cron add --schedule "0 9 * * *" --task "Scraper annuaires" --session scraper
|
|
```
|
|
|
|
---
|
|
|
|
### 2. 🤖 AgentSales
|
|
**Purpose:** Démarchage automatique et suivi
|
|
|
|
**Sessions spawnables :**
|
|
- `sales_outbound` - Appels sortants
|
|
- `sales_follow` - Relances
|
|
- `sales_closing` - Fermeture des ventes
|
|
|
|
**Commandes :**
|
|
```bash
|
|
# Lancer prospection
|
|
sessions_spawn(task="Appeler les 10 premiers prospects du CRM", agentId="sales")
|
|
|
|
# Follow-up automatique
|
|
cron add --schedule "0 10 * * *" --task "Relance prospects" --session sales
|
|
```
|
|
|
|
---
|
|
|
|
### 3. 🤖 AgentMailing
|
|
**Purpose:** Campagnes email automatisées
|
|
|
|
**Sessions spawnables :**
|
|
- `mailing_sequence` - Séquences de prospection
|
|
- `mailing_follow` - Relances email
|
|
- `mailing_report` - Rapports Campaign
|
|
|
|
**Commandes :**
|
|
```bash
|
|
# Envoyer séquence
|
|
sessions_spawn(task="Envoyer séquence welcome aux nouveaux prospects", agentId="mailing")
|
|
|
|
# Rapport quotidien
|
|
cron add --schedule "0 8 * * *" --task "Rapport emailing" --session mailing
|
|
```
|
|
|
|
---
|
|
|
|
### 4. 🤖 AgentSupport
|
|
**Purpose:** Relation client et SAV
|
|
|
|
**Sessions spawnables :**
|
|
- `support_responses` - Réponses automatiques
|
|
- `support_tickets` - Gestion incidents
|
|
|
|
---
|
|
|
|
### 5. 🤖 AgentAnalyst
|
|
**Purpose:** Analyses et rapports
|
|
|
|
**Sessions spawnables :**
|
|
- `analyst_stats` - KPIs quotidiens
|
|
- `analyst_forecast` - Prédictions business
|
|
|
|
---
|
|
|
|
## ⚙️ Configuration des Agents
|
|
|
|
### Fichier de config agents (agents.json) :
|
|
|
|
```json
|
|
{
|
|
"agents": {
|
|
"scraper": {
|
|
"description": "Collecte de données prospects",
|
|
"model": "minimax-m2.1-free",
|
|
"system_prompt": "Tu es un expert en scraping et collecte de données. Ta mission est de trouver des prospects qualifiés pour H3R7Tech."
|
|
},
|
|
"sales": {
|
|
"description": "Démarchage et prospection",
|
|
"model": "minimax-m2.1-free",
|
|
"system_prompt": "Tu es un expert en vente B2B. Tu sais persuasive et clos des deals. Tu travailles pour H3R7Tech."
|
|
},
|
|
"mailing": {
|
|
"description": "Campagnes email",
|
|
"model": "minimax-m2.1-free",
|
|
"system_prompt": "Tu es un expert en email marketing. Tu sais écrire des emails qui convertissent. Tu travailles pour H3R7Tech."
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
## 📅 Planification (Cron Jobs)
|
|
|
|
| Heure | Agent | Tâche | Fréquence |
|
|
|-------|-------|-------|-----------|
|
|
| 08:00 | Mailing | Rapport quotidien | Quotidien |
|
|
| 09:00 | Scraper | Nouveaux prospects | Quotidien |
|
|
| 10:00 | Sales | Relances | Quotidien |
|
|
| 14:00 | Sales | Appels sortants | Quotidien |
|
|
| 18:00 | Analyst | Bilan quotidien | Quotidien |
|
|
|
|
---
|
|
|
|
## 🚀 Utilisation
|
|
|
|
### Lancer un agent manuellement :
|
|
```python
|
|
sessions_spawn(
|
|
agentId="scraper",
|
|
task="Scraper les artisans boulangeries sur Lyon",
|
|
label="scraper_lyon"
|
|
)
|
|
```
|
|
|
|
### Suivre les sessions :
|
|
```bash
|
|
sessions_list()
|
|
```
|
|
|
|
### Historique :
|
|
```bash
|
|
sessions_history(sessionKey="scraper_lyon")
|
|
```
|
|
|
|
---
|
|
|
|
## 🔐 Sécurité
|
|
|
|
- **Ne jamais** donner accès aux données clients outside
|
|
- **Toujours** valider avant envoi externe
|
|
- **Journaliser** toutes les actions
|
|
|
|
---
|
|
|
|
*Document généré le 25/02/2026 - H3R7Tech*
|