ページエージェント · 25 / 29

エージェント

エージェントを使うと、完全なストラテジースクリプトを書かなくても、トレーディングの自動化を視覚的に構築できます。QuantCraft — Agents キャンバスで、データを取得し、判断を下し（ルールまたは AI プロンプトで）、取引を行い、アラートを送るノードをつなぎ合わせます。そのうえで、フロー全体を過去データのバックテスト、またはフォワード（ライブ／ペーパー）実行として動かします。Agents 機能は、Agents ページ、そのナビゲーションリンク、ポップアウトウィンドウを制御します。チャートの Agents メニューからのエージェント実行と、AutoTrading の New Agent Bulk Run は、この設定にかかわらず利用できます。

ナビゲーションから Agents を開きます（エディターを独立したウィンドウにポップアウトすることもできます）。エージェントは QuantCraft の他の部分を利用します。AI アシスタントが AI Prompt ノードを動かし、バックテストはペーパーアカウントを使い、フォワード実行は選択した接続済みブローカーアカウントに注文を送信できます。

エージェントの種類

Create agent は、まず種類を、次に名前を尋ねます。

種類	内容
Trading Agent	スケジュールに従って取引するノードグラフ。このページの大部分はこれに関するものです。新規作成したものは必ず Draft として始まり、すでに 1 つの Schedule trigger ノードを含んでいます。これは他のすべてのノードがぶら下がるエントリーポイントです。
Test Agent	接続済みの AI が、IDE のアルゴまたはトレーディングエージェントを、複数のパラメータと日付範囲でバックテストし、その堅牢性を報告します。AI のテスト／最適化エージェントを参照してください。
Optimization Agent	接続済みの AI が、指定した範囲内でグリッド／遺伝的最適化を実行し、最良のセットを確認して結果を要約します。

Test と Optimization のエージェントは、その機能がオフのときは「Not available in this build.」と表示されます。

ノードの種類

ピッカーからノードを追加します（Schedule trigger は自動で配置されるため、ピッカーには表示されません）。

ノード	動作	設定する内容
Schedule trigger	固定のスケジュールでエージェントを実行します。すべてのエージェントのエントリーポイントで、削除できず、親も持ちません。	頻度＋間隔。
Data	入力を取得します：OHLCV、ファンダメンタルデータ、Fama-French ファクター、またはカスタムデータ。1 つの Data ノードが複数のソースを持てます。	1 つ以上のデータソース。
Strategy	上流のデータを、子ノードを制御する真偽の判断に変換します。	ストラテジー項目（ルール）＋その組み合わせ方。
AI Prompt	上流のデータについて AI にはい／いいえの質問をし、その答えが子ノードを制御します。モデルは、この実行に限定された読み取り専用ツール（OHLCV、インジケーター、ファンダメンタルデータ、スクリーナー、アカウント、ポジション）も呼び出せます。QuantCraft Toolsを参照。	自由記述のプロンプト。QuantCraft AIを参照。
Execution	取引を開始または決済します。バックテストはペーパーアカウントを使い、フォワード／バルク実行は、認証情報がある場合に選択した接続済みブローカーアカウントへ注文を送信します。Strategy または AI Prompt ノードにのみ接続できます。	1 つ以上の注文アクション。
Notification	メールアラートを送信します（メールが唯一の方法です）。どのノードにも接続できます。	メールルール＋Disable in Backtest のトグル。

ゲートノードは Strategy と AI Prompt です。真偽値を生成し、子ノードを実行するかどうかを制御します。

エージェントの構築

