適合: 用 Agent / API 串 Traseq 的開發者
用 Agent 或 API client 操作 Traseq
無程式編輯器產出的 SignalGraph v2 寫入合約,跟 API 接收的合約是同一個。Agent 跟 UI 不會走鐘。
關鍵概念
- API key
- 在工作區設定裡產生。每個方案都會限制單一工作區同時可持有的 key 數量。
- Capabilities 能力探索
- 先讀 /capabilities。它會告訴你的 agent 這個工作區現在支援哪些 fields、operators、instruments——避免硬編碼。
- SignalGraph 驗證
- 每次寫入策略都會跑 schema + 語意驗證。不合法的 graph 會被擋下,並回傳結構化 diff,讓 agent 自我修復。
- Create / finalize
- 寫入是兩步:先 create 一個草稿,再 finalize 鎖成有版本的快照。回測只跑已 finalize 的版本。
- Queue backtest
- 回測在 engine 上非同步跑。送出後拿 run id,之後 poll 或訂閱結果事件。
在 Traseq 裡實際長這樣
在工作區設定裡產生 API key。
呼叫 /capabilities 確認環境跟你的 agent 假設的一致。
組一份 SignalGraph v2 策略,驗證、然後 finalize 一個版本。
對 finalize 後的版本送出回測,讀回 run。
你的下一步