liurenchaxin/docs/guides/MEMORY_BANK_ACCESS_GUIDE.md

160 lines
4.7 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.

# Vertex AI Memory Bank 访问指南
## 📋 项目概览
- **项目ID**: `inner-radius-469712-e9`
- **项目名称**: My First Project
- **项目编号**: 849796462624
- **区域**: `us-central1`
- **创建时间**: 2025-08-21T12:27:33.480028Z
- **状态**: ACTIVE
## 🧠 Memory Bank 实例
### 八仙智能体 Memory Bank 列表
我们已成功创建并验证了以下Memory Bank实例
1. **铁拐李** (`tieguaili`)
- Memory Bank ID: `memory_bank_tieguaili_inner-radius-469712-e9`
- 状态: ✅ 活跃
2. **汉钟离** (`zhongliquan`)
- Memory Bank ID: `memory_bank_zhongliquan_inner-radius-469712-e9`
- 状态: ✅ 活跃
3. **吕洞宾** (`lvdongbin`)
- Memory Bank ID: `memory_bank_lvdongbin_inner-radius-469712-e9`
- 状态: ✅ 活跃
- 测试数据: 包含对话、偏好、知识、策略等4种类型记忆
4. **何仙姑** (`hehe_erxian`)
- Memory Bank ID: `memory_bank_hehe_erxian_inner-radius-469712-e9`
- 状态: ✅ 活跃
5. **蓝采和** (`lantsaihe`)
- Memory Bank ID: `memory_bank_lantsaihe_inner-radius-469712-e9`
- 状态: ✅ 活跃
6. **韩湘子** (`hanxiangzi`)
- Memory Bank ID: `memory_bank_hanxiangzi_inner-radius-469712-e9`
- 状态: ✅ 活跃
7. **曹国舅** (`caoguo_jiu`)
- Memory Bank ID: `memory_bank_caoguo_jiu_inner-radius-469712-e9`
- 状态: ✅ 活跃
8. **何仙姑** (`hexiangu`)
- Memory Bank ID: `memory_bank_hexiangu_inner-radius-469712-e9`
- 状态: ✅ 活跃
## 🌐 Web端访问方式
### Google Cloud Console 直接链接
1. **Memory Bank 专用页面**:
```
https://console.cloud.google.com/vertex-ai/generative/memory-banks?project=inner-radius-469712-e9
```
2. **Vertex AI 主页**:
```
https://console.cloud.google.com/vertex-ai?project=inner-radius-469712-e9
```
3. **生成式AI 控制台**:
```
https://console.cloud.google.com/vertex-ai/generative?project=inner-radius-469712-e9
```
### 导航路径
在Google Cloud Console中
1. 选择项目: `inner-radius-469712-e9`
2. 导航到: **Vertex AI****生成式AI****Memory Banks**
3. 或搜索: "Memory Bank" 或 "记忆银行"
## 🔧 命令行访问
### 已配置的工具
-`gcloud` CLI 已安装并认证
- ✅ Application Default Credentials 已设置
- ✅ Vertex AI API (`aiplatform.googleapis.com`) 已启用
- ✅ Python SDK 可正常使用
### 测试脚本
1. **基础列表查看**: `list_memory_banks.py`
2. **详细功能测试**: `detailed_memory_bank_info.py`
3. **GCP API查询**: `view_memory_banks_gcp.py`
### 运行命令
```bash
# 激活虚拟环境
source venv/bin/activate
# 查看Memory Bank列表
python list_memory_banks.py
# 详细测试功能
python detailed_memory_bank_info.py
# GCP API查询
python view_memory_banks_gcp.py
```
## 📊 Memory Bank 功能验证
### ✅ 已验证功能
1. **创建Memory Bank**: 为每个智能体创建独立的记忆银行
2. **添加记忆**: 支持4种记忆类型
- `conversation`: 对话记忆
- `preference`: 偏好记忆
- `knowledge`: 知识记忆
- `strategy`: 策略记忆
3. **搜索记忆**: 基于关键词和类型搜索
4. **获取上下文**: 为特定辩论主题生成上下文
5. **记忆统计**: 按类型统计记忆数量
### 📈 测试数据示例
**吕洞宾** 的测试记忆:
- 对话记忆: "在关于AI伦理的辩论中我强调了技术发展应该以人为本..."
- 偏好记忆: "我偏好使用古典哲学的智慧来论证现代问题,特别是道家思想。"
- 知识记忆: "区块链技术的核心是去中心化和不可篡改性,这与道家'无为而治'的理念有相通之处。"
- 策略记忆: "在辩论中,当对手使用激进论点时,我会用温和的反问来引导思考..."
## 🔐 权限和安全
### 认证状态
- ✅ Google Cloud 用户: `benhouzhong@gmail.com`
- ✅ 默认项目: `inner-radius-469712-e9`
- ✅ 访问令牌: 有效
- ✅ IAM权限: 足够访问Vertex AI服务
### 启用的服务
-`aiplatform.googleapis.com` (Vertex AI API)
-`generativelanguage.googleapis.com` (Generative Language API)
-`ml.googleapis.com` (AI Platform API)
## 🚀 下一步建议
1. **Web端验证**: 使用提供的链接在Google Cloud Console中查看Memory Bank
2. **功能扩展**: 为其他智能体添加更多测试数据
3. **集成测试**: 在实际辩论系统中测试Memory Bank功能
4. **监控设置**: 配置Memory Bank使用情况的监控和告警
## 📝 注意事项
- Memory Bank 功能目前处于公开预览阶段
- 某些高级功能可能需要特殊权限或白名单
- API端点可能会随着服务更新而变化
- 建议定期备份重要的记忆数据
---
*最后更新: 2025-08-22 11:44*
*项目: 稷下学宫AI辩论系统*