QuantCraft AI

QuantCraft には、IDE の右サイドバー（ワークスペースのレイアウト）に組み込みの AI アシスタントが含まれています。ワークスペースを把握したうえで、トレーディングストラテジーの Python の作成と編集を手伝ってくれるチャットパネルです。エディターで開いているファイル、@ でメンションしたファイル、その他の開いているファイルのアウトラインを参照できるため、回答や編集は文脈に沿ったものになります。IDE 内のコーディングエージェントのように動作し、1 回のチャットで新しいファイルの作成や既存ファイルの編集ができます。

使うには、右サイドバーを開いて QuantCraft AI タブに切り替えます。接続するモデルはアプリ全体で共通です。同じ接続が、このチャット、エージェントの AI Prompt ノードと AI Builder、そして AI の Test / Optimization エージェントを動かします。提案されたストラテジーの変更は、Python エディターとコードの実行で Test / Run により検証してください。

同じサイドバーには Documentation パネルもあり、ストラテジー API（ライフサイクル、OHLCV、インジケーター、ファンダメンタルデータ、ファクター、入力、アカウント）の静的リファレンスと、Agent Scripts および Screener Script のページがあります。リファレンスを参照してください。

---

アシスタントのモード

モードと Auto-continue は、入力欄、または API Providers ダイアログの Assistant mode で切り替えられます。

---

モデルの接続

QuantCraft AI は複数のプロバイダーで動作します。自分のキーを持ち込む方式（プロバイダーの自分のアカウントに課金）もあれば、QuantCraft Premium とホスト型のオプションのようにマネージドアクセスで動くものもあります。上部メニューの AI → API Providers を開き（ダイアログのタイトルは AI API Providers。チャットの接続リンクからも開けます）、プロバイダーを選び、そのフィールドを入力します。

GitHub Copilot と Cursor がリストに表示されることがありますが、チャットのやり取りはまだ接続されていません（UI のスタブ）。エージェントの AI 機能でも拒否されます。Anthropic、DeepSeek（自分のキーまたはホスト型）、OpenCode、QuantCraft Premium、Custom LLM を使ってください。

キーを貼り付け（必要な場合）、モデルを選んで、Save をクリックします。

Custom LLM

Custom LLM を使うと、OpenAI 互換の自前またはセルフホストのモデルに接続できます。

URL が設定されると、接続は準備完了とみなされます。デスクトップアプリでは、プロバイダーへの HTTP は Tauri の HTTP プラグインを通り、localhost / 127.0.0.1 のエンドポイントが対象です。任意のリモートの Custom LLM ホストは、許可リスト UI でユーザーが設定することはできません。ローカルの OpenAI 互換サーバー、または上記でサポート済みのプロバイダーを使うことをおすすめします。

**キーの保管場所：**自分のキーを持ち込む方式の値は、お使いのマシン上にのみ保存されます（デスクトップアプリでは OS のキーチェーン、またはこのブラウザーのローカルストレージ）。QuantCraft にアップロードされることはなく、選択したプロバイダーにのみ送信されます。ブラウザーのデータを消去したり別のコンピューターに移ったりした場合は、キーを再入力する必要があります。

**リクエストの送信先：**自分のキーを持ち込むプロバイダーでは、QuantCraft AI がお使いのマシンからあなたのキーを使ってプロバイダーを直接呼び出します。デスクトップ（Tauri）アプリは HTTP ブリッジを使うため、ブラウザーの CORS でリクエストがブロックされることはありません。ブラウザー版で QuantCraft AI を実行すると、CORS 関連の「Request failed」メッセージが表示されることがあります。最適な体験にはデスクトップ版をご利用ください。

モデルの選択

各プロバイダーには、キー欄の隣にモデルのドロップダウンがあります。チャット下部の接続バッジには、アクティブなプロバイダーと短いモデル名が表示されます（例：Anthropic (Claude) · Claude Sonnet 4.6）。複数のプロバイダーを保存でき、キーが複数あるときは、バッジには最後に使ったものが +N の接尾辞付きで表示されます。

