# 炼妖壶 (Lianyaohu) - 稷下学宫AI辩论系统

## 八仙记忆银行配置与使用指南

每个八仙智能体都有一个专属的记忆银行，用于存储其在不同辩论主题下的记忆。系统支持两种记忆后端：Google Vertex AI Memory Bank 和 Cloudflare AutoRAG。

## 配置说明

### 选择记忆后端

通过设置环境变量 `JIXIA_MEMORY_BACKEND` 来选择记忆后端：

```bash
# 使用Google Vertex AI (默认)
export JIXIA_MEMORY_BACKEND=vertex

# 使用Cloudflare AutoRAG
export JIXIA_MEMORY_BACKEND=cloudflare
```

### Google Vertex AI 配置

需要配置以下环境变量：

- `GOOGLE_API_KEY`: Google API 密钥
- `GOOGLE_CLOUD_PROJECT_ID`: Google Cloud 项目ID
- `GOOGLE_CLOUD_LOCATION`: 部署区域 (可选，默认 us-central1)

### Cloudflare AutoRAG 配置

需要配置以下环境变量：

- `CLOUDFLARE_ACCOUNT_ID`: Cloudflare 账户ID
- `CLOUDFLARE_API_TOKEN`: 具有 Vectorize 和 Workers AI 权限的 API 令牌

## 八仙记忆银行详情

系统为以下八位仙人创建了专属记忆银行：

1. **铁拐李 (tieguaili)** - 擅长技术分析和风险控制
2. **汉钟离 (hanzhongli)** - 注重基本面分析和长期价值
3. **张果老 (zhangguolao)** - 擅长宏观趋势分析和周期判断
4. **蓝采和 (lancaihe)** - 关注市场情绪和资金流向
5. **何仙姑 (hexiangu)** - 精于财务数据分析和估值模型
6. **吕洞宾 (lvdongbin)** - 善于多维度综合分析和创新策略
7. **韩湘子 (hanxiangzi)** - 擅长行业比较和相对价值分析
8. **曹国舅 (caoguojiu)** - 注重合规性、社会责任和ESG因素

## 使用方法

在代码中使用记忆银行：

```python
from src.jixia.memory.factory import get_memory_backend

# 获取记忆后端 (自动根据环境变量选择)
memory_bank = get_memory_backend()

# 为吕洞宾添加偏好记忆
await memory_bank.add_memory(
    agent_name="lvdongbin",
    content="倾向于使用DCF模型评估科技股的内在价值",
    memory_type="preference",
    debate_topic="TSLA投资分析"
)

# 搜索吕洞宾关于TSLA的记忆
memories = await memory_bank.search_memories(
    agent_name="lvdongbin",
    query="TSLA",
    memory_type="preference"
)

# 获取上下文
context = await memory_bank.get_agent_context("lvdongbin", "TSLA投资分析")
```