Lab · note d'architecture

Construire un agent de trading de zéro

Six services, un seul VPS, et une règle que je ne plierai pas : le modèle propose, l'humain dispose. Voici la note d'architecture de la plateforme — ce qui tourne aujourd'hui, à quoi doit ressembler le garde-fou de risque avant qu'un ordre ne parte, et comment l'ensemble est déployé par étapes.

Ouvrir la plateforme Espace privé, connexion requise

Où en est le projet. La plateforme en ligne, c'est la tranche 1 : recherche multi-agents sur les actions européennes et américaines, watchlists, rapports HTML et suivi du coût par appel — sans courtier connecté et avec le trading live désactivé par construction. L'analytique de portefeuille, le backtesting, la file d'approbation et la passerelle d'exécution décrits ci-dessous relèvent de l'architecture cible, pas d'une fonctionnalité livrée. Ils sont signalés comme tels tout du long.

01 · Architecture système

Six services, découplés à dessein

La séparation n'est pas une élégance : le moteur d'agents est le composant qui a le plus de chances de tomber, il doit donc pouvoir planter sans emporter l'API, la base ni le site avec lui.

1 · Tableau de bord web
analyse · watchlists · rapports · coût  — en ligne
↓ REST
2 · API backend
authentification · file de jobs · routage  — en ligne
Données de marché
prix · actualités · dépôts
en ligne
3 · Moteur d'agents
débat haussier / baissier · note
en ligne
4 · Risque & exécution
contrôles · API courtier
non construit
↓ stockage persistant
5 · PostgreSQL (runs, usage, watchlists) · Redis (file) — en ligne  |  6 · journal d'audit de chaque tour d'agent — en ligne
01

Frontend

Tableau de bord responsive : lancer une analyse, suivre son étape, lire le débat, télécharger le rapport, surveiller la dépense.

02

API backend

FastAPI : authentification, soumission des jobs, historique, watchlists, reporting des coûts. Un opérateur, un mot de passe, des sessions signées.

03

Moteur d'agents

TradingAgents sur LangGraph : quatre analystes en parallèle, puis un débat haussier/baissier, un débat de risque et une note à cinq niveaux.

04

Passerelle risque & exécution

Le composant qui n'existe pas encore — et la raison pour laquelle rien ne peut trader aujourd'hui. Limites dures et appels courtier vivent hors du modèle, jamais dedans.

05

Persistance

Chaque run, section, compte de tokens et coût est stocké : la piste d'audit est une fonctionnalité, pas un fichier de log.

06

Passerelle assistant

Un bot de messagerie qui livre un rapport terminé ou répond à « qu'a dit le dernier run NVDA » sans ouvrir le tableau de bord.

02 · Gestion du risque

Ce qui doit être vrai avant qu'un ordre existe

  • Aucune exécution directe par le modèle. Les agents produisent une recommandation et une justification. Ils n'ont ni identifiant, ni endpoint, ni outil capable d'atteindre un courtier.
  • Validation par les règles d'abord. Plafonds d'exposition, taille de position, stop-loss et éligibilité des instruments sont du code déterministe, vérifié avant toute mise en file.
  • Humain dans la boucle. Un ordre reste dans une file d'approbation jusqu'à validation par une personne nommée — avec le raisonnement de l'agent attaché.
  • Coupe-circuit. Une commande arrête immédiatement tout workflow automatisé, et l'arrêt est journalisé.
Pipeline d'exécution cible
1 · Analyse de marchéen ligne
2 · Stratégie & contrôles de risquenon construit
3 · Approbation humainenon construit
4 · Soumission de l'ordrebloqué
5 · Réconciliation & auditbloqué

Les étapes 4 et 5 sont bloquées par construction : la plateforme est livrée avec le trading live désactivé et aucun connecteur courtier dans le code.