Anthropic の場合、ドロップダウンには Claude Sonnet 4.6、Claude Opus 4.8、Claude Opus 4.7、Claude Haiku 4.5、その他の現行の Opus / Sonnet バリアントが表示されます。アカウントでアクセスできるものを選んでください。Anthropic の経路で保存済みのキーなしにメッセージを送ろうとすると、アシスタントはキーの追加を促す返信をします。

---

チャットの使い方

• 入力欄に入力して Enter で送信、Shift+Enter で改行します。
• @ を入力するとファイルメンションのメニューが開き、別のワークスペースファイルをコンテキストに加えられます。
• 返信は、コードブロック付きの markdown として表示されます。
• Stop は、生成中の返信を中断します。

入力欄と添付ファイル

• Attach files ボタンはファイルピッカーを開きます。入力エリアへドラッグ＆ドロップしたり、クリップボードからファイルや画像を貼り付けたりすることもできます。
• テキストボックスの上にある添付ファイルのチップの行に、キューに入っているすべてのファイルが表示されます。各チップには名前（画像の場合はサムネイル）と、削除用の × があります。
• どの種類のファイルも受け付けます。画像ファイルは、送信後にメッセージストリーム内へ小さなインラインサムネイルとして表示されます。
• 添付ファイルは、一緒に送信したメッセージに属し、チャット履歴ではそのメッセージの横に表示されます。
• IDE のチャットでは、添付ファイルは表示されますが、その内容はモデルに送信されません。ワークスペースのファイルの内容を共有するには、代わりに @ でメンションしてください。

アシスタントが返信を生成している間は、入力欄が「Please wait…」というプレースホルダー付きで無効になり、メッセージリストに小さなステータス行が表示されます（例：Building API messages…、Streaming reply… 1,234 characters、Syncing to workspace folder on disk…）。

---

チャットセッション

QuantCraft AI はチャットセッションの履歴を保持します。各セッションは、それぞれのメッセージと添付ファイルを持つ独立した会話です。チャットパネル上部のバーには次があります。

• New chat — 新しい空のセッションを開始します。アシスタントの作業中、ファイル編集が保留中のとき、または現在のチャットがすでに空のときは無効です。
• Chats — 保存済みのすべてのセッションを新しい順に表示するドロップダウン。各項目にはタイトル（最初のユーザーメッセージから自動生成）と最終更新時刻が表示されます。行をクリックして切り替え、ゴミ箱アイコンで削除します。

セッションは自動的に保存され（デスクトップアプリではローカル設定、それ以外はブラウザーのローカルストレージ）、リロードや再起動後も残ります。返信のストリーミング中や、未処理の Accept/Undo バーがある間は、チャットの切り替えと新規作成がブロックされます。先に変更を完了するか元に戻してください。

---

アシスタントが参照できるもの

メッセージを送信するたびに、QuantCraft AI は次の内容からリクエストを組み立てます。

1. 同梱の QuantCraft 開発者向けドキュメント（ライフサイクル、アカウント API、OHLCV／ファンダメンタルデータのモジュール、インジケーター系列などを把握できるようにするため）。
2. 最新のワークスペーススナップショット — リンクされたワークスペースフォルダーのパス、エディターで現在開いているファイル、開いているタブとフォルダーの一覧。
3. アクティブなチャットセッションの過去のやり取り（あなたのメッセージとアシスタントの返信）。
4. 新しいメッセージと添付ファイル。

このため、Files サイドバーでワークスペースフォルダーを選ぶことが重要です。選ばなくても質問には答えられますが、ディスクにファイルを書き込めず、その旨が伝えられます。

---

アシスタントによるファイル編集

