3、AI 对冲基金上手实践：从配置到跑通

AI 对冲基金上手实践：从配置到跑通

难度：动手

本章把前面「Agent 体系」「系统如何工作」里的概念，变成一次你能在本机完成的练习。你将准备运行环境与密钥，用命令行或 Web 界面跑通分析流程，并学会阅读信号与最终决策。全程请牢记：本项目的任何输出仅供教育学习，不构成投资建议，也不应被用于真实交易或自动下单。

本文你将学到

• 上手四篇分别解决什么卡点，以及为什么要按顺序阅读
• 建议的最短动手路径（大约三十到六十分钟）
• 动手前必须再次记住的教育边界与安全习惯
• 命令行与 Web 两条路线在底层如何共用同一套研究引擎

上手实践在整套教程中的位置

若把整套中文教程想象成一座四层建筑：第一层讲「项目是什么、边界在哪」；第二层讲「各类 Agent 各自扮演什么角色」；第三层就是你现在所在的「动手层」——不再只读概念，而是亲手输入股票代码、等待分析、对照屏幕理解结果；第四层则延伸到回测、常见疑问与下一步学习。

动手层的核心原则只有一句：先跑通，再跑全；先读懂，再扩展。 很多初学者第一次就启用全部名人分析师、全部专题模块，结果等待时间很长、账单变高、屏幕信息爆炸，反而看不清「分析师 → 风控 → 组合管理」这条主链路。本章刻意把练习拆成四步，就是为了让主链路在你脑中留下清晰印记。

本章导读图

本章目录

1. 《环境准备与 API 密钥》—— 大模型与金融数据为什么都要配齐
2. 《用命令行跑通一次 AI 对冲基金》—— 输入股票，拿到结构化结果
3. 《如何读懂输出结果》—— 信号、限额、最终建议三层阅读法
4. 《Web 界面快速体验》—— 用画布可视化多智能体协作

底层执行逻辑（与源码的关系）

无论你走命令行还是 Web，核心业务循环都围绕 run_hedge_fund 展开。该函数在 src/main.py 中定义，大致执行顺序如下：

工作流由 create_workflow 组装：入口是 start_node；你选中的分析师从 get_analyst_nodes() 注册为图节点；风险管理与组合管理始终存在，不需要你手动「开启」。这与教育场景的设计一致——再强的看多信号，也要经过限额约束，再由组合管理折中成可解释的最终动作。

命令行侧，入口在 src/main.py 的 if __name__ == "__main__" 块：它调用 parse_cli_inputs（位于 src/cli/input.py）解析参数与交互选项，构造初始 portfolio 字典（含现金、保证金比例、各 ticker 的多空仓位占位），再调用 run_hedge_fund，最后用 print_trading_output 格式化打印。Web 应用的后端本质上也是调用同一套逻辑，只是参数来自界面表单而非终端。

最短动手路径（约 30–60 分钟）

1. 配密钥：至少一个大模型提供商的环境变量（如 OPENAI_API_KEY），以及 FINANCIAL_DATASETS_API_KEY。字段名以项目根目录 .env.example 为准。
2. 装依赖：推荐使用 Poetry 管理 Python 环境；Web 路线另需 Node 相关依赖，详见应用目录说明。
3. 小步试跑：选两到三只你熟悉的大公司股票代码（例如 AAPL、MSFT），第一次只启用少数分析师。
4. 对照阅读：运行结束后，打开《如何读懂输出结果》，按「信号 → 限额 → 最终决策」顺序看终端表格。
5. 可选可视化：若命令行已成功，再打开 Web 画布，把同一逻辑「画」出来，加深记忆。

两条路线怎么选

两条路线都不会连接真实券商，也不会替你下单。这是项目 README 与应用说明里反复强调的教育定位，动手时务必内化。

动手前的安全与合规习惯

• 密钥文件（通常是项目根目录的 .env）不要上传到公开仓库、聊天群或网盘。
• 截图分享结果时，检查是否意外露出完整密钥。
• 若密钥泄露，立即在对应平台作废并重新生成。
• 终端里出现 buy、short 等字样，只表示模拟研究结论，不是对你真实账户的操作指令。

常见问题预告

• 「我 Agent 都配好了，为什么还报错？」 多半是密钥未加载或金融数据拉取失败，第一篇会细讲。
• 「为什么两次运行不完全一样？」 大语言模型可能带随机性；学习时应关注分歧结构，而非逐字复现。
• 「回测和单次分析有什么区别？」 延伸章专讲；上手章先完成一次单次分析即可。

免责声明（动手前再读一遍）

本练习产生的任何买入、卖出、做空、平仓等字样，均不构成投资建议，也不应被用于真实交易。本项目创建者不对任何财务损失负责。过去表现（包括回测曲线）不代表未来结果。使用本软件即表示你同意仅将其用于学习与研究目的。

请从同目录下的《环境准备与 API 密钥》开始阅读。