サイドバーでエージェントを作成します（Create agent → Trading Agent → 名前を付ける）。Schedule trigger がすでに配置された Draft として表示されます。
ノードを追加します。ノードの +（子を追加）ボタンをクリックするか、ノードを右クリックして Node Actions → New Child Node を選びます。ピッカーには、クリックしたノードの子として有効なノードだけが表示されます（たとえば、Execution ノードは Strategy または AI Prompt ノードの下にのみ表示され、Execution ノードの子としては Notification ノードのみが選べます）。
ノードを接続します。ノードの親付け替えハンドルを別のノードにドラッグします。ルール：
- ノードの親は最大 2 つです。
- 循環は許可されません。
- Data ノードは、それが供給するゲートノードの親になります。
- Execution ノードは Strategy または AI Prompt ノードにのみ接続でき、その子になれるのは Notification ノードのみです。
- エッジをクリックすると、そのリンクを削除できます。
ノードを設定します。ノードをクリックするとインスペクターのパネルが開き、タイプ別のタブ（Rules / Sources と Output。Strategy と AI Prompt には Received data タブもあります）が表示されます。Trigger、Strategy、Execution ノードには Parameters タブもあります。公開パラメータを参照してください。ルールやソースの各行は、クリックして編集できます。
上流ゲートを設定します。ゲートノードの子では、パネルに Upstream gate の概要が表示されます。これを開いて、親をどう組み合わせるか（AND / OR）と、各親がどの結果を出す必要があるか（true / false）を選びます。慣例：エントリーは true、対応するエグジットは false でゲートします。

データはグラフの下方向へ流れます。Strategy または AI Prompt ノードは、その上にあるすべての Data ノードの OHLCV、ファンダメンタルデータ、ファクターデータをすべて読み取ります。

エージェントを言葉で説明したい場合は、AI Builderを使ってください。

ノードの設定

Schedule trigger

フィールド	オプション
Frequency	Seconds、Minutes、Hours、Days、または Bars。
Interval	1 以上の整数（例：5 バーごと）。

バックテストでは、スケジュールは Test ダイアログの Scheduler タブで設定され、このノードより優先されます。ノードのスケジュールはフォワード実行に適用されます。

データソース

1 つの Data ノードは、複数のソースを同時に持てます。

種類	設定する内容
System · OHLCV	プロバイダー（接続済みブローカーまたは QuantCraft）、時間枠、開始／終了ウィンドウ（それぞれ「now」、相対的な「N 単位前」、または絶対的な日付／時刻）。
System · Fundamentals	報告期間（Quarterly または Annual）、`shift`（0 以上）、`periods`（1 以上）。
System · Fama-French	ファクターのデータセット（Data ノードごとに 1 つ）。
Script	QuantCraft の Agent Script、および必須の JSON レスポンススキーマ。
URL	JSON を返す URL、および必須の JSON レスポンススキーマ。

スキーマは、スクリプトまたは URL が返す JSON を記述します。そのフィールドが、Strategy ノードの Custom data 項目で比較できる対象になります。スキーマなしで保存すると「Enter a JSON response schema.」と表示されます。

1 つのノードに許されるのは、Fama-French ソースが最大 1 つ、および報告期間ごとに Fundamentals ソースが最大 1 つです。

Strategy 項目

Strategy ノードは 1 つ以上の項目を組み合わせます。利用できる項目の種類は、上流の Data によって異なります（たとえば、Indicator ルールには上流の OHLCV が必要で、Fundamentals 項目には上流のファンダメンタルデータソースが必要です）。

項目の種類：Script、Indicator、Fundamentals、Trade Activity、Account Status、Custom data、Fama-French。

比較演算子

演算子	意味
Equals / Not equals	`=` / `≠`
Greater than / Greater or equal	`>` / `≥`
Less than / Less or equal	`<` / `≤`
Crosses above / Crosses below	系列が比較対象の値をクロスする
Between / Outside	範囲の内側／外側
Rising / Falling	系列が上昇／下降（右辺の値なし）
% change greater than / % change less than	基準値に対する変化率

インジケーター — チャートのインジケーターレジストリがすべて利用できます。単一出力のインジケーターには、SMA、EMA、WMA、RSI、ATR、OBV、VWAP、CCI、ROC、Williams %R、Parabolic SAR、HMA、DEMA、TEMA、Supertrend、VWMA、MFI、Awesome Oscillator、CMF、A/D Line があります。複数出力のインジケーター（Bollinger Bands、MACD、Stochastic、Donchian、ADX、Ichimoku、Keltner、Stochastic RSI、PPO）では、比較するラインを選べます（例：MACD ラインとそのシグナル）。インジケーター系列を参照してください。