Agent モードでは、アシスタントは 1 回の返信で 1 つ以上のファイル操作を返せます。新しいファイルの作成、エディターで現在開いているファイルの編集、ワークスペース内の名前を指定したファイルの編集です。その場合：

• 新しいファイルは、リンクされたフォルダー内に新しいタブとして表示され、既存のファイルはそれぞれのタブでその場で更新されます。
• エディターは変更箇所へジャンプし、変更された行をハイライトするので、アシスタントが行ったことを確認できます。
• チャットの下部に、短い要約と 2 つのボタンを備えた保留バーが表示されます。
  • Accept — 変更を保持します。ハイライトが消え、チャットを続けられます。
  • Undo — 変更を元に戻します。編集の場合は以前のファイル内容が復元され、新規ファイルの場合は新しいタブが削除されます。
• Accept または Undo を選ぶまで、チャットは固定されます。セッションの切り替えも別のメッセージの送信もできません。これは意図的な仕様で、すべての変更を必ず自分で確認できるようにするためです。
• 複数ファイルの返信では、バーに適用された変更の数が表示されます。Undo は最後の手順だけを元に戻すため、必要に応じてタブごとにハイライトを確認してください。

複数ファイルのストラテジー

Agent モードでは、アシスタントはストラテジーをフォルダー内のヘルパーモジュール（indicators/、risk/ など）に分割し、ルートのアルゴファイルにインポートできます。ライフサイクル関数（on_init、on_bar など）はルートのファイルに置き、__init__.py ファイルなしで、from indicators.momentum import calc_rsi のようにワークスペースのルートからの絶対インポートを使います。

• アクティブなファイルがインポートしているファイルと、それをインポートしているファイルは全文が見えます。それ以外のファイルはアウトラインしか見えません。そうしたファイルを編集させたい場合は、@ でメンションしてください。
• 各返信のファイル変更は、適用前にすべて検証されます。安全に実行できない手順がある場合（たとえば既存のファイルを作成しようとする、アウトラインしか見ていないファイルを書き換えようとするなど）、手順は1 つも適用されず、返信で理由が説明されます。
• 変更が適用された後、実行時に失敗するワークスペースのインポート（たとえば、インポート元のファイルを更新せずにヘルパーの名前を変更した場合）は、返信の下に一覧表示されます。エージェントは次のターンでそれを修正します。

ディスクへの同期

ファイルは、ディスク上のリンクされたワークスペースフォルダーにも同期されます（デスクトップアプリ）。ブラウザー版では、ファイルはエディターとタブでは引き続き更新されますが、ディスクには反映されません。返信でその旨が通知されるので、ファイルを完全に連携させるにはデスクトップ版を使ってください。

---

組み込みの QuantCraft Tools

OHLCV、インジケーター、ファンダメンタルデータ、スクリーナー、アカウント、ポジションの、ファーストパーティの読み取り専用マーケットツール群がデフォルトでオンになっており、チャット（およびエージェントの AI Prompt ノード）から直接呼び出せます。AI → MCPs（上部の QuantCraft Tools (built-in) 行）で管理します。QuantCraft Toolsを参照してください。

---

スクリーナーツール

AI Screener 機能が有効な場合、チャットはスクリーナーを操作することもできます。スクリーナーウィンドウを開き、スクリーンを作成または読み込み、実行して結果を読み取ります。AI が作業している間、ウィンドウには 「The AI is using this window」 と表示され、操作は無効になります。Chat モードと Plan モードでは、AI は読み取り専用のサブセットしか使えず（スクリーンと結果は見られますが変更はできません）、Agent モードではすべてのツールが使えます。Screenerを参照してください。

---

ツール

ツールは、チャットモデルが回答の際に呼び出せる外部のデータサービスです。AI → AI Tools から追加します。

