AI 模型配置
AI 是 TradingCopilot 的核心依赖，负责消息过滤、投研会议、多角色分析、复盘和部分结构化输出。建议先用一个稳定、低变量的模型配置跑通，再扩展到更多模型和角色。
配置流程
前置条件
- AI 提供商支持 OpenAI 兼容 API。
- 已获得 API key。
- 部署环境能访问提供商地址，或已配置代理。
- 已完成管理员初始化。
添加提供商
在模型提供商页面或设置页填写：
| 字段 | 说明 | 示例 |
|---|---|---|
| 名称 | 用于界面识别 | openai-compatible |
| Base URL | OpenAI 兼容接口地址 | https://api.example.com/v1 |
| API key | 提供商密钥 | sk-... |
| 模型 | 用于会议或过滤 | gpt-... |
| 代理 | 可选 | 仅在网络需要时启用 |
保存后先做连接测试或模型同步。模型同步失败不一定代表 chat 接口不可用，有些兼容提供商不实现模型列表接口；此时可以手动填写模型名，并通过测试会议验证。
模型选择建议
| 场景 | 建议 |
|---|---|
| 消息过滤 | 成本低、延迟低、结构化输出稳定 |
| 投研会议 | 推理能力强、上下文足够、工具调用稳定 |
| 复盘总结 | 输出稳定、长文本总结能力好 |
| 测试环境 | 使用便宜模型，降低试错成本 |
不要在生产工作流中频繁切换模型。切换前先用固定消息和固定会议主题验证输出质量。
角色能力
研究团队拥有自己的会议角色。默认角色适合快速试用，但真实使用中应按团队目标调整：
- 宏观观察团队：偏事件解读和风险提示。
- 个股研究团队：偏公司、行业和财务信息。
- 模拟交易团队：偏交易假设、风险和执行约束。
“应用默认角色”会重置目标团队当前角色。执行前应确认没有需要保留的自定义角色。
验证方式
- 保存提供商。
- 同步模型或手动填写模型。
- 创建一个简短测试会议。
- 查看会议事件是否出现角色发言。
- 查看日志中是否有认证失败、超时、限流或响应解析错误。
排障
| 症状 | 检查 |
|---|---|
| 401/403 | API key、账户权限、模型权限 |
| 404 | Base URL 或模型名 |
| 超时 | 网络出口、代理、提供商状态 |
| JSON 输出失败 | 模型能力、提示词、上下文长度 |
| 频繁限流 | 账号配额、并发、消息源噪声 |