TPM/LLM_SETUP.md

# LLM 投資建議功能設置指南

## 功能介紹

LLM 投資建議功能使用 OpenAI GPT 模型為投資組合提供專業的投資分析和建議，包括：
- 策略績效評估
- 風險分析
- 市場適配性評估
- 具體的改進建議

## 設置步驟

### 1. 獲取 OpenAI API 金鑰

1. 前往 [OpenAI API](https://platform.openai.com/api-keys) 頁面
2. 點擊 "Create new secret key"
3. 複製生成的 API 金鑰

### 2. 配置 API 金鑰

您可以通過以下兩種方式之一設置 API 金鑰：

#### 方法一：環境變數（推薦）
```bash
export OPENAI_API_KEY="your-api-key-here"
```

#### 方法二：修改配置檔案
編輯 `config_openai.py` 檔案：
```python
OPENAI_CONFIG = {
    'api_key': 'your-actual-api-key-here',
    # ... 其他配置
}
```

### 3. 安裝依賴

```bash
pip install -r requirements.txt
```

### 4. 啟動服務

```bash
docker compose up -d flask
```

### 5. 測試功能

1. 訪問任意策略詳情頁面
2. 查看「🤖 LLM 投資建議」區塊
3. 系統會自動生成 AI 投資建議

## 配置選項

### OpenAI 模型選擇

在 `config_openai.py` 中可以調整：

```python
OPENAI_CONFIG = {
    'model': 'gpt-4',  # 選擇 gpt-3.5-turbo 可降低成本
    'max_tokens': 2000,  # 最大回應長度
    'temperature': 0.7,  # 創意程度 (0-1)
}
```

### 快取設定

```python
CACHE_CONFIG = {
    'enabled': True,  # 啟用快取
    'ttl': 3600,      # 快取時間（秒）
    'max_size': 100,  # 最大快取項目數
}
```

## 費用估算

- **GPT-4**: 約 $0.03/1K tokens
- **GPT-3.5-turbo**: 約 $0.002/1K tokens

每個投資建議約使用 1000-2000 tokens，建議選擇合適的模型以控制成本。

## 故障排除

### 常見問題

1. **API 金鑰錯誤**
   - 檢查 API 金鑰是否正確設置
   - 確認金鑰沒有額外的空格

2. **連接到服務失敗**
   - 檢查 Flask 服務是否正常運行
   - 確認防火牆設定允許內部通訊

3. **生成建議失敗**
   - 查看後端日誌確認錯誤原因
   - 檢查 OpenAI API 額度是否充足

### 檢查日誌

```bash
docker compose logs flask
```

## 進階配置

如需自訂 Prompt 模板，請編輯 `prompts/investment_advice.py` 檔案中的模板函數。

## 安全性注意事項

- 請勿將 API 金鑰提交到版本控制系統
- 考慮使用環境變數而非硬編碼
- 定期輪換 API 金鑰