🤖 Guide Utilisateur — Orchestrateur IA
Système multi-agents IA : coordonnez plusieurs experts automatiquement pour répondre à vos questions complexes.
📌Introduction
L'Orchestrateur IA est un système qui coordonne automatiquement plusieurs intelligences artificielles spécialisées pour répondre à vos questions complexes. Au lieu de consulter un seul outil généraliste, vous mobilisez simultanément des experts IA en droit, finance, RH, technique, santé ou recrutement — selon ce que votre demande nécessite.
Expertise ciblée
Chaque agent est spécialisé dans son domaine. Il répond avec précision, pas de façon générale.
Transparence totale
Vous voyez chaque étape se dérouler : qui travaille, avec quoi, et pourquoi.
Vos documents
Joignez vos fichiers texte (contrats, CV, factures…) pour des réponses contextualisées.
Rejouable
Relancez n'importe quelle étape individuellement sans tout recommencer.
Prérequis
| Élément | Requis | Notes |
|---|---|---|
| Navigateur web | Chrome 90+, Firefox 88+, Edge 90+, Safari 14+ | JavaScript doit être activé |
| Connexion Internet | Oui | Pour les appels aux LLMs (Claude, OpenAI, etc.) |
| Installation locale | Non (usage web) | PHP 8.1+ requis si déploiement en interne |
🚀Prise en main rapide
En trois étapes, obtenez votre première réponse multi-experts.
Accédez à l'URL fournie par votre administrateur. Vous arrivez directement sur la zone de saisie — aucune connexion n'est requise.
Dans la zone de texte principale, décrivez votre question en langage naturel. Soyez aussi précis que possible : contexte, enjeux, ce que vous attendez. Vous pouvez joindre des documents si nécessaire (contrats, CV, etc.).
L'orchestrateur analyse votre demande, sélectionne les experts, vous demande confirmation, puis exécute les agents et produit la synthèse finale.
🖥️Présentation de l'écran
L'interface se compose de quatre zones qui apparaissent progressivement au fil du traitement.
🔝 En-tête (Header)
Affiche le nom de l'application, la mention de création (FCO), et trois boutons d'administration : Prompts (modifier les instructions des agents), LLM (choisir le modèle IA) et Agents (configurer les experts disponibles). Ces boutons sont réservés à l'administrateur. Un lien discret ▶ Présentation ouvre la présentation de démonstration.
✍️ Zone de saisie (toujours visible)
Contient le champ de texte principal pour votre demande et la section Documents joints (facultatif). Le bouton Soumettre la demande lance le workflow. Il se grise pendant le traitement pour éviter les doubles soumissions.
🔄 Zone workflow (apparaît après soumission)
Liste verticale de cartes d'étapes. Chaque carte représente une phase du traitement (Analyse, Sélection, Plan, Exécution, Synthèse). Elles s'accumulent de haut en bas au fil du traitement. Cliquez sur une carte pour voir son détail ou le replier.
🕸️ Graphe interactif (apparaît après validation du plan)
Visualisation SVG en temps réel des agents et de leur état. Chaque cercle représente un agent : gris (en attente), bleu pulsant (en cours), vert (terminé), rouge (erreur), ambre (synthèse). Cliquez sur un nœud pour voir le détail de ce que l'agent a produit.
📄 Zone résultat (apparaît à la fin)
Affiche la synthèse finale en texte formaté (Markdown rendu). Le bouton Nouvelle demande remet tout à zéro pour une nouvelle requête.
🔄Déroulé du workflow
Voici les cinq étapes qui se succèdent automatiquement après votre soumission.
✍️Soumettre une demande
Objectif : formuler une question claire pour obtenir la meilleure réponse possible de l'équipe d'experts IA.
Étapes
- Cliquez dans la zone "Votre demande" et saisissez votre question en français.
- Soyez précis : indiquez le contexte (type d'entreprise, situation, enjeux), ce que vous cherchez (comprendre, décider, rédiger…), et les contraintes éventuelles.
- Utilisez le raccourci
Ctrl + Entréeou cliquez sur "Soumettre la demande". - Si l'IA juge la demande insuffisamment claire, elle affiche des questions de précision. Répondez-y et cliquez "Envoyer les précisions".
- La carte d'analyse affiche ensuite le score de clarté, les domaines détectés et les mots-clés extraits.
Résultats attendus
- La carte Analyse s'affiche avec un score de clarté, les domaines identifiés et les 5 dimensions d'analyse (intention, domaine, contexte, complétude, précision lexicale).
- Si la demande est claire (score ≥ 6/10), le workflow passe automatiquement à la sélection des agents.
- Si la demande est floue, un formulaire de questions apparaît (max. 3 tours de clarification).
📎Joindre des documents
Objectif : fournir aux agents des documents de référence (contrats, CV, factures, notes…) pour des réponses contextualisées.
Étapes
- Dans la section "Documents joints", cliquez sur "+ Ajouter un document".
- Un bloc apparaît avec un champ nom (ex : "Contrat de travail Marie Dupont") et une zone de texte pour le contenu.
- Copiez-collez le texte de votre document dans la zone prévue. Répétez pour chaque document.
- Pour supprimer un document, cliquez sur le bouton × à droite de son nom.
- Soumettez normalement votre demande — l'orchestrateur identifiera et étiquettera automatiquement chaque document.
Résultats attendus
- Une étape "Identification des documents" apparaît dans le workflow, listant chaque document avec son label et son type attribués automatiquement (contrat, CV, facture, etc.).
- Chaque agent reçoit les documents et peut les utiliser dans sa réponse.
✅Valider le plan d'exécution
Objectif : examiner le plan proposé par l'orchestrateur et décider de le lancer ou de l'annuler.
Étapes
- Après l'étape de sélection, une carte "Plan d'exécution" s'ouvre automatiquement.
- Examinez le flux graphique : il montre chaque agent retenu, son score de pertinence, ce qu'il reçoit en entrée, et la stratégie choisie (parallèle, sérielle ou mixte).
- Lisez le badge de stratégie et sa justification (ex : "Parallèle — expertises indépendantes, fusion en synthèse").
- Cliquez sur "Lancer l'exécution" pour confirmer, ou sur "Annuler" pour stopper sans exécuter.
Les trois stratégies
| Stratégie | Fonctionnement | Cas d'usage typique |
|---|---|---|
| Sérielle | Les agents travaillent les uns après les autres, chacun lisant les résultats du précédent. | Raisonnements en chaîne, analyse progressive d'un sujet complexe. |
| Parallèle | Tous les agents travaillent simultanément, puis leurs réponses sont fusionnées. | Expertises indépendantes (ex : analyse juridique + financière en même temps). |
| Mixte | Des groupes d'agents travaillent en parallèle, et ces groupes s'enchaînent. | Projets multi-phases où certaines expertises dépendent d'autres. |
Résultats attendus
- Si vous cliquez "Lancer" : le graphe SVG apparaît et l'étape d'exécution démarre immédiatement.
- Si vous cliquez "Annuler" : la carte passe en erreur, le bouton "Soumettre" se réactive pour une nouvelle demande.
- Si aucun agent n'est jugé pertinent (tous < 60/100) : un message d'aide s'affiche avec des suggestions pour reformuler.
⚡Suivre l'exécution des agents
Objectif : comprendre ce qui se passe pendant que les agents travaillent et consulter leurs réponses individuelles.
Étapes
- Après validation du plan, le graphe SVG s'affiche avec les nœuds de chaque agent en gris (en attente).
- Dès qu'un agent démarre, son nœud passe en bleu pulsant et sa carte apparaît avec le badge "En cours…".
- Quand un agent termine, son nœud devient vert et sa carte affiche "Terminé ✓".
- Cliquez sur le nœud dans le graphe (ou sur les boutons Entrée reçue / Réponse produite dans la carte) pour voir le détail de l'échange.
- En mode parallèle, plusieurs agents sont actifs simultanément.
Lire le graphe
| Couleur du nœud | Signification |
|---|---|
| ⚫ Gris | Agent en attente, pas encore démarré |
| 🔵 Bleu (pulsant) | Agent en cours de traitement |
| 🟢 Vert | Agent terminé avec succès — cliquez pour voir sa réponse |
| 🔴 Rouge | Agent en erreur (réseau, timeout…) |
| 🟠 Ambre (S) | Étape de synthèse (mode parallèle/mixte uniquement) |
Résultats attendus
- Une fois tous les agents terminés, l'étape de synthèse démarre automatiquement.
- La réponse finale apparaît dans la zone "Synthèse finale" en bas de page, en texte formaté.
↺Relancer une étape
Objectif : rejouer une étape spécifique sans recommencer l'ensemble du workflow depuis le début.
Étapes
- Sur toute carte d'étape affichant le statut Terminé ou Erreur, un petit bouton ↺ apparaît à droite du badge de statut.
- Cliquez sur ce bouton ↺ pour relancer l'étape.
- La carte de l'étape ciblée et toutes les cartes suivantes sont effacées et recalculées automatiquement.
- Les étapes précédentes et leur résultat sont conservés (pas besoin de ré-analyser si vous voulez juste relancer l'exécution).
Résultats attendus
- L'étape choisie repart à zéro et suit le même déroulé que lors de la première exécution.
- Le graphe est reconstruit si l'étape "Exécution" est relancée.
- Le bouton "Soumettre" reste grisé jusqu'à la fin du nouveau traitement.
⚙️Configurer les agents
La page ⚙ Agents (accessible depuis le header) permet de créer, modifier, activer ou supprimer les experts IA disponibles. Chaque agent est défini par son identité, ses règles de comportement et sa base documentaire.
Navigation dans la liste des agents
- La barre latérale gauche liste tous les agents existants. Un point vert indique qu'un agent est actif, un point gris qu'il est désactivé.
- Cliquez sur un agent pour charger sa fiche dans le panneau principal.
- Cliquez sur "+ Nouveau" pour créer un agent vierge.
Champs de la fiche agent
| Champ | Rôle | Obligatoire |
|---|---|---|
| Nom | Identifiant affiché dans l'UI, le graphe et les rapports. | Oui |
| Spécialité | Description courte du domaine d'expertise (ex : "Droit français et européen"). | Non |
| Description | Texte présenté à l'utilisateur dans l'interface de configuration. | Non |
| Forces | Ce que l'agent fait bien — transmis à l'orchestrateur pour affiner la sélection. | Non |
| Limites | Ce que l'agent ne traite pas — évite les sur-sélections inappropriées. | Non |
| Agent actif | Si désactivé, l'agent n'est plus proposé par l'orchestrateur. Les données sont conservées. | Oui |
| Provider LLM | Surcharge le provider global pour cet agent uniquement (ex : utiliser GPT-4o pour un agent, Claude pour un autre). | Non |
| Modèle LLM | Surcharge le modèle du provider pour cet agent (pré-rempli selon le provider choisi). | Non |
| Prompt système | Instructions données au LLM : rôle, règles, format de réponse. C'est le cœur de la personnalité de l'agent. | Oui |
| Base documentaire (RAG) | Connaissances de référence injectées à chaque appel : articles de loi, données sectorielles, procédures internes… En Markdown. | Non |
Tester un agent
- Cliquez sur "▶ Tester" dans la barre d'outils de la fiche.
- Une fenêtre s'ouvre : saisissez une question de test et cliquez "Lancer le test".
- La réponse de l'agent s'affiche directement — sans passer par l'orchestrateur. Utile pour valider le prompt système.
Sauvegarder et supprimer
- Sauvegarder — enregistre la fiche dans le fichier JSON correspondant sur le serveur. La modification est immédiatement prise en compte sans redémarrage.
- Supprimer — efface définitivement le fichier JSON de l'agent. Cette action est irréversible.
🔑Configurer le LLM
La page 🔑 LLM (accessible depuis le header) permet de choisir quel fournisseur d'IA utiliser pour l'orchestrateur et pour les agents, et de saisir les clés API correspondantes.
config/config.local.php. Elles ne transitent jamais en clair vers le navigateur. Ne partagez jamais ce fichier ni vos clés API.Section Orchestrateur
L'orchestrateur gère les étapes d'analyse, de planification et de synthèse. Il peut utiliser un modèle différent et plus puissant que celui des agents.
- Choisissez le provider dans le menu déroulant (Claude, GPT, Mistral, Gemini ou Démo).
- Renseignez optionnellement un modèle spécifique (ex :
claude-opus-4-7). Si vide, le modèle par défaut du provider est utilisé.
Section Agents
Définit le provider utilisé par défaut pour tous les agents qui n'ont pas de surcharge individuelle configurée dans leur fiche.
- Sélectionnez le provider souhaité dans le menu déroulant.
- Le mode Démo (sélection par défaut) ne nécessite aucune clé API et retourne des réponses simulées — idéal pour tester l'interface.
Fiches fournisseurs
Chaque fournisseur (Claude, GPT, Mistral, Gemini) dispose d'une carte dédiée avec :
| Élément | Description |
|---|---|
| Clé API | Saisie masquée. Cliquez "✏ Modifier" pour entrer ou remplacer la clé. La clé existante n'est jamais affichée en clair. |
| Modèle par défaut | Modèle utilisé si aucun modèle n'est précisé ailleurs (ex : gpt-4o-mini, claude-haiku-4-5-20251001). |
| ▶ Tester la connexion | Envoie un appel de test minimal au provider et affiche "Connexion OK" ou le message d'erreur retourné. |
| Indicateur de statut | Point coloré : vert = clé configurée et valide, gris = non configurée, rouge = erreur de connexion. |
Modèles recommandés par provider
| Provider | Modèle économique | Modèle puissant |
|---|---|---|
| Claude (Anthropic) | claude-haiku-4-5-20251001 | claude-opus-4-7 |
| GPT (OpenAI) | gpt-4o-mini | gpt-4o |
| Mistral AI | mistral-small-latest | mistral-large-latest |
| Gemini (Google) | gemini-1.5-flash | gemini-1.5-pro |
❓Erreurs fréquentes
La demande reste bloquée sur "Évaluation de la clarté…"
Cause probable : le serveur met du temps à répondre ou la clé API LLM est expirée / incorrecte.
Solution : attendez 20 à 30 secondes. Si le blocage persiste, rechargez la page et vérifiez avec votre administrateur que la configuration LLM est correcte (page 🔑 LLM dans le header). En mode démo (sans clé API), toutes les étapes fonctionnent avec des réponses simulées.
L'orchestrateur me dit "Aucun agent pertinent trouvé"
Cause probable : votre demande touche un domaine non couvert par les agents activés, ou la formulation n'est pas assez précise pour que le score dépasse 60/100.
Solution : reformulez en utilisant des mots-clés liés aux domaines disponibles (juridique, finance, RH, santé, technique, recrutement). Cliquez sur "↺ Nouvelle demande" pour réessayer. Vérifiez également que les agents pertinents sont bien activés dans la page ⚙ Agents.
Un agent affiche "Erreur" dans le graphe
Cause probable : timeout réseau, réponse invalide du LLM, ou quota dépassé sur l'API IA.
Solution : cliquez sur la carte d'exécution puis dépliez la section Entrée/Sortie de l'agent en erreur pour voir le message. Cliquez ensuite sur ↺ sur la carte "Exécution" pour relancer. Si l'erreur persiste, contactez votre administrateur.
Le formulaire de clarification n'apparaît pas alors que l'IA dit qu'il manque des infos
Cause probable : la carte d'analyse est repliée (accordéon fermé).
Solution : cliquez sur la carte "Analyse de la demande" pour l'ouvrir. Le formulaire de questions s'y trouve. Répondez et cliquez "Envoyer les précisions".
La synthèse finale est vide ou incomplète
Cause probable : en mode sériel, la synthèse utilise directement la réponse du dernier agent — si ce dernier a produit une erreur, la synthèse sera vide.
Solution : vérifiez l'état des agents dans le graphe. Si l'un d'eux est en rouge, relancez l'exécution via ↺. En mode parallèle, si le nœud de synthèse (ambre "S") est rouge, relancez uniquement la synthèse.
Le bouton "Soumettre" reste grisé après une erreur
Cause probable : une erreur s'est produite avant la fin du workflow sans que le bouton soit réactivé.
Solution : rechargez la page (F5). L'état se réinitialise complètement. Ou cliquez sur ↺ sur la dernière carte visible pour relancer à partir de ce point.
📖Glossaire
✉️Contact
Pour toute question sur l'utilisation ou en cas de problème non résolu par ce guide :
Ce système est un démonstrateur créé pour présenter le concept d'orchestration multi-agents IA.
Pour toute demande d'évolution, de déploiement ou d'administration, adressez-vous directement à FCO.