Maquette d'un tableau de bord de risque : jauge de drawdown à 12 %, courbe d'équité, limite de perte journalière, drawdown glissant maximal et P&L temps réel
Moniteur de risque et d'exposition cible — jauge de drawdown, limite glissante, plafond de perte journalière et P&L en direct. Maquette, pas un écran livré.
03 · Modules fonctionnels

Ce que la plateforme expose — et à quoi cela ressemblera

En ligne aujourd'hui

Analyse sur actions et ETF américains et européens · watchlists · rapports HTML autonomes avec historique complet · registre des tokens et des coûts par appel · six fournisseurs LLM, sortie en français ou en anglais. C'est tout le produit, et il ne ressemble pas aux maquettes ci-dessous.

Interface cible

Maquette d'une vue de marché : indices majeurs, matières premières, crypto et watchlist

Vue de marché

prévu

Indices, matières premières, crypto et watchlist en direct sur un seul écran — le point d'entrée avant de lancer une analyse.

Maquette d'un écran de recherche IA : sélections haussières, objectifs IA, taux de réussite et panneau de test à terme

Terminal de recherche IA

partiellement en ligne

Rapports de thèse, transcriptions des débats d'agents et notation haussier/baissier. Les rapports et transcriptions existent ; la vue classée et notée n'existe pas.

Maquette d'analytique de portefeuille : ratio de Sharpe, rendement cumulé face à l'indice, allocation d'actifs et métriques de risque

Analytique de portefeuille

prévu

Sharpe, drawdown, volatilité, allocation et comparaison à un indice — conçu, pas livré. Rien n'étant relié à un courtier, cela tournerait d'abord sur des positions déclarées.

Maquette de résultats de backtest : courbe d'équité, drawdown, grille de rendements mensuels, statistiques et liste de trades

Backtesting

ensuite

Simulation historique avec frais et slippage — la porte qui décide si une note porte réellement une information. C'est l'étape 3 de la feuille de route.

Maquette d'une file d'approbation : ordres en attente listés par utilisateur avec actions approuver et refuser

Gestion des ordres & approbation

bloqué

La zone de staging où une recommandation d'agent attend un humain nommé. Elle n'a de sens qu'une fois le moteur de risque construit — et aucun courtier ne la soutient aujourd'hui.

Toutes les images de cette page sont des maquettes d'interface cible, pas des captures de la plateforme en fonctionnement. L'interface réellement livrée en tranche 1 est plus sobre : un formulaire d'analyse, le suivi d'étape, les transcriptions de débat, le rapport HTML et le registre des coûts.

04 · Hébergement

Un seul VPS, aucun dégât collatéral

Composant Déploiement Impact
Ce siteNon touché, conteneur séparéaucun
Passerelle assistantConteneur indépendantaucun
Moteur d'agentsWorker isolé, file Redisun run à la fois
API & baseFastAPI + PostgreSQL, volumes dédiés~400 Mo de RAM
Reverse proxyTraefik existant, règle d'hôte et certificat dédiésaucun port publié
Appels de modèlesAPI externes, aucune inférence localepas de GPU
05 · Déploiement

Cinq étapes, et où se situe la limite

01

Mise en place

Environnement, dépendances, conteneurs.
fait

02

Validé

Runs de bout en bout sur des valeurs US et UE, coût mesuré par run.
fait

03

Backtest

Test historique avec frais et slippage.
ensuite

04

Papier

Flux réels, exécutions simulées, aucun capital.
prévu

05

Live

Exécution courtier sous garde-fous et approbation humaine.
bloqué

Les étapes 3 à 5 restent fermées tant qu'une note n'a pas démontré qu'elle porte une information. Publier une plateforme de trading est facile ; en publier une qui a gagné le droit de toucher du capital, c'est le travail. D'ici là, la plateforme produit de la recherche, et le dit.

Voir la partie qui tourne

Le moteur d'analyse, les transcriptions des débats, les rapports et le registre des coûts sont en ligne sur la plateforme. Le reste est une feuille de route, volontairement verrouillée.

Ouvrir la plateforme Retour au Lab