# Acte 2 : Assemblez votre équipe de production de podcast 🎬

![lab2](../../../../translated_images/fr/lab2.48444b9d549e7863.webp)

## L'intrigue se corse

Alex (votre assistant IA de l’Acte 1) est génial, mais un seul agent ne peut pas gérer tout un studio de podcast. Vous avez besoin d’une *équipe* :
- 🔍 **Agent de Recherche** : Parcourt Internet pour trouver des informations fraîches
- ✍️ **Agent de Script** : Transforme la recherche en dialogues captivants
- 👤 **Vous (l’Éditeur)** : Approuvez les scripts ou les renvoyez pour correction

Bienvenue dans **l’Orchestration d’Agents IA** — où vous devenez le réalisateur de votre propre équipe d’IA. Pensez aux Avengers, mais pour la production de podcasts.

## Qu’est-ce que l’Orchestration d’Agents ? (La version simple)

Imaginez que vous gérez un restaurant. Vous ne faites pas tout vous-même, n’est-ce pas ? Vous avez :
- 🍳 Un chef qui cuisine
- 👨‍🍳 Un sous-chef qui prépare
- 👩‍🍳 Un serveur qui livre

L’orchestration d’agents, c’est la même idée, mais avec l’IA. Chaque agent a une spécialité, et vous les coordonnez pour atteindre des objectifs plus larges. Aucun agent unique n’est surchargé, et le travail est fait plus rapidement.

### L’Analogie du Groupe 🎸

Vos agents IA sont comme un groupe de musique :
- **Chanteur principal** : L’agent principal qui gère les tâches en contact avec le client
- **Batteur** : Maintient le rythme, gère le traitement en arrière-plan  
- **Bassiste** : Soutient tout le monde, récupère des données
- **Vous (le Manager du groupe)** : Coordonne tout !

Sans coordination ? Juste du bruit. Avec orchestration ? Une belle musique.

### Pourquoi c’est important

Un agent IA qui essaie de tout faire = épuisement. Des agents spécialisés qui travaillent ensemble = efficacité décuplée ! 🚀

**Honnêtement** : Vous vous souvenez d’avoir essayé de faire la recherche, l’écriture ET l’édition de votre podcast tout seul ? Oui, c’est galère. Avec l’orchestration, chaque agent fait ce qu’il sait faire de mieux. Vous prenez juste les décisions finales.

**Exemple réel** : Les bots de support client qui savent quand gérer la facturation, les problèmes techniques ou quand passer la main à un humain. Voilà l’orchestration !

## Agent vs. Workflow : Quelle différence ?

Pensez-y comme ceci :

### 🤖 Agent IA = Musicien de jazz
- **Prend des décisions spontanées** selon ce qu’il entend
- **Improvise** des solutions avec ses outils
- **Réfléchit** avec un cerveau LLM
- **S’adapte** à ce que vous lui lancez

### 🎵 Workflow = Orchestre jouant de la musique classique  
- **Suit une partition** (étapes prédéfinies)
- **Exécution prévisible**
- **Coordonne** plusieurs agents, humains, systèmes
- **Structuré** comme une recette

**La magie** : Les workflows *orchestrent* les agents ! Vous construisez un workflow qui dit à chaque agent quand jouer sa partition. Le meilleur des deux mondes. 🎭

## Trois façons de coordonner votre équipe IA

### 1. 🎯 Centralisé (Vous êtes le patron)

Un agent principal donne toutes les instructions. Imaginez que vous gérez une équipe — vous décidez qui fait quoi et quand.

**Avantages** :
- ✅ Direction claire (pas de confusion)
- ✅ Décisions cohérentes
- ✅ Facile à déboguer

**À utiliser pour** :
- Routage du service client (« Est-ce la facturation ou le support technique ? »)
- Processus d’approbation de contenu (« Ce script est-il validé ? »)
- Production de podcast (exactement ce qu’on construit !)

### 2. 🤝 Décentralisé (Agents auto-organisés)

Les agents communiquent directement entre eux et définissent les choses en groupe. Comme une discussion de groupe où tout le monde s’organise.