• 利用できるツールは LLMQuant Data です。Enable for chat チェックボックスで有効にし、API key を貼り付けます（「Get a key」リンクがあります）。
• 有効にすると、アシスタントは会話の途中で、wiki と研究論文、株式と暗号資産の価格、ETF の検索と保有銘柄、マクロ指標、SEC 提出書類と 13F 保有、予測市場データなどのカテゴリからライブデータを取得できます。

ツールは動作するチャットプロバイダー（Anthropic、DeepSeek、OpenCode、Premium、Custom LLM）にのみ付与されます。Copilot / Cursor はチャットには実装されていないため、それらを選択している場合はツールが実行されることはありません。

---

MCP サーバー

MCP（Model Context Protocol） サーバーは、独自のツールをアシスタントに公開します。AI → MCPs から追加・管理します。リストは組み込みの QuantCraft Tools (built-in) 行で始まり、保存された各サーバーには Enabled for chat のトグルと Edit / Remove があり、有効なサーバーのツールはチャットで利用できるようになります。

追加するには Add server をクリックし、Transport を選びます。

サーバーに Name を付け、Test connection で確認し（サーバーが公開しているツールの数が報告されます）、Apply でリストに追加し、Save で保存します。

---

エージェントの AI Prompt ノード

エージェントの中に、Strategy ノードの AI 版である AI Prompt ノードを追加できます。

• はい／いいえで答えられる質問を 1 つの自由記述のプロンプトとして書きます。たとえば 「最近の価格動向とファンダメンタルデータを踏まえて、これは強気のセットアップか？」 のように。構造化されたルールはありません。
• Data sent to the AI セクションには、モデルが受け取る上流データ（OHLCV ウィンドウ、ファンダメンタルデータなど）がチップで表示されます。Data の親をリンクしないと、AI に入力がないという警告がノードに表示されます。
• AI の答えは true / false に強制され、その結果が、Strategy の結果とまったく同様に、上流ゲートを通じて子ノードを制御します。
• モデルは、実行に限定された読み取り専用の QuantCraft Tools（OHLCV、インジケーター、ファンダメンタルデータ、スクリーナー、アカウント、ポジション）も呼び出せます。

どのモデルが実行するかは、アクティブな接続によって決まります。

• QuantCraft Premium — 呼び出しは、割り当てられたアクセスを使ってバックエンドで実行されます。ここで動作するのは Claude の付与のみで、DeepSeek の付与では「not supported for AI Prompt nodes yet」として実行が停止します。
• 自分のキーを持ち込む（Anthropic、OpenCode、Custom LLM）— 呼び出しは、あなた自身のキーを使ってアプリから実行され、そのキーがバックエンドに送られることはありません。

DeepSeek（自分のキーでもホスト型でも）は、AI Prompt ノードではまだ動作しません。

Agent Test の AI Prompt ノードと AI Builder のトークン使用量は、エージェントごとに集計され、エディターのヘッダーにバッジとして表示されます。Tokens · This month: … · Lifetime: …（月間の数値は暦月ごとにリセットされます）。

---

ヒント

• **最初にワークスペースフォルダーをリンクしてください。**Files サイドバーでプロジェクトフォルダーを選びます。ない場合、アシスタントは質問には答えられますが、ディスク上のファイルを作成・編集できません。
• **ファイルパスを明示してください。**編集を依頼するときは、タブのタイトルか utils/foo.py のようなパスを伝えてください。アシスタントはどちらも照合します。
• **Undo は気軽に使ってください。**各ステップを細かく管理するより、複数ファイルの変更をアシスタントに試させて元に戻すほうが安全です。元に戻すと、エディターのバッファが即座に復元されます。
• **作業に応じてモデルを切り替えてください。**日常的な編集には高速な Claude モデルを、大規模なリファクタリングやストラテジー設計にはより強力なモデル（Opus）を使います。
• **キーを安全に保管してください。**自分のキーを持ち込む方式の値は、このマシンにのみ保存されます。パスワードのように扱い、AI API Providers ダイアログ以外の場所には貼り付けないでください。