Agents

Les Agents vous permettent de construire une automatisation de trading de façon visuelle, sans écrire un script de stratégie complet. Sur le canevas QuantCraft — Agents, vous reliez des nœuds qui récupèrent des données, prennent une décision (avec des règles ou un prompt IA), passent des ordres et envoient des alertes — puis vous exécutez l'ensemble du flux comme un backtest historique ou comme une exécution forward (réelle/papier). La fonction Agents contrôle la page Agents, son lien de navigation et sa fenêtre détachable ; l'exécution d'agents depuis le menu Agents du graphique et le New Agent Bulk Run d'AutoTrading restent disponibles quoi qu'il arrive.

Ouvrez Agents depuis la navigation (ou détachez l'éditeur dans sa propre fenêtre). Les agents s'appuient sur d'autres parties de QuantCraft : l'assistant IA alimente les nœuds AI Prompt ; les backtests utilisent le compte papier, et les exécutions forward peuvent soumettre des ordres à votre compte de courtier connecté sélectionné.

Types d'agents

Create agent demande quel type vous voulez, puis un nom :

Les agents Test et Optimization affichent « Not available in this build. » lorsque cette fonction est désactivée.

---

Types de nœuds

Ajoutez des nœuds depuis le sélecteur (le Schedule trigger est créé pour vous et ne figure pas dans le sélecteur).

Les nœuds de condition sont Strategy et AI Prompt — ils produisent un booléen et contrôlent si leurs enfants s'exécutent.

---

Construire un agent

1. Créez un agent dans la barre latérale (Create agent → Trading Agent → nommez-le). Il apparaît en Draft avec un Schedule trigger déjà en place.
2. Ajoutez un nœud — cliquez sur le bouton + (ajouter un enfant) d'un nœud, ou clic droit sur un nœud → Node Actions → New Child Node. Le sélecteur ne propose que les nœuds valides comme enfants de celui sur lequel vous avez cliqué (par exemple, un nœud Execution n'apparaît que sous un nœud Strategy ou AI Prompt, et un nœud Execution ne propose que des enfants Notification).
3. Connectez les nœuds — faites glisser la poignée de re-parentage d'un nœud sur un autre nœud. Règles :
   • Un nœud peut avoir au plus 2 parents.
   • Les cycles ne sont pas autorisés.
   • Un nœud Data devient le parent du nœud de condition qu'il alimente.
   • Un nœud Execution ne peut se rattacher qu'à un nœud Strategy ou AI Prompt, et ses seuls enfants possibles sont des nœuds Notification.
   • Cliquez sur une arête pour supprimer ce lien.
4. Configurez un nœud — cliquez dessus pour ouvrir le panneau inspecteur, qui comporte des onglets propres au type (Rules / Sources, plus Output ; Strategy et AI Prompt ont aussi un onglet Received data). Les nœuds Trigger, Strategy et Execution ont aussi un onglet Parameters — voir Paramètres exposés. Chaque ligne de règle ou de source se modifie en cliquant dessus.
5. Définissez la porte amont — pour les enfants d'un nœud de condition, le panneau affiche un résumé Upstream gate. Ouvrez-le pour choisir comment les parents se combinent (AND / OR) et quel résultat chaque parent doit produire (true / false). Convention : conditionnez une entrée sur true et la sortie correspondante sur false.

Les données circulent vers le bas du graphe : un nœud Strategy ou AI Prompt lit toutes les données OHLCV, fondamentales et de facteurs de chaque nœud Data situé au-dessus de lui.

Vous préférez décrire l'agent avec des mots ? Utilisez l'AI Builder.

---

Configurer les nœuds

Schedule trigger

Pour un backtest, le calendrier est défini par l'onglet Scheduler de la fenêtre Test, qui remplace ce nœud. Le calendrier du nœud s'applique aux exécutions forward.

Sources de données

Un nœud Data peut contenir plusieurs sources à la fois.

Le schéma décrit le JSON renvoyé par le script ou l'URL ; ses champs sont ceux que l'élément Custom data d'un nœud Strategy vous permet de comparer. L'enregistrement sans schéma affiche « Enter a JSON response schema. »

Un nœud autorise au plus une source Fama-French et au plus une source Fundamentals par période de reporting.

Éléments de Strategy

Un nœud Strategy combine un ou plusieurs éléments. Les types d'éléments disponibles dépendent des Data en amont (par exemple, les règles Indicator nécessitent un OHLCV en amont, et un élément Fundamentals nécessite une source de données fondamentales en amont).

Types d'éléments : Script, Indicator, Fundamentals, Trade Activity, Account Status, Custom data, Fama-French.

Opérateurs de comparaison

Indicateurs — le registre complet d'indicateurs du graphique est disponible. Les indicateurs à sortie unique incluent SMA, EMA, WMA, RSI, ATR, OBV, VWAP, CCI, ROC, Williams %R, Parabolic SAR, HMA, DEMA, TEMA, Supertrend, VWMA, MFI, Awesome Oscillator, CMF et A/D Line. Les indicateurs à sorties multiples — Bollinger Bands, MACD, Stochastic, Donchian, ADX, Ichimoku, Keltner, Stochastic RSI et PPO — vous laissent choisir la ligne à comparer (p. ex. la ligne MACD par rapport à son signal). Voir Séries d'indicateurs.

Métriques Trade Activity : nombre d'opérations ouvertes, quantité totale des opérations ouvertes, ainsi que les mêmes comptes restreints au symbole courant. Métriques Account Status : capital (equity), solde, P/L flottant.

Utilisez Combine items with (au niveau du nœud) et Combine rules with (par élément) pour joindre des conditions avec AND ou OR.

Actions d'Execution

Chaque action est une Entry (open), une Exit (close) ou un Script. Le symbole provient de la configuration de l'exécution — vous ne le saisissez pas ici.

Entry (passe un ordre)

Exit (clôture une position) : Quantité (actions) ou Pourcentage de la position. Script : exécute un Agent Script QuantCraft.

Notification

Une règle envoie un e-mail à un destinataire, avec un message personnalisé optionnel et un interrupteur Include Previous Node Output. L'interrupteur Disable in Backtest au niveau du nœud ignore les e-mails pendant un Agent Test.

---

Backtester un agent

Cliquez sur Test dans l'en-tête de l'éditeur pour ouvrir Test agent (backtest).

Onglet Setup

Onglet Scheduler

L'onglet Scheduler remplace le nœud Schedule trigger pour le backtest uniquement ; les exécutions forward suivent toujours le nœud.

Onglet Optimization — apparaît lorsque l'agent a des paramètres exposés. Cochez Run as optimization pour les parcourir (grille ou génétique) au lieu d'exécuter une seule fois ; le bouton affiche alors Start optimization au lieu de Start test.

Prérequis et commandes

• Un compte de trading connecté actif est requis — il sert à précharger les données de marché, donc Test ne démarre pas sans lui.
• Pendant une exécution, le bouton Test devient Pause / Resume et Stop. La pause prend effet une fois le nœud en cours terminé.
• Vos derniers réglages de Test sont mémorisés.

Résultats — en cas de succès, l'en-tête passe à un onglet Test Results : graphique OHLC avec superpositions d'indicateurs, historique des opérations, courbe de capital et métriques du compte, plus le calendrier de rééquilibrage du Screener et les lignes de fractionnement / dividende lorsqu'elles s'appliquent. Les exécutions multi-symboles partagent un seul compte papier ; les opérations et métriques sont donc combinées (pas par symbole). L'onglet Output de chaque nœud diffuse des journaux en direct (données récupérées, réussite/échec de la stratégie, réponses de l'IA, exécutions d'ordres, intentions d'e-mail) ; les nœuds Strategy et AI Prompt affichent aussi les entrées exactes dans leur onglet Received data.

---

Paramètres exposés et optimisation

Sur un nœud Trigger, Strategy ou Execution, l'onglet Parameters vous permet de marquer des réglages numériques (un intervalle, une période d'indicateur, un seuil, une taille d'ordre…) comme exposés, avec une plage. Les paramètres exposés sont ce que l'onglet Optimization de la fenêtre Test parcourt, et ce qu'un agent d'optimisation IA ajuste. Voir Optimisation pour le fonctionnement de la recherche par grille et génétique.

---

AI Builder

Le bouton AI Builder (icône étincelle) dans l'en-tête d'un agent Trading ouvre une discussion à côté du canevas. Décrivez l'agent en langage courant et votre modèle d'IA connecté ajoute, configure et relie les nœuds pour vous — et peut écrire des Agent Scripts dans votre espace de travail.

• Le mode Ask répond aux questions sur le graphe sans le modifier ; le mode Build apporte des modifications.
• Les modifications s'appliquent en direct, et chaque réponse propose Keep / Undo.
• Vous pouvez joindre des fichiers à vos messages.
• Il utilise la même connexion de modèle que QuantCraft AI ; sa consommation de jetons est comptée dans le badge de jetons de l'agent.

---

Agents IA de test et d'optimisation

Les agents Test et Optimization n'ont pas de graphe de nœuds. Vous donnez à l'IA une cible — un algo de l'IDE ou un Trading agent — plus des Instructions for the AI, et des limites : Max iterations (une itération = un backtest ; l'IA les planifie toutes à l'avance), Max AI rounds, Max AI tokens et Max backtest windows. Cochez Allow market data tools pour lui permettre d'utiliser QuantCraft Tools (désactivé par défaut). Vous pouvez joindre des fichiers aux instructions.

Lorsque vous en démarrez un, l'IA travaille dans ses propres fenêtres détachables contrôlées par l'IA — exécutant des backtests et des optimisations, enregistrant ses constats en mémoire — et termine par un résumé. La page de l'agent comporte les onglets Overview, Sessions, Windows et Memory, pour suivre chaque session, voir son plan d'itérations et ses exécutions, et fermer des fenêtres.

Les résultats de backtest et d'optimisation — y compris le résumé qu'en fait une IA — ne décrivent que des données historiques et ne garantissent pas les résultats en réel.

---

Enregistrer, gérer et surveiller

• Save retire le badge Draft et conserve une copie enregistrée du graphe. Chaque modification est toujours sauvegardée automatiquement en local, mais dès que vous modifiez un agent enregistré, le badge Draft revient avec un bouton Undo qui (après confirmation) remet le graphe dans l'état de votre dernier enregistrement.
• Dans la barre latérale, faites un clic droit sur un agent pour Rename, Duplicate ou Delete. Dupliquer clone le graphe en nouveau brouillon.
• Partager des agents sous forme de fichiers (application de bureau) : le menu ⋯ de l'en-tête propose Export…, qui enregistre l'agent dans un fichier .qca, et le menu de la barre latérale propose Import… pour charger un ou plusieurs fichiers .qca. Les références aux Agent Scripts sont re-liées à votre espace de travail à l'import.
• Pendant une exécution, chaque carte de nœud affiche un badge d'état en direct — en attente, en cours, ok, échec ou ignoré — et diffuse les événements dans son onglet Output.

---

Bon à savoir

• Exécution backtest vs forward. Un Test d'agent (backtest) utilise un compte papier simulé. Les exécutions forward (menu Agents du graphique, New Agent Bulk Run d'AutoTrading) utilisent le compte de courtier connecté sélectionné et peuvent soumettre des ordres réels lorsque ce compte est réel. Les exécuteurs QuantCloud ne font tourner que des algorithmes de l'IDE — pas des agents.
• Le calendrier s'applique une fois l'exécution démarrée. L'éditeur ne démarre pas automatiquement les agents en arrière-plan. Après avoir lancé une exécution forward / en masse / sur graphique, la cadence provient du Schedule trigger (ou du remplacement par l'onglet Scheduler de la fenêtre Test pour les backtests).
• Limites structurelles : 2 parents au maximum par nœud, pas de cycles, les nœuds Execution ne se rattachent qu'aux nœuds Strategy ou AI Prompt, et les enfants d'un nœud Execution ne peuvent être que des nœuds Notification.
• Les données fondamentales dans un backtest sont réservées à Premium (même accès aux données gratuites que pour les autres interfaces de données fondamentales lorsqu'il est activé).

---

Voir aussi

• QuantCraft AI — le nœud AI Prompt et la façon dont son modèle est choisi
• QuantCraft Tools — outils en lecture seule que les nœuds AI Prompt et les agents IA peuvent appeler
• AutoTrading — Agent Bulk Run et suivi forward local
• Screener — filtrer des actions par données fondamentales pour les utiliser comme cibles d'une exécution en masse
• Modèle de compte — le compte papier, les métriques, commission / slippage
• Données fondamentales — données fondamentales
• Facteurs Fama-French — facteurs Fama-French
• Séries d'indicateurs — superpositions d'indicateurs du graphique