liurenchaxin/MEMORY_BANK_USER_GUIDE.md

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

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

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

配置说明

选择记忆后端

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

# 使用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因素

使用方法

在代码中使用记忆银行：

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投资分析")