Trade Activity の指標：建玉の取引数、建玉の取引の合計数量、および現在のシンボルに限定した同様の数。 Account Status の指標：資産（equity）、残高、含み損益。

条件を AND または OR で結合するには、Combine items with（ノードレベル）と Combine rules with（項目ごと）を使います。

Execution のアクション

各アクションは、Entry (open)、Exit (close)、または Script です。シンボルは実行の設定から決まるため、ここで入力する必要はありません。

Entry（注文を出す）

フィールド	オプション
Side	Buy / Sell
Size	数量（株数）または名目額（$）
Order type	Market、Limit、Stop、Stop limit、Trailing stop
Time in force	Day、GTC、OPG（寄り付き）、CLS（引け）、IOC、FOK
Limit / stop price	limit / stop / stop-limit タイプでは必須
Trail	トレーリングストップの価格（$）またはパーセント（%）
Order class	Simple、Bracket、OCO、OTO（bracket クラスは利確／損切りのレッグを追加）
Extras	Extended hours、client order id

**Exit（ポジションを決済）：**数量（株数）またはポジションに対する割合。 Script： QuantCraft の Agent Script を実行します。

Notification

ルールは、任意のカスタムメッセージと Include Previous Node Output のトグルとともに、受信者へメールを送信します。ノードレベルの Disable in Backtest トグルは、Agent Test 中のメール送信をスキップします。

エージェントのバックテスト

エディターのヘッダーにある Test をクリックすると、Test agent (backtest) が開きます。

Setup タブ

フィールド	備考
Start / End date	UTC の暦日（デフォルトは約直近 1 か月）。
Initial cash	ペーパーの初期残高（デフォルト 100,000）。
Include calendar data (dividends, splits)	Premium 限定。IDE のバックテストと同様に、分割に合わせてポジションを調整し、配当を計上します。カレンダーデータを参照。

Scheduler タブ

フィールド	備考
Symbol source	Selected Stocks & Crypto、または Screener（保存済みのスクリーンに該当するものを取引し、テストの進行に合わせて再スクリーニング — Screenerを参照）。
Symbol catalog	接続済みブローカーまたは QuantCraft。
Stocks / Crypto	実行するシンボルの複数選択。
Timeframe	バーの粒度。
Bar interval	N バーごとにトリガー（1 = 毎バー）。
Fundamentals per symbol	グラフが Fundamentals ソースを使うときに表示 — Premium 限定。

Scheduler タブは、バックテストに限って Schedule trigger ノードに置き換わります。フォワード実行は引き続きノードに従います。

Optimization タブ — エージェントに公開パラメータがあるときに表示されます。Run as optimization をオンにすると、1 回実行する代わりにそれらを探索（グリッドまたは遺伝的）し、ボタンは Start test ではなく Start optimization になります。

要件とコントロール

アクティブな接続済みトレーディングアカウントが必要です。市場データのプリフェッチに使われるため、これがないと Test は開始できません。
実行中は、Test ボタンが Pause / Resume と Stop に変わります。一時停止は、現在実行中のノードが終了した後に有効になります。
最後に使った Test の設定は記憶されます。

結果 — 成功すると、ヘッダーが Test Results タブに切り替わります。インジケーターのオーバーレイ付き OHLC チャート、取引履歴、資産曲線、アカウント指標に加え、該当する場合はスクリーナーのリバランススケジュールと分割／配当の行が表示されます。複数シンボルの実行は1 つのペーパーアカウントを共有するため、取引と指標は（シンボル別ではなく）合算されます。各ノードの Output タブには、ライブログ（取得したデータ、ストラテジーの合否、AI の回答、注文の約定、メールの意図）がストリーミングされます。Strategy と AI Prompt のノードでは、Received data タブに正確な入力も表示されます。

公開パラメータと最適化