**Avantages** :
- ✅ Facilement évolutif (ajoutez des agents à tout moment)
- ✅ Pas de point de défaillance unique
- ✅ Collaboration naturelle entre agents

**À utiliser pour** :
- Équipes de recherche (chaque agent explore des sources différentes)
- Sessions de brainstorming
- Résolution de problèmes distribuée

### 3. 🔀 Hybride (Le meilleur des deux mondes)

Vous donnez la direction globale, mais les agents s’organisent eux-mêmes sur les tâches. Comme un PDG qui fait confiance à son équipe.

**Idéal pour** : Projets complexes qui demandent à la fois contrôle et flexibilité.

## Microsoft Agent Framework : votre boîte à outils d’orchestration 🧰

Il est temps de construire ! Voici ce que vous utiliserez :

### Les Briques de Construction

#### 1. 🧱 Exécuteurs (vos travailleurs)
- **Ce que c’est** : unités de traitement individuelles — agents ou logique personnalisée
- **Ce qu’ils font** : reçoivent une entrée, travaillent, produisent une sortie
- **Imaginez-les comme** : des postes sur une chaîne de montage

#### 2. ➡️ Arêtes (les connexions)
- **Ce que c’est** : chemins entre les exécuteurs
- **Ce qu’ils font** : contrôlent le flux des messages (« Après A, va à B »)
- **Imaginez-les comme** : des flèches sur un organigramme

#### 3. 🗺️ Workflows (le plan maître)
- **Ce que c’est** : le graphe complet des exécuteurs + arêtes
- **Ce qu’ils font** : définissent le processus entier du début à la fin
- **Imaginez-les comme** : le plan de votre pipeline de production

### Fonctionnalités Géniales que Vous Aimerez

**🛡️ Sécurité des types** : Les messages entre agents sont vérifiés au niveau du type. Plus de surprises "Oups, mauvais type de donnée".

**🔀 Routage flexible** : 
- Conditions if-then (« Si approuvé, publier ; sinon, réécrire »)
- Traitement parallèle (plusieurs agents travaillent en même temps)
- Chemins dynamiques (le workflow s’adapte selon les résultats)

**🔌 Intégration externe** :
- Connexion aux API
- Ajout de points de contrôle humain (vous validez avant publication)
- Création de flux demande/réponse

**💾 Point de sauvegarde** : Sauvegardez la progression ! En cas de plantage, reprenez là où vous vous êtes arrêté.

**🤝 Coordination multi-agent** :
- Exécution séquentielle (A → B → C)
- Exécution parallèle (A + B + C en même temps)
- Passage entre agents
- Traitement collaboratif

## Bonnes pratiques (astuces de pro) 🎯

### 1. Restez modulaire
Chaque agent doit faire UNE seule chose très bien. Ne créez pas un « super agent » qui fait tout — vous le regretterez au débogage.

### 2. Prévoyez les pannes
Les agents font des erreurs. Les réseaux tombent. Intégrez gestion des erreurs et plans de secours. Votre futur vous remerciera.

### 3. Surveillez tout
Suivez ce que font vos agents. Utilisez DevUI (nous allons en parler !) pour voir les workflows en action.

### 4. Optimisez la taille des messages
Ne faites pas passer de fichiers géants entre agents. Gardez les messages légers et rapides.

### 5. Choisissez le bon modèle
Besoin de contrôle ? Optez pour le centralisé. Besoin d’échelle ? Privilégiez le décentralisé. Impossible de choisir ? Allez hybride !

## DevUI : votre débogueur de workflows 🔍

### Qu’est-ce que DevUI ?

DevUI est comme un terrain de jeu pour tester vos agents et workflows. C’est une interface web où vous pouvez :
- 👀 Voir votre workflow en action
- 💬 Dialoguer directement avec les agents
- 🔍 Déboguer en cas de problème
- 📊 Visualiser les traces et les mesures de performance

> **Important** : DevUI est destiné uniquement au développement ! Ne l’utilisez pas en production. Considérez-le comme votre environnement de test local.

### Pourquoi c’est génial

