DOC
Accueil/ Architecture
Plateforme agentique

Architecture cible

La plateforme d'agents MJY, construite sur Claude & Anthropic (Claude Agent SDK, sous-agents Claude Code, MCP). Enrichie des meilleures idées de l'architecture Investec/ClawCortex, adaptées à notre échelle.

Architecture de la plateforme agentique MJY

La plateforme d'agents du groupe repose entièrement sur Claude & Anthropic : le Claude Agent SDK pour les agents qui tournent seuls, les sous-agents Claude Code pour l'usage piloté sans infra, et MCP pour brancher les systèmes existants (Supabase, n8n, Gmail, VPS).

Elle garde la structure MJY (Authority → agents-domaine/techniques → Praesidia → veille) et lui ajoute les meilleures idées de l'architecture pensée pour Investec Advisory (le système « ClawCortex »), adaptées à notre échelle : pas d'usine à gaz, juste ce qui nous rend plus fiables.

Principes

  • Piloté par événements - la plateforme réagit aux changements (nouveau tracking, nouvel avis, nouveau doc) plutôt que d'attendre qu'on lui demande.
  • Evidence-first - chaque réponse s'appuie sur des sources traçables (index pgvector, docs, historique), jamais sur une intuition.
  • Zero Trust, version légère - un agent n'a que les accès strictement nécessaires ; toute action externe passe par une validation. On monte en rigueur quand le volume le justifie, pas avant.
  • Observabilité - chaque action d'agent est journalisée et relisable (qui a fait quoi, avec quelles sources).
  • Maîtrise des coûts - suivi de la consommation API (prompt caching, scope minimal) ; pas de FinOps automatisé tant que ce n'est pas nécessaire.
  • Gouvernance simple - documentation par agent, supervision croisée, plutôt qu'une matrice RBAC avant l'organigramme.

Les couches

Couche Rôle Brique Claude / Anthropic
Interface Point d'entrée conversationnel (chat interne, WhatsApp/e-mail en entrée) Claude / Cowork
Authority - orchestrateur Identifie le contexte métier, compose agents + outils, applique les règles d'accès Claude Agent SDK
Agents-domaine & techniques Exécutent une expertise (support, logistique, dev, IA…) Sous-agents Claude Code / Agent SDK
Praesidia - supervision Relit le travail avant remontée : cohérence, données sensibles, fiabilité des sources Agent SDK
Serveurs MCP Intégrations partagées (Supabase, n8n, Gmail, pgvector, web) MCP
Couche Connaissance Index hybride (sémantique + lexical), store de preuves, résolution de version pgvector + prompt caching
Veille Agents proactifs par marque, en CRON, qui déposent un digest Agent SDK
Observabilité Journalisation, audit, relecture des sessions d'agents Logs + traçabilité
Infrastructure VPS Hostinger, PostgreSQL, DNS -

Catalogue des agents

Un agent = une expertise, pas une marque. Le contexte (ENGWE / KOBIKE / Miyan) est fourni à l'exécution.

  • Authority (orchestration) - le cerveau qui route.
  • Praesidia (supervision) - relit avant envoi externe.
  • Support / RAG, Logistique, Documents, Tâches / Ops, Conformité (agents-domaine).
  • ENGWE / KOBIKE / Miyan Watch (veille).
  • Développement, Automatisation, IA, VPS/Infra, Systèmes info (mes agents techniques).

Reprise de ClawCortex

L'architecture Investec/ClawCortex propose 10 agents. Voici lesquels valent le coup pour nous, adaptés :

Agent ClawCortex Chez nous Verdict
Document Intelligence Agent Documents ✅ à faire - utile dès que le patrimoine doc grandit
Version Resolver Brique de la couche Connaissance ✅ intéressant - « quelle est la bonne version de ce doc ? »
Fact Checking Étend Praesidia / agent Conformité ✅ à intégrer - cohérence des réponses SAV multi-canal
Activity Monitor Logique de veille événementielle 🟠 partiel - pertinent quand on aura le bus d'événements
Operational Intelligence Tâches / Ops 🟠 plus tard - synthèses et recommandations
Delivery Agent - 🟠 à évaluer - génération de livrables/présentations
Compliance Agent Agent Conformité ✅ déjà prévu
Media Intelligence Agents Watch ✅ déjà couvert par la veille
Social Presence - ⚪ hors périmètre pour l'instant
Origination Agent - ⚪ spécifique M&A, pas notre métier

On reprend les idées, pas le nom : tout est reconstruit sur Claude/Anthropic.

Gouvernance

  • Un agent, un scope - jamais d'accès large « au cas où ».
  • Supervision croisée - Praesidia relit ; Conformité et Fact-Checking se vérifient mutuellement.
  • La veille informe, elle n'agit pas - un digest ne déclenche jamais une action seule.
  • RBAC : après l'organigramme - définir les rôles quand la structure MJY sera posée.
  • Documentation par agent - IDENTITY / SOUL / MEMORY + guide, lisibles par la prochaine personne.

Feuille de route

Phase 1 - Quick wins (en cours). Stabiliser KOBIKE Tracking, socle pgvector d'ENGWE Connect, migration Supabase de MJY Task. Objectif : valider le modèle.

Phase 2 - Premier agent réel. Support/RAG en production sur un canal, avec prompt caching. Ajout de Document Intelligence + Version Resolver. Réponse sous supervision humaine.

Phase 3 - Authority + Praesidia. Orchestrateur (Agent SDK) qui route entre agents, premier superviseur qui relit avant envoi client. Intégration Fact-Checking.

Phase 4 - Veille + extension. Premier agent de veille (ENGWE Watch) en CRON, puis extension par nouveaux agents selon les besoins.

Phase 5 - Robustesse. Scoring de confiance par agent, double validation pour les actions irréversibles, filtrage automatique des données personnelles, et RBAC une fois l'organigramme posé.