おすすめ対象: Agent / API で Traseq を扱う開発者
Agent や API クライアントから Traseq を動かす
ノーコードエディターが生成するのと同じ作成契約 — SignalGraph v2 — を API も期待します。Agent と UI がずれることはありません。
主な概念
- API key
- ワークスペース設定で生成します。各プランは、1つのワークスペースが同時に保持できる key の数に上限を設けます。
- Capabilities (能力探索)
- まず /capabilities を読みます。ワークスペースが今どの fields、operators、instruments をサポートしているかを agent に伝え、ハードコーディングを避けられます。
- SignalGraph 検証
- すべての戦略の書き込みはスキーマと意味の両面で検証されます。不正な graph は構造化された diff とともに拒否され、agent が自己修復できます。
- Create / finalize
- 作成は2段階です。まず下書きを create し、次に finalize してバージョン付きスナップショットを固定します。バックテストは確定済みのバージョンに対してのみ実行されます。
- Queue backtest
- バックテストはエンジン上で非同期に実行されます。送信して run id を受け取り、その後 run をポーリングするか結果イベントをストリーミングします。
Traseq での実際の流れ
ワークスペース設定で API key を生成します。
/capabilities を呼び出し、環境が agent の想定と一致するか確認します。
SignalGraph v2 戦略を組み立て、検証してからバージョンを finalize します。
その確定済みバージョンに対してバックテストをキューに入れ、run を読み出します。
次の一歩