- **🖥️ Interface Web interactive** : Cliquez, tapez, testez — pas besoin de ligne de commande
- **📁 Glisser-déposer prêt** : Importez des fichiers, testez avec différentes entrées
- **📂 Détection automatique** : Pointez-le sur un dossier, il trouve automatiquement tous vos agents
- **📋 Mode sans configuration** : Enregistrez les agents en code, aucune structure de dossier nécessaire
- **🔌 Compatible OpenAI** : Fonctionne avec le SDK OpenAI (compatibilité assurée !)
- **👁️ Traçage intégré** : Voyez exactement ce que font vos agents

### Fonctionnement de la saisie

DevUI est malin avec les entrées :

- **Test des agents ?** Vous avez des zones de texte et des boutons pour importer des fichiers
- **Test des workflows ?** L’UI génère automatiquement les champs d’entrée attendus par le workflow

C’est de la magie, mais c’est juste du bon code. ✨

## Vos missions : Construisez un studio de podcast 🎬

### Mission 1 : Créez un agent unique avec DevUI

📂 [01.AgentDevUI](../../../../WorkshopForAgentic/code/02.Workflow/01.AgentDevUI)

**Le défi** : Avant de bâtir une équipe complète, testons DevUI avec un agent : un spécialiste de la recherche web.

**Ce que vous construisez** :  
Un agent de recherche capable d’explorer Internet pour des sujets de podcast. Vous le testerez via l’interface web DevUI à `http://localhost:8090`.

**Compétences à acquérir** :
- 🚀 Lancer des agents dans DevUI
- 🔍 Tester les réponses des agents en temps réel
- 🛠️ Créer des outils personnalisés (recherche web)
- 📊 Activer le traçage pour déboguer
- 🖥️ Utiliser l’interface web interactive

**Le code** :
- `agent.py` : votre SearchAgent avec super-pouvoirs de recherche web
- Utilise OllamaChatClient pour se connecter à Qwen
- Implémente la fonction outil `web_search()`
- Démarre avec `serve()` — ouvre automatiquement DevUI

**Condition de victoire** : Demandez à votre agent « Quelles sont les tendances en IA ? » et regardez-le chercher sur le web ! 🎉

### Mission 2 : Construisez un workflow multi-agent

📂 [02.WorkflowDevUI](../../../../WorkshopForAgentic/code/02.Workflow/02.WorkflowDevUI)

**Le défi** : Maintenant, la vraie partie amusante commence ! Construisez un workflow complet de production de podcast avec :
1. 🔍 **Agent de Recherche** → Recherche votre sujet
2. ✍️ **Agent de Script** → Écrit un dialogue entre deux animateurs (en chinois !)
3. 👤 **Exécuteur de Revue** → Vous demande d'approuver ou de rejeter
4. 🔄 **Boucle** → En cas de rejet, réécrit selon vos retours

**Compétences à acquérir** :
- 🧱 Créer des agents spécialisés pour différents rôles
- 🔗 Connecter les agents avec WorkflowBuilder
- 🔀 Implémenter des boucles d’approbation (humain dans la boucle !)
- 🚦 Routage conditionnel (approuvé vs rejeté)
- 🔧 Construire des exécuteurs personnalisés pour la logique métier

**Le workflow** :  
```
SearchAgent → ScriptAgent → ReviewExecutor
                             ↑          ↓ (if rejected)
                             ←─────────
```
  
**Le code** :
- `search_agent/agent.py` : votre spécialiste recherche
- `generate_script_agent/agent.py` : votre scénariste (écrit en chinois !)
- `workflow/workflow.py` : la magie de l’orchestration ici
- `main.py` : lance tout dans DevUI

**Condition de victoire** : Donnez un sujet, révisez le script, rejetez-le une fois pour tester la boucle, puis approuvez ! 🎉

### Mission 3 : Construisez une application console

📂 [03.Application](../../../../WorkshopForAgentic/code/02.Workflow/03.Application)

**Le défi** : Prenez votre workflow de DevUI et transformez-le en une app terminale élégante avec sortie colorée, spinners de chargement et sauvegarde de fichiers. C’est du prêt pour la production !

