Agents

Mit Agents bauen Sie eine Handelsautomatisierung visuell, ohne ein vollständiges Strategieskript zu schreiben. Auf der Arbeitsfläche QuantCraft — Agents verbinden Sie Knoten, die Daten abrufen, eine Entscheidung treffen (mit Regeln oder einem KI-Prompt), Trades platzieren und Benachrichtigungen senden — und führen den ganzen Ablauf dann als historischen Backtest oder als Forward-Lauf (live/Papier) aus. Die Funktion Agents steuert die Agents-Seite, ihren Navigationslink und ihr Pop-out-Fenster; das Ausführen von Agents über das Menü Agents im Chart und der New Agent Bulk Run von AutoTrading sind unabhängig davon verfügbar.

Öffnen Sie Agents über die Navigation (oder lösen Sie den Editor in ein eigenes Fenster heraus). Agents stützen sich auf andere Teile von QuantCraft: Der KI-Assistent betreibt AI-Prompt-Knoten; Backtests nutzen das Papierkonto, und Forward-Läufe können Orders an Ihr ausgewähltes verbundenes Broker-Konto senden.

Agent-Typen

Create agent fragt, welchen Typ Sie möchten, und dann nach einem Namen:

Test- und Optimization-Agents zeigen „Not available in this build.“, wenn diese Funktion abgeschaltet ist.

---

Knotentypen

Fügen Sie Knoten über die Auswahl hinzu (der Schedule trigger wird für Sie angelegt und steht nicht in der Auswahl).

Steuerknoten sind Strategy und AI Prompt — sie erzeugen einen booleschen Wert und steuern, ob ihre Kinder laufen.

---

Einen Agent bauen

1. Legen Sie in der Seitenleiste einen Agent an (Create agent → Trading Agent → benennen). Er erscheint als Draft mit bereits platziertem Schedule trigger.
2. Fügen Sie einen Knoten hinzu — klicken Sie auf die Schaltfläche + (Kind hinzufügen) eines Knotens, oder rechtsklicken Sie einen Knoten → Node Actions → New Child Node. Die Auswahl bietet nur Knoten an, die als Kinder des angeklickten Knotens gültig sind (zum Beispiel erscheint ein Execution-Knoten nur unter einem Strategy- oder AI-Prompt-Knoten, und ein Execution-Knoten bietet nur Notification-Kinder an).
3. Verbinden Sie Knoten — ziehen Sie den Umhängen-Griff eines Knotens auf einen anderen Knoten. Regeln:
   • Ein Knoten darf höchstens 2 Eltern haben.
   • Zyklen sind nicht erlaubt.
   • Ein Data-Knoten wird Elternknoten des Steuerknotens, den er speist.
   • Ein Execution-Knoten kann nur an einen Strategy- oder AI Prompt-Knoten angehängt werden, und seine einzigen Kinder können Notification-Knoten sein.
   • Klicken Sie auf eine Kante, um diese Verbindung zu löschen.
4. Konfigurieren Sie einen Knoten — klicken Sie ihn an, um das Inspektor-Panel zu öffnen, das typspezifische Tabs hat (Rules / Sources, plus Output; Strategy und AI Prompt haben außerdem einen Tab Received data). Trigger-, Strategy- und Execution-Knoten haben zudem einen Tab Parameters — siehe Bereitgestellte Parameter. Jede Regel- oder Quellenzeile lässt sich per Klick bearbeiten.
5. Legen Sie das vorgelagerte Gate fest — für Kinder eines Steuerknotens zeigt das Panel eine Zusammenfassung Upstream gate. Öffnen Sie sie, um zu wählen, wie die Eltern kombiniert werden (AND / OR) und welches Ergebnis jeder Elternknoten liefern muss (true / false). Konvention: Binden Sie einen Einstieg an true und den passenden Ausstieg an false.

Daten fließen im Graphen nach unten: Ein Strategy- oder AI-Prompt-Knoten liest alle OHLCV-, Fundamental- und Faktordaten von jedem Data-Knoten über ihm.

Möchten Sie den Agent lieber in Worten beschreiben? Nutzen Sie den AI Builder.

---

Knoten konfigurieren

Schedule trigger

Bei einem Backtest legt der Tab Scheduler des Test-Dialogs den Zeitplan fest und überschreibt diesen Knoten. Der Zeitplan des Knotens gilt für Forward-Läufe.

Datenquellen

Ein Data-Knoten kann mehrere Quellen gleichzeitig enthalten.

Das Schema beschreibt das JSON, das das Skript oder die URL zurückgibt; seine Felder sind das, was das Element Custom data eines Strategy-Knotens zum Vergleichen anbietet. Beim Speichern ohne Schema erscheint „Enter a JSON response schema.“

Ein Knoten erlaubt höchstens eine Fama-French-Quelle und höchstens eine Fundamentals-Quelle pro Berichtszeitraum.

Strategy-Elemente