Trigger、Strategy、Execution ノードでは、Parameters タブで、数値の設定（間隔、インジケーターの期間、しきい値、注文サイズなど）を範囲付きで**公開（exposed）**としてマークできます。公開パラメータは、Test ダイアログの Optimization タブが探索する対象であり、AI の最適化エージェントが調整する対象でもあります。グリッド探索と遺伝的探索の仕組みについては、最適化を参照してください。

AI Builder

Trading エージェントのヘッダーにある AI Builder ボタン（きらめきのアイコン）は、キャンバスの横にチャットを開きます。エージェントを普通の言葉で説明すると、接続済みの AI モデルがノードを追加・設定・接続し、ワークスペースに Agent Script を書き込むこともできます。

Ask モードはグラフを変更せずに質問に答え、Build モードは変更を加えます。
変更はライブで適用され、各返信に Keep / Undo があります。
メッセージにファイルを添付できます。
QuantCraft AI と同じモデル接続を使い、そのトークン使用量はエージェントのトークンバッジに加算されます。

AI のテスト／最適化エージェント

Test と Optimization のエージェントにはノードグラフがありません。AI にターゲット（IDE のアルゴまたは Trading agent）、Instructions for the AI、そして制限（Max iterations（1 イテレーション = 1 バックテスト。AI がすべて事前に計画します）、Max AI rounds、Max AI tokens、Max backtest windows）を与えます。Allow market data tools をオンにすると、QuantCraft Tools を使わせることができます（デフォルトはオフ）。指示にはファイルを添付できます。

開始すると、AI は独自の AI 制御のポップアウトウィンドウで作業し、バックテストや最適化を実行し、調査結果をメモリーに保存し、要約で締めくくります。エージェントのページには Overview、Sessions、Windows、Memory タブがあり、各セッションを追い、そのイテレーション計画と実行を確認し、ウィンドウを閉じられます。

バックテストと最適化の結果（AI によるその要約を含む）は、過去データのみを表しており、実運用での結果を保証するものではありません。

保存、管理、モニタリング

Save は Draft バッジを消し、グラフの保存済みコピーを保持します。すべての編集は引き続きローカルに自動保存されますが、保存済みのエージェントを変更すると Draft バッジが Undo ボタンとともに戻り、確認後にグラフを最後の保存状態に戻せます。
サイドバーでエージェントを右クリックすると、Rename、Duplicate、Delete ができます。複製すると、グラフが新しいドラフトとしてクローンされます。
エージェントをファイルとして共有（デスクトップアプリ）：ヘッダーの ⋯ メニューには、エージェントを .qca ファイルとして保存する Export… があり、サイドバーのメニューには、1 つ以上の .qca ファイルを読み込む Import… があります。Agent Script の参照は、インポート時にワークスペースへ再リンクされます。
実行中は、各ノードカードにライブのステータスバッジ（待機中、実行中、ok、失敗、スキップ）が表示され、イベントが Output タブにストリーミングされます。

知っておくと便利なこと

バックテストとフォワードの実行の違い。エージェントの Test（バックテスト）は、シミュレーションされたペーパーアカウントを使います。フォワード実行（チャートの Agents メニュー、AutoTrading の New Agent Bulk Run）は、選択した接続済みブローカーアカウントを使い、そのアカウントがライブの場合は実際の注文を送信することがあります。QuantCloud ランナーが実行するのは IDE のアルゴリズムのみで、エージェントは実行しません。
**スケジュールは、実行を開始して初めて適用されます。**エディターは、バックグラウンドでエージェントを自動開始しません。フォワード／バルク／チャートの実行を開始すると、実行間隔は Schedule trigger から（バックテストでは Test ダイアログの Scheduler による上書きから）決まります。
**構造上の制限：**ノードごとに親は最大 2 つ、循環なし、Execution ノードは Strategy または AI Prompt ノードにのみ接続でき、Execution ノードの子は Notification ノードのみ。
バックテストのファンダメンタルデータは Premium 限定です（有効な場合、他のファンダメンタルデータ UI と同じ無料データアクセスが適用されます）。