turf_saas/SUB_AGENTS.md

🤖 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 :

# 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 :

# 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 :

# 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) :

{
  "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 :

sessions_spawn(
    agentId="scraper",
    task="Scraper les artisans boulangeries sur Lyon",
    label="scraper_lyon"
)

Suivre les sessions :

sessions_list()

Historique :

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