RD-Agent / First Run

RD-Agent 首次运行:健康检查、运行场景与 UI 监控

装好环境后,先跑健康检查确认 Docker 与端口就绪,再用场景命令(fin_quant / fin_factor / data_science 等)启动自动化研发,最后用 Streamlit UI 或 Web UI 查看运行日志与结果。

health_check场景命令Streamlit/Web UI
配置 LLM.env 配置
健康检查health_check
运行场景fin_quant 等
UI 监控查看日志
RD-Agent 首次运行流程示意(基于官方 README);示意非官方图。
Run

运行步骤

首次运行四步走。

  1. 配置 LLM

    .env 里配置 CHAT_MODEL 与 EMBEDDING_MODEL(见安装页)。

  2. 健康检查

    rdagent health_check 验证 Docker 与配置是否就绪。

  3. 运行场景

    按需求选场景命令,如量化 rdagent fin_quant、数据科学 rdagent data_science --competition <name>

  4. 查看结果

    用 Streamlit UI 或 Web UI 查看运行日志与 trace。

Commands

常用场景命令

官方 Live Demo 由以下命令实现,每个代表一个 demo。

命令场景
rdagent fin_quant量化交易 + 因子-模型联合演化(Qlib)
rdagent fin_factor量化交易 + 因子迭代演化
rdagent fin_model量化交易 + 模型迭代演化
rdagent fin_factor_report --report-folder=<path>从财报提取并实现因子
rdagent general_model <paper URL>自动读论文并实现模型
rdagent data_science --competition <name>数据科学 / Kaggle 竞赛
rdagent llm_finetune --base-model <model>LLM 微调(FT-Agent)
Monitor

监控运行结果

两种 UI 查看运行日志。

Streamlit UI

rdagent ui --port 19899 --log-dir <log> --data-science,查看运行日志,尤其适合 data_science 场景。

Web UI

rdagent server_ui --port 19899,Flask 后端 + 前端,实时交互与 trace 查看(暂不支持 data_science 场景)。

Caution

首次运行的注意事项

跑通不等于能赚钱,几个关键点要认清。

研究用途:RD-Agent 面向研发与因子挖掘,回测结果仅代表历史表现,不构成投资建议。
不要直接实盘:官方明确「provided as is」,不替代合格金融专业人士;任何策略都应先回测、模拟盘验证。
FAQ

常见问题

health_check 检查什么?

主要检查两件事:Docker 是否安装成功、rdagent ui 默认端口是否被占用。可用 --no-check-env 跳过环境检查。

跑一次量化场景要多久?

取决于 LLM 调用、数据量与迭代轮数;LLM API 成本与耗时是主要开销,官方量化实验称成本可低于 10 美元。

运行日志存在哪?

默认在 log 目录;Streamlit UI 通过 --log-dir 指定日志目录查看。

结果好就代表策略有效吗?

不代表。回测存在过拟合风险,需样本外验证、考虑交易成本,且官方不构成投资建议。

跑通后,深入量化场景

首次运行跑通了,下一步理解 RD-Agent(Q) 的因子-模型联合优化。想快速验证 A 股/行情想法,可看 EasyClaw 量化 Skill 路线。