**Compétences à acquérir** :
- ⚡ Exécuter les workflows programmatiquement (sans DevUI)
- 📡 Architecture événementielle avec streaming
- 🎨 Créer des interfaces terminales magnifiques (couleurs, spinners, barres de progression)
- 💾 Sauvegarder les scripts finaux dans des fichiers
- 🔄 Gérer les workflows asynchrones avec asyncio de Python

**Ce que ça fait** :
1. Vous demande un sujet de podcast
2. Montre la progression en temps réel (« Agent de Recherche en cours... »)
3. Affiche le script généré avec couleurs
4. Demande votre approbation
5. Sauvegarde le script validé dans `podcast.txt`

**Le code** :
- `podcast_app.py` : votre app principale avec gestion d’événements
- `workflow.py` : réutilise le workflow de la Mission 2
- Gère les événements : `AgentRunUpdateEvent`, `RequestInfoEvent`, `WorkflowOutputEvent`
- Utilise les couleurs ANSI pour le style terminal

**Condition de victoire** : Lancez l’app, créez un script de podcast et voyez-le sauvegardé ! Vous avez créé un vrai outil. 🚀

## Ce que vous avez maîtrisé 🏆

Après l’Acte 2, vous pouvez :

- ✅ Orchestrer plusieurs agents IA comme un pro
- ✅ Construire des workflows avec logique séquentielle ET conditionnelle
- ✅ Ajouter des points de contrôle d’approbation humaine
- ✅ Utiliser DevUI pour tester et déboguer les workflows
- ✅ Créer des applications console prêtes pour la production
- ✅ Gérer les erreurs avec élégance dans des systèmes complexes
- ✅ Choisir le bon modèle d’orchestration pour chaque projet

## Quand ça casse 🔧

### « Mon workflow est trop compliqué ! »  
**La solution** : Divisez-le en sous-workflows plus petits. Chaque workflow doit faire UNE chose bien. Enchaînez-les si besoin.

### « Je ne parviens pas à suivre ce qui se passe ! »  
**La solution** : Utilisez le checkpointing des workflows pour sauvegarder l’état. Activez le traçage dans DevUI pour voir chaque étape.

### « L’erreur d’un agent plante tout ! »  
**La solution** : Ajoutez des limites d’erreur. Chaque agent doit gérer ses propres échecs et prévoir des comportements de secours.

### « C’est trop lent »  
**La solution** : Des agents peuvent-ils tourner en parallèle ? Les workflows séquentiels sont simples mais lents. Cherchez des opportunités de parallélisation !

## Ressources utiles 🔗

- [Documentation Workflow](https://learn.microsoft.com/en-us/agent-framework/user-guide/workflows/overview) — Guides officiels Microsoft  
- [Modèles d’orchestration](https://www.ibm.com/think/topics/ai-agent-orchestration) — L’approche IBM  
- [Agent Framework GitHub](https://github.com/microsoft/agent-framework) — Parcourez le code source
- [Exemples de code](https://github.com/microsoft/agent-framework/tree/main/python/samples) — Inspirez-vous des modèles ici

---

**Prêt pour la finale ?** Vous avez votre script. Passons maintenant à la transformation en audio réel ! → [Acte 3 : Donnez vie à votre podcast](03.Multi-SpeakerPodcastGenerationWithVibeVoice.md) 🎤

---

**Bloqué ? Confus ? Excité ?** Partagez dans le chat de l’atelier ! Nous apprenons tous ensemble. 🚀

---

<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Avertissement** :  
Ce document a été traduit à l’aide du service de traduction automatique [Co-op Translator](https://github.com/Azure/co-op-translator). Bien que nous nous efforçons d’assurer l’exactitude, veuillez noter que les traductions automatiques peuvent contenir des erreurs ou des inexactitudes. Le document original dans sa langue natale doit être considéré comme la source faisant autorité. Pour les informations critiques, une traduction professionnelle humaine est recommandée. Nous ne sommes pas responsables des malentendus ou des mauvaises interprétations résultant de l’utilisation de cette traduction.
<!-- CO-OP TRANSLATOR DISCLAIMER END -->