# Section 05 · Topologie d'exécution d'un système agentique Débarrassé de sa stack, un système agentique en marche garde toujours la même silhouette. Ses composants sont stables ; seuls leur langage et leur découpage varient, selon les sections précédentes. ## Schéma de runtime > Schéma : Utilisateur / client externe · POINT D'ENTRÉE · interface, API ou protocole d'outils · ORCHESTRATEUR · boucle plan-and-execute · budget · plan · narration · événements · délègue · appelle un outil · Sous-agent · contexte isolé · budget propre · scope d'outils restreint · REGISTRE D'OUTILS + MIDDLEWARE · log · accès · métriques · coût · approbation · PORT modèle · passerelle · 3 niveaux · PORT persist. · store / état · PORT exéc. · sidecar via · protocole · PORT source · entrées · SERVEUR OUTILS · exposé · (vers externe) · Infra modèle interne · (gouvernance, observabilité) · Sidecar spécialisé · (stateful, circuit breaker) · OBSERVABILITÉ TRANSVERSE · journaux · événements · lignée · métriques · coût ## Lecture du schéma - Orchestrateur : pilote la boucle, planifie, délègue, synthétise. Il ne contient pas de logique métier ; il compose. - Registre d'outils plus middleware : surface unique où passent journalisation, contrôle d'accès, métriques, coût et approbations. Ajouter un garde-fou se fait ici, sans toucher aux outils. C'est aussi d'ici qu'est émis un flux de traces unique, consommé séparément par la provenance, l'évaluation et l'observabilité. Cette surface ne porte que du transversal, jamais d'orchestration ni de logique métier : c'est la garde contre l'écueil du bus d'intégration hypertrophié des architectures orientées services, où le canal finit par décider du métier. La logique reste dans les outils et l'orchestrateur ; le canal qui les relie demeure mince, et le registre reste un index, pas un cerveau. - Ports secondaires : modèle (via une passerelle qui centralise gouvernance et routage par niveau), persistance, exécution (souvent un sidecar spécialisé), sources d'entrée. - Serveur d'outils exposé : le système publie ses cas d'usage comme outils standardisés, pour être piloté par un orchestrateur externe sans copie de logique. - Observabilité transverse : chaque étape laisse une trace exploitable a posteriori, et cette trace nourrit l'évaluation continue, pas seulement un tableau de bord. ## Le sidecar comme motif récurrent Une capacité spécialisée (par exemple un moteur d'exécution piloté par un autre langage) tourne dans un sidecar à session, consommé via le protocole d'outils. Le sidecar est traité comme une dépendance externe : santé surveillée, disjoncteur (circuit breaker) en cas d'indisponibilité, procédure de relance documentée. Le reste du système continue de fonctionner en mode dégradé si le sidecar tombe. ## Le registre, un port à deux adaptateurs Découvrir quels outils et quels sous-agents sont disponibles est, comme le reste, une décision d'adaptateur. Tant que tout vit dans un seul processus, le registre est une simple table en mémoire, atomique et gratuite. Dès qu'une capacité sort du processus, d'un autre langage ou d'une autre équipe, le même port bascule sur un adaptateur de découverte de service : chaque agent publie une fiche de capacités auto-descriptive, découverte via un registre partagé, par annonce et abonnement avec cache local, jamais par un appel central à chaque itération. Le contrat de découverte ne change pas ; seul l'adaptateur change avec la topologie. **À retenir** - Composants stables : orchestrateur, registre d'outils gouverné, ports secondaires, serveur d'outils exposé, observabilité transverse. - La passerelle modèle centralise gouvernance et routage par niveau, derrière le port. - Le sidecar est le motif récurrent pour intégrer une capacité spécialisée, traité comme une dépendance externe surveillée. - Le middleware émet un flux de traces unique : provenance, évaluation et observabilité le consomment séparément. - Le registre est un port : table en mémoire en mono-processus, fiches de capacités découvertes via un registre partagé en distribué. - Middleware et registre ne portent que du transversal, jamais d'orchestration : la logique vit dans les outils et l'orchestrateur, le canal reste mince, pour ne pas refaire le bus d'intégration hypertrophié. --- © Thibault Souris, 2026 · Creative Commons BY-ND 4.0 (https://creativecommons.org/licenses/by-nd/4.0/deed.fr) · texte de l’œuvre sans modification, mis en texte brut pour cette page ; la version PDF fait foi : https://runward.dev/docs/reference/doctrine/Concevoir-et-executer-des-systemes-agentiques-2026.pdf