multi-agent-orchestrator

Multi-Agent Orchestrator

Quand utiliser ce skill

Utilise ce skill dès qu'une tâche gagne à être décomposée en sous-tâches spécialisées et exécutées par des agents distincts : pipelines de recherche parallèle, systèmes supervisor/worker, débats multi-agents, workflows ETL IA, etc.

Seuil de déclenchement — un seul agent suffit si la tâche est linéaire et tient en un contexte. Passe en multi-agent si :

• la tâche nécessite des spécialisations différentes (recherche + rédaction + validation),
• des sous-tâches peuvent s'exécuter en parallèle,
• la fenêtre de contexte d'un agent unique serait saturée.

---

Choix du pattern (critères de décision)

Pattern	Quand l'utiliser	Complexité
Supervisor / Router	Tâche décomposable en N sous-tâches distinctes ; résultats à consolider	Faible
Pipeline séquentiel	Sous-tâches avec dépendances strictes A→B→C	Faible
Parallel fan-out	Sous-tâches indépendantes, latence critique	Moyenne
Hiérarchique	Organisation de type chef de projet → équipes → exécutants	Moyenne
Swarm	Exploration large, diversité de solutions, pas de dépendances	Haute
Debate / Voting	Décisions à fort enjeu, besoin de consensus ou de validation croisée	Haute

---

Workflow en étapes

1. Décomposition de la tâche

Identifie les sous-tâches atomiques et leurs dépendances. Produis un graphe orienté (DAG) avant tout code.

tâche principale
├── sous-tâche A (indépendante)
├── sous-tâche B (indépendante)
└── sous-tâche C (dépend de A + B)

Règle : si deux sous-tâches n'ont aucune dépendance, elles doivent s'exécuter en parallèle.

2. Définition des agents

Un agent = un rôle unique + un system prompt ciblé. Évite les agents "couteau suisse".

AGENTS = {
    "researcher": Agent(
        system="Tu es un agent de recherche. Tu extrais des faits vérifiables. "
               "Retourne TOUJOURS un JSON {facts: [], sources: []}.",
        tools=[web_search, fetch_url],
    ),
    "writer": Agent(
        system="Tu es un rédacteur. Tu transformes des faits structurés en prose claire.",
        tools=[],
    ),
    "validator": Agent(
        system="Tu es un agent de validation. Tu détectes les affirmations non sourcées.",
        tools=[],
    ),
}