Ein Strategy-Knoten kombiniert ein oder mehrere Elemente. Welche Elementarten verfügbar sind, hängt von den vorgelagerten Data ab (zum Beispiel brauchen Indicator-Regeln vorgelagertes OHLCV, und ein Fundamentals-Element braucht eine vorgelagerte Fundamentaldaten-Quelle).

Elementarten: Script, Indicator, Fundamentals, Trade Activity, Account Status, Custom data, Fama-French.

Vergleichsoperatoren

Indikatoren — das gesamte Indikator-Register des Charts steht zur Verfügung. Indikatoren mit einer Ausgabe sind u. a. SMA, EMA, WMA, RSI, ATR, OBV, VWAP, CCI, ROC, Williams %R, Parabolic SAR, HMA, DEMA, TEMA, Supertrend, VWMA, MFI, Awesome Oscillator, CMF und A/D Line. Bei Indikatoren mit mehreren Ausgaben — Bollinger Bands, MACD, Stochastic, Donchian, ADX, Ichimoku, Keltner, Stochastic RSI und PPO — wählen Sie, welche Linie verglichen wird (z. B. MACD-Linie gegen ihr Signal). Siehe Indikatorserien.

Trade Activity-Kennzahlen: Anzahl offener Trades, Gesamtmenge offener Trades sowie dieselben Zahlen, beschränkt auf das aktuelle Symbol. Account Status-Kennzahlen: Eigenkapital (Equity), Saldo, schwebender G/V.

Verwenden Sie Combine items with (Knotenebene) und Combine rules with (pro Element), um Bedingungen mit AND oder OR zu verknüpfen.

Execution-Aktionen

Jede Aktion ist Entry (open), Exit (close) oder Script. Das Symbol stammt aus der Lauf-Konfiguration — Sie tippen es hier nicht ein.

Entry (platziert eine Order)

Exit (schließt eine Position): Menge (Aktien) oder Prozentsatz der Position. Script: führt einen QuantCraft Agent Script aus.

Notification

Eine Regel sendet eine E-Mail an einen Empfänger, mit optionaler eigener Nachricht und einem Schalter Include Previous Node Output. Der Schalter Disable in Backtest auf Knotenebene überspringt E-Mails während eines Agent Tests.

---

Einen Agent backtesten

Klicken Sie im Editor-Kopf auf Test, um Test agent (backtest) zu öffnen.

Tab Setup

Tab Scheduler

Der Tab Scheduler ersetzt den Schedule-trigger-Knoten nur für den Backtest; Forward-Läufe folgen weiterhin dem Knoten.

Tab Optimization — erscheint, wenn der Agent bereitgestellte Parameter hat. Aktivieren Sie Run as optimization, um sie zu durchsuchen (Raster oder genetisch), statt einmal zu laufen; die Schaltfläche heißt dann Start optimization statt Start test.

Voraussetzungen und Steuerung

• Ein aktives verbundenes Handelskonto ist erforderlich — es dient zum Vorladen von Marktdaten, daher startet Test ohne es nicht.
• Während ein Lauf läuft, wird die Test-Schaltfläche zu Pause / Resume und Stop. Die Pause greift, nachdem der gerade laufende Knoten fertig ist.
• Ihre zuletzt verwendeten Test-Einstellungen werden gemerkt.

Ergebnisse — bei Erfolg wechselt der Kopf zu einem Tab Test Results: OHLC-Chart mit Indikator-Overlays, Trade-Historie, Eigenkapitalkurve und Kontokennzahlen, dazu der Screener-Rebalancing-Plan und Split-/Dividenden-Zeilen, wo zutreffend. Multi-Symbol-Läufe teilen sich ein Papierkonto, daher sind Trades und Kennzahlen zusammengefasst (nicht pro Symbol). Der Tab Output jedes Knotens streamt Live-Logs (abgerufene Daten, Strategie bestanden/nicht bestanden, KI-Antworten, Order-Ausführungen, E-Mail-Absichten); Strategy- und AI-Prompt-Knoten zeigen außerdem die exakten Eingaben im Tab Received data.

---

Bereitgestellte Parameter und Optimierung

Bei einem Trigger-, Strategy- oder Execution-Knoten können Sie im Tab Parameters numerische Einstellungen (ein Intervall, eine Indikatorperiode, einen Schwellenwert, eine Ordergröße …) mit einem Bereich als bereitgestellt (exposed) markieren. Bereitgestellte Parameter sind das, was der Tab Optimization des Test-Dialogs durchsucht und was ein KI-Optimierungs-Agent abstimmt. Siehe Optimierung, wie Raster- und genetische Suche funktionieren.

---

AI Builder

Die Schaltfläche AI Builder (Funkel-Symbol) im Kopf eines Trading Agents öffnet einen Chat neben der Arbeitsfläche. Beschreiben Sie den Agent in einfachem Deutsch, und Ihr verbundenes KI-Modell fügt Knoten hinzu, konfiguriert und verknüpft sie — und kann Agent Scripts in Ihren Arbeitsbereich schreiben.

