# 🤖 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*
