QuantCraft AI

QuantCraft inclut un assistant IA intégré dans la barre latérale droite de l'IDE (Disposition de l'espace de travail) — un panneau de discussion qui vous aide à écrire et modifier du Python de stratégie de trading en tenant compte de votre espace de travail. Il voit le fichier ouvert dans l'éditeur, tous les fichiers que vous mentionnez avec @ et les grandes lignes de vos autres fichiers ouverts, de sorte que ses réponses et ses modifications restent dans le contexte. Il fonctionne comme un agent de codage dans l'IDE : il peut créer de nouveaux fichiers ou modifier des fichiers existants pour vous en un seul tour de discussion.

Pour l'utiliser, ouvrez la barre latérale droite et passez à l'onglet QuantCraft AI. Le modèle que vous connectez est commun à toute l'application — la même connexion alimente cette discussion, les nœuds AI Prompt et l'AI Builder dans les Agents, ainsi que les agents IA de Test / Optimization. Utilisez l'éditeur Python et Exécution du code pour valider toute modification de stratégie suggérée avec Test / Run.

Il existe aussi un panneau Documentation dans la même barre latérale — une référence statique de l'API de stratégie (cycle de vie, OHLCV, indicateurs, données fondamentales, facteurs, entrées, compte), ainsi que des pages Agent Scripts et Screener Script. Voir Référence.

---

Modes de l'assistant

Vous pouvez changer de mode et activer Auto-continue dans la zone de saisie, ou sous Assistant mode dans la boîte de dialogue API Providers.

---

Connecter un modèle

QuantCraft AI fonctionne avec plusieurs fournisseurs. Certains sont apportez votre propre clé (facturés sur votre propre compte chez le fournisseur) ; QuantCraft Premium et les options hébergées reposent à la place sur un accès géré. Ouvrez AI → API Providers dans le menu du haut (la boîte de dialogue s'intitule AI API Providers ; le lien de connexion de la discussion l'ouvre aussi), choisissez un fournisseur, puis renseignez ses champs.

GitHub Copilot et Cursor peuvent apparaître dans la liste, mais les tours de discussion ne sont pas encore câblés (maquettes d'interface) — et les fonctions IA des Agents les rejettent aussi. Utilisez Anthropic, DeepSeek (clé personnelle ou hébergé), OpenCode, QuantCraft Premium ou Custom LLM.

Collez la clé (lorsqu'elle est requise), choisissez le modèle et cliquez sur Save.

Custom LLM

Utilisez Custom LLM pour connecter votre propre modèle, ou un modèle auto-hébergé, compatible OpenAI.

La connexion est considérée comme prête dès que l'URL est définie. Dans l'application de bureau, le HTTP vers les fournisseurs passe par le plugin HTTP de Tauri ; les points de terminaison localhost / 127.0.0.1 sont autorisés. Les hôtes Custom LLM distants arbitraires ne sont pas configurables par l'utilisateur via une interface de liste d'autorisation — préférez un serveur local compatible OpenAI ou un fournisseur déjà pris en charge ci-dessus.

Où vivent les clés : les valeurs « apportez votre propre clé » sont stockées uniquement sur votre machine (dans le trousseau du système d'exploitation pour l'application de bureau, ou dans le stockage local de ce navigateur). Elles ne sont jamais envoyées à QuantCraft et ne sont transmises qu'au fournisseur que vous avez sélectionné. Si vous effacez les données de votre navigateur ou changez d'ordinateur, vous devrez saisir à nouveau la clé.

Où vont les requêtes : pour un fournisseur « apportez votre propre clé », QuantCraft AI appelle directement le fournisseur depuis votre machine avec votre clé. L'application de bureau (Tauri) utilise un pont HTTP afin que les requêtes ne soient pas bloquées par le CORS du navigateur — exécuter QuantCraft AI dans la version navigateur peut afficher un message « Request failed » lié au CORS ; utilisez la version de bureau pour la meilleure expérience.

Choisir un modèle

Chaque fournisseur a une liste déroulante de modèles à côté du champ de clé. Le badge de connexion en bas de la discussion indique le fournisseur actif et le nom court du modèle (par exemple Anthropic (Claude) · Claude Sonnet 4.6). Plusieurs fournisseurs peuvent être enregistrés — le badge affiche le plus récemment utilisé avec un suffixe +N lorsqu'il y a plus d'une clé.

Pour Anthropic, la liste propose Claude Sonnet 4.6, Claude Opus 4.8, Claude Opus 4.7, Claude Haiku 4.5 et d'autres variantes actuelles d'Opus / Sonnet. Choisissez celui auquel votre compte a accès. Si vous essayez d'envoyer un message sur la voie Anthropic sans clé enregistrée, l'assistant répond par un rappel d'en ajouter une.

---

Utiliser la discussion

• Saisissez dans la zone de saisie et appuyez sur Enter pour envoyer, Shift+Enter pour un saut de ligne.
• Tapez @ pour ouvrir un menu de mention de fichier et ajouter un autre fichier de l'espace de travail au contexte.
• Les réponses s'affichent en markdown avec des blocs de code.
• Stop interrompt une réponse en cours.

Zone de saisie et pièces jointes

• Le bouton Attach files — ouvre un sélecteur de fichiers. Vous pouvez aussi glisser-déposer des fichiers sur la zone de saisie, ou coller un fichier/une image depuis le presse-papiers.
• Une rangée de pastilles de pièces jointes au-dessus de la zone de texte montre chaque fichier mis en file. Chaque pastille affiche son nom (et une miniature pour les images) et un × pour la retirer.
• Tous les types de fichiers sont acceptés. Les fichiers image affichent une petite miniature en ligne dans le fil des messages après l'envoi.
• Les pièces jointes appartiennent au message avec lequel vous les envoyez — elles s'affichent à côté de ce message dans l'historique.
• Dans la discussion de l'IDE, les pièces jointes sont affichées mais leur contenu n'est pas envoyé au modèle. Pour partager le contenu d'un fichier de l'espace de travail, mentionnez-le plutôt avec @.

Pendant que l'assistant génère une réponse, la zone de saisie est désactivée avec un texte indicatif « Please wait… » et une petite ligne d'état apparaît dans la liste des messages (p. ex. Building API messages…, Streaming reply… 1,234 characters, Syncing to workspace folder on disk…).

---

Sessions de discussion

QuantCraft AI conserve un historique des sessions de discussion. Chaque session est une conversation à part entière, avec ses propres messages et pièces jointes. La barre en haut du panneau de discussion propose :

• New chat — démarre une session vide. Désactivé pendant que l'assistant travaille, tant qu'une modification de fichier est en attente, ou si votre discussion actuelle est déjà vide.
• Chats — une liste déroulante de toutes les sessions enregistrées, la plus récente en premier. Chaque entrée affiche son titre (déduit automatiquement du premier message de l'utilisateur) et l'heure de dernière mise à jour. Cliquez sur une ligne pour basculer, ou sur l'icône de corbeille pour la supprimer.

Les sessions sont enregistrées automatiquement (dans la configuration locale pour l'application de bureau, sinon dans le stockage local du navigateur) et survivent aux rechargements et aux redémarrages. Changer de discussion et en créer de nouvelles est bloqué pendant le streaming d'une réponse ou tant qu'une barre Accept/Undo n'est pas résolue — terminez ou annulez d'abord la modification.

---

Ce que l'assistant peut voir

À chaque message envoyé, QuantCraft AI construit la requête à partir de :

1. La documentation développeur QuantCraft intégrée (il connaît ainsi le cycle de vie, l'API du compte, les modules OHLCV / données fondamentales, les séries d'indicateurs, etc.).
2. Un instantané récent de l'espace de travail — le chemin du dossier d'espace de travail lié, le fichier actuellement ouvert dans l'éditeur, et la liste des onglets et dossiers ouverts.
3. Les tours précédents de la session de discussion active (vos messages et ses réponses).
4. Votre nouveau message ainsi que les pièces jointes éventuelles.

C'est pourquoi choisir un dossier d'espace de travail dans la barre latérale Files compte — sans dossier, l'assistant peut toujours répondre aux questions, mais il ne peut pas écrire de fichiers sur le disque et vous le dira.

---

Modifications de fichiers par l'assistant

En mode Agent, l'assistant peut renvoyer une ou plusieurs actions sur des fichiers dans une même réponse : créer un nouveau fichier, modifier le fichier actuellement dans l'éditeur, ou modifier un fichier nommé de l'espace de travail. Dans ce cas :

• Les nouveaux fichiers apparaissent dans un nouvel onglet du dossier lié ; les fichiers existants sont mis à jour sur place dans leur onglet.
• L'éditeur saute à l'emplacement modifié et surligne les lignes modifiées pour que vous puissiez vérifier ce que l'assistant a fait.
• Une barre en attente apparaît en bas de la discussion avec un bref résumé, ainsi que deux boutons :
  • Accept — conserver la modification. Le surlignage est retiré et vous pouvez continuer à discuter.
  • Undo — annuler la modification. Pour une édition, le contenu précédent du fichier est restauré. Pour un nouveau fichier, le nouvel onglet est supprimé.
• Tant que vous n'avez pas choisi Accept ou Undo, la discussion est gelée — vous ne pouvez ni changer de session ni envoyer un autre message. C'est voulu : cela garantit que vous examinez activement chaque modification.
• Pour les réponses multi-fichiers, la barre indique combien de modifications ont été appliquées. Le bouton Undo n'annule que la dernière étape ; examinez donc les surlignages onglet par onglet si nécessaire.

Stratégies multi-fichiers

En mode Agent, l'assistant peut découper une stratégie en modules d'aide dans des dossiers (indicators/, risk/, …) et les importer dans le fichier d'algo racine. Il garde les fonctions du cycle de vie (on_init, on_bar, …) dans le fichier racine et utilise des imports absolus depuis la racine de l'espace de travail, p. ex. from indicators.momentum import calc_rsi, sans fichiers __init__.py.

• L'assistant voit en entier les fichiers importés par le fichier actif ainsi que ceux qui l'importent. Il ne voit que les grandes lignes de vos autres fichiers — pour qu'il en modifie un, mentionnez-le avec @.
• Les modifications de fichiers de chaque réponse sont vérifiées avant d'être appliquées. Si une étape ne peut pas s'exécuter en toute sécurité (par exemple elle créerait un fichier déjà existant, ou réécrirait un fichier qu'il n'a vu qu'en grandes lignes), aucune étape n'est appliquée et la réponse en explique la raison.
• Une fois les modifications appliquées, les imports de l'espace de travail qui échoueraient à l'exécution (par exemple un module d'aide renommé sans mise à jour des fichiers qui l'importent) sont listés sous la réponse. L'agent les corrige à son tour suivant.

Synchronisation sur disque

Les fichiers sont aussi synchronisés avec le dossier d'espace de travail lié sur le disque (dans l'application de bureau). Dans la version navigateur, les fichiers sont toujours mis à jour dans l'éditeur et les onglets, mais ils ne sont pas répliqués sur le disque — la réponse le signale pour que vous sachiez utiliser la version de bureau pour une intégration complète des fichiers.

---

QuantCraft Tools intégrés

Un ensemble natif d'outils de marché en lecture seule — OHLCV, indicateurs, données fondamentales, screener, compte et positions — est activé par défaut et appelable directement depuis la discussion (et depuis les nœuds AI Prompt des agents). Gérez-le sous AI → MCPs (la ligne QuantCraft Tools (built-in) en haut). Voir QuantCraft Tools.

---

Outils du Screener

Lorsque la fonction AI Screener est activée, la discussion peut aussi piloter le Screener pour vous : ouvrir une fenêtre Screener, construire ou charger un filtre, l'exécuter et lire les résultats. La fenêtre affiche « The AI is using this window » et verrouille ses commandes pendant que l'IA travaille. Dans les modes Chat et Plan, l'IA n'obtient que le sous-ensemble en lecture seule (elle peut consulter les filtres et les résultats mais pas les modifier) ; le mode Agent obtient l'ensemble complet. Voir Screener.

---

Outils

Les outils sont des services de données externes que le modèle de la discussion peut appeler pour répondre. Ajoutez-les depuis AI → AI Tools.

• L'outil disponible est LLMQuant Data — activez-le avec la case Enable for chat et collez une API key (un lien « Get a key » est proposé).
• Une fois activé, l'assistant peut récupérer des données en direct en cours de conversation dans des catégories comme wiki et articles de recherche, prix d'actions et de cryptomonnaies, recherche d'ETF et composition, indicateurs macro, dépôts SEC et positions 13F, et données de marchés de prédiction.

Les outils ne s'attachent qu'aux fournisseurs de discussion fonctionnels (Anthropic, DeepSeek, OpenCode, Premium, Custom LLM). Copilot / Cursor ne sont pas implémentés pour la discussion, donc les outils ne s'exécutent jamais avec ces sélections.

---

Serveurs MCP

Les serveurs MCP (Model Context Protocol) exposent leurs propres outils à l'assistant. Ajoutez-les et gérez-les depuis AI → MCPs. La liste commence par la ligne intégrée QuantCraft Tools (built-in) ; chaque serveur enregistré dispose d'un interrupteur Enabled for chat ainsi que de Edit / Remove, et les outils des serveurs activés deviennent disponibles dans la discussion.

Pour en ajouter un, cliquez sur Add server et choisissez un Transport :

Donnez un Name au serveur, utilisez Test connection pour le vérifier (il indique combien d'outils le serveur expose), puis Apply pour l'ajouter à la liste et Save pour le conserver.

---

Nœuds AI Prompt dans les Agents

Dans un Agent, vous pouvez ajouter un nœud AI Prompt — l'équivalent IA d'un nœud Strategy.

• Vous écrivez un seul prompt en texte libre posant une question oui/non, p. ex. « Compte tenu de l'évolution récente des prix et des données fondamentales, s'agit-il d'une configuration haussière ? » Il n'y a pas de règles structurées.
• Une section Data sent to the AI affiche des pastilles pour les données amont que reçoit le modèle (fenêtre OHLCV, données fondamentales, etc.). Liez un parent Data, sinon le nœud avertit que l'IA n'a aucune entrée.
• La réponse de l'IA est forcée à true / false, et ce résultat conditionne les nœuds enfants via la porte amont — exactement comme un résultat de Strategy.
• Le modèle peut aussi appeler les QuantCraft Tools en lecture seule (OHLCV, indicateurs, données fondamentales, screener, compte, positions) limités à l'exécution.

Le modèle qui l'exécute dépend de votre connexion active :

• QuantCraft Premium — l'appel s'exécute côté serveur avec l'accès qui vous est attribué. Seul un octroi Claude fonctionne ici ; un octroi DeepSeek interrompt l'exécution avec « not supported for AI Prompt nodes yet ».
• Apportez votre propre clé (Anthropic, OpenCode ou Custom LLM) — l'appel s'exécute depuis l'application avec votre propre clé, qui n'est jamais envoyée au serveur.

DeepSeek — avec votre clé ou hébergé — ne fonctionne pas encore pour les nœuds AI Prompt.

La consommation de jetons des nœuds AI Prompt d'Agent Test et de l'AI Builder est suivie par agent et affichée sous forme de badge dans l'en-tête de l'éditeur : Tokens · This month: … · Lifetime: … (le chiffre mensuel se remet à zéro chaque mois civil).

---

Conseils

• Liez d'abord un dossier d'espace de travail. Dans la barre latérale Files, choisissez votre dossier de projet. Sans dossier, l'assistant peut répondre aux questions mais ne peut ni créer ni modifier de fichiers sur le disque.
• Soyez explicite sur les chemins de fichiers. Lorsque vous demandez une modification, mentionnez le titre de l'onglet ou un chemin comme utils/foo.py. L'assistant comprend les deux.
• Utilisez Undo sans retenue. Il vaut mieux laisser l'assistant tenter une modification multi-fichiers et annuler que de micro-gérer chaque étape — l'annulation restaure instantanément le tampon de l'éditeur.
• Changez de modèle selon la tâche. Utilisez un modèle Claude plus rapide pour les modifications courantes, un plus puissant (Opus) pour les gros refactorings ou la conception de stratégie.
• Gardez vos clés en sécurité. Les clés personnelles ne vivent que sur cette machine. Traitez-les comme des mots de passe — ne les collez nulle part en dehors de la boîte de dialogue AI API Providers.