• Der Modus Ask beantwortet Fragen zum Graphen, ohne ihn zu ändern; der Modus Build nimmt Änderungen vor.
• Änderungen werden live angewandt, und jede Antwort hat Keep / Undo.
• Sie können Ihren Nachrichten Dateien anhängen.
• Er nutzt dieselbe Modellverbindung wie QuantCraft AI; sein Token-Verbrauch zählt in das Token-Badge des Agents.

---

KI-Test- und Optimierungs-Agents

Test- und Optimization-Agents haben keinen Knotengraphen. Sie geben der KI ein Ziel — einen IDE-Algo oder einen Trading Agent — plus Instructions for the AI und Grenzen: Max iterations (eine Iteration = ein Backtest; die KI plant alle vorab), Max AI rounds, Max AI tokens und Max backtest windows. Aktivieren Sie Allow market data tools, damit sie QuantCraft Tools nutzen darf (standardmäßig aus). Sie können den Anweisungen Dateien anhängen.

Wenn Sie einen starten, arbeitet die KI in eigenen KI-gesteuerten Pop-out-Fenstern — führt Backtests und Optimierungen aus, speichert Erkenntnisse im Speicher — und schließt mit einer Zusammenfassung ab. Die Seite des Agents hat die Tabs Overview, Sessions, Windows und Memory, sodass Sie jede Sitzung verfolgen, ihren Iterationsplan und die Läufe sehen und Fenster schließen können.

Backtest- und Optimierungsergebnisse — einschließlich der Zusammenfassung durch eine KI — beschreiben nur historische Daten und garantieren keine Live-Ergebnisse.

---

Speichern, verwalten und überwachen

• Save entfernt das Badge Draft und behält eine gespeicherte Kopie des Graphen. Jede Änderung wird weiterhin lokal automatisch gesichert, doch sobald Sie einen gespeicherten Agent ändern, kehrt das Badge Draft mit einer Schaltfläche Undo zurück, die (nach Bestätigung) den Graphen auf Ihren letzten Speicherstand zurücksetzt.
• Rechtsklicken Sie in der Seitenleiste einen Agent, um ihn zu Rename, Duplicate oder Delete. Duplizieren klont den Graphen als neuen Entwurf.
• Agents als Dateien teilen (Desktop-App): Das Menü ⋯ im Kopf hat Export…, das den Agent als .qca-Datei speichert, und das Seitenleistenmenü hat Import…, um eine oder mehrere .qca-Dateien zu laden. Agent-Script-Verweise werden beim Import erneut mit Ihrem Arbeitsbereich verknüpft.
• Während eines Laufs zeigt jede Knotenkarte ein Live-Status-Badge — wartend, läuft, ok, fehlgeschlagen oder übersprungen — und streamt Ereignisse in ihren Tab Output.

---

Gut zu wissen

• Backtest- vs. Forward-Ausführung. Der Test eines Agents (Backtest) nutzt ein simuliertes Papierkonto. Forward-Läufe (Chart-Menü Agents, AutoTrading New Agent Bulk Run) nutzen das ausgewählte verbundene Broker-Konto und können echte Orders senden, wenn dieses Konto live ist. QuantCloud-Runner führen nur IDE-Algorithmen aus — keine Agents.
• Der Zeitplan gilt, sobald ein Lauf gestartet ist. Der Editor startet Agents nicht automatisch im Hintergrund. Nachdem Sie einen Forward-/Bulk-/Chart-Lauf gestartet haben, kommt der Takt vom Schedule trigger (oder bei Backtests von der Überschreibung durch den Tab Scheduler des Test-Dialogs).
• Strukturelle Grenzen: höchstens 2 Eltern pro Knoten, keine Zyklen, Execution-Knoten hängen nur an Strategy- oder AI-Prompt-Knoten, und die Kinder eines Execution-Knotens können nur Notification-Knoten sein.
• Fundamentaldaten in einem Backtest sind Premium-pflichtig (derselbe Gratisdaten-Zugang wie bei anderen Fundamentaldaten-Oberflächen, sofern aktiviert).

---

Siehe auch

• QuantCraft AI — der AI-Prompt-Knoten und wie sein Modell gewählt wird
• QuantCraft Tools — schreibgeschützte Tools, die AI-Prompt-Knoten und KI-Agents aufrufen können
• AutoTrading — Agent Bulk Run und lokale Forward-Überwachung
• Screener — Aktien nach Fundamentaldaten filtern, um sie als Bulk-Lauf-Ziele zu nutzen
• Kontomodell — das Papierkonto, Kennzahlen, Provision / Slippage
• Fundamentaldaten — Fundamentaldaten
• Fama-French-Faktoren — Fama-French-Faktoren
• Indikatorserien — Indikator-Overlays im Chart