liurenchaxin/MEMORY_BANK_USER_GUIDE.md

76 lines
2.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 炼妖壶 (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投资分析")
```