117 lines
4.5 KiB
Markdown
117 lines
4.5 KiB
Markdown
好的！以下是针对你“八仙多Agent辩论系统 + Mastodon引流 + Streamlit实时展示”，基于Google ADK免费额度的详细需求文档，方便你交给Kiro进行开发。
|
||
|
||
---
|
||
|
||
# 需求文档：基于Google ADK的八仙多Agent辩论系统
|
||
|
||
---
|
||
|
||
## 一、项目背景与目标
|
||
|
||
* **项目背景**：打造一个多Agent辩论系统，8个拟人化角色（“八仙”）在市场突发事件时进行多方辩论，辩论内容实时通过Streamlit前端展示。同时通过Mastodon社交平台发布轻松动态，吸引用户关注和引流。
|
||
* **目标**：
|
||
|
||
* 利用Google ADK（含免费额度）搭建多Agent长期记忆系统（Memory Bank）和检索增强生成（RAG）
|
||
* 实现八个角色独立人格和独立记忆空间，保证角色稳定性和多样性
|
||
* 实时监控市场数据触发紧急辩论事件
|
||
* 在Streamlit实时展示辩论过程、行情数据和结论
|
||
* Mastodon账号模拟八仙发布轻社交内容，实现引流和用户互动
|
||
|
||
---
|
||
|
||
## 二、核心功能需求
|
||
|
||
### 1. 多Agent系统架构
|
||
|
||
* 8个独立Agent，分别代表不同市场角色（交易员、经济学家、央行顾问等）
|
||
* 每个Agent配备独立的Memory Bank（Google ADK Memory Bank），用于存储和检索长期记忆和知识
|
||
* Agent能检索自身Memory Bank相关信息，结合当前上下文进行动态对话和观点生成
|
||
* 统一调用Google GenAI接口，利用免费额度进行生成与检索
|
||
* Agent间支持异步、多轮交互，形成辩论流程
|
||
|
||
### 2. 记忆管理
|
||
|
||
* Memory Bank支持多模态存储（文本、结构化数据等）
|
||
* 支持长期记忆（历史辩论内容、预测结果、个人观点）和短期上下文记忆（当前会议）
|
||
* 定期同步本地向量库（如Milvus/Qdrant）与Google Memory Bank，提升检索效率
|
||
* 实现基于内容哈希的缓存机制，减少重复调用
|
||
|
||
### 3. 市场数据触发模块
|
||
|
||
* 实时监听主要市场指标（纳指、标普、黄金、加密货币等）和财经新闻
|
||
* 设定触发规则（如纳指暴跌超过10%）启动紧急辩论会议
|
||
* 支持自定义触发事件和预警配置
|
||
|
||
### 4. Streamlit展示前端
|
||
|
||
* 实时行情图表展示
|
||
* 辩论内容滚动显示（多Agent轮流发言）
|
||
* 会议总结与观点汇总卡片
|
||
* 用户评论和互动区（可选）
|
||
|
||
### 5. Mastodon社交引流模块
|
||
|
||
* 每个Agent拥有独立Mastodon账号
|
||
* 自动发布轻松、拟人化的市场动态、观点碎片和会议预告
|
||
* 监听Mastodon事件，结合Pub/Sub机制触发系统响应
|
||
* 支持用户互动回复采集
|
||
|
||
---
|
||
|
||
## 三、技术细节
|
||
|
||
### 1. 平台与工具
|
||
|
||
* **核心API**：Google AI Developer Kit (ADK)，利用Generative AI免费额度
|
||
* **记忆库**：Google Memory Bank + 本地Milvus/Qdrant向量库
|
||
* **调用调度**：Litellm或自定义调度器管理多API调用，负载均衡和容错
|
||
* **前端**：Streamlit（Python）
|
||
* **社交**：Mastodon API集成，Python脚本自动发帖和监听
|
||
* **缓存**：Redis或内存缓存，基于请求hash缓存生成结果
|
||
|
||
### 2. 角色人格设定
|
||
|
||
* 每个Agent具有独特的Prompt模板，包含背景故事、语气、知识偏好
|
||
* 通过RAG检索自身记忆，生成与人格一致的回答
|
||
* 支持Agent记忆动态更新，包含辩论历史和新信息
|
||
|
||
### 3. 数据流与接口
|
||
|
||
* 市场数据 → 触发模块 → 启动辩论流程
|
||
* 触发模块 → 通知Mastodon发布预告
|
||
* 多Agent通过ADK接口交互，结果返回Streamlit展示
|
||
* Mastodon监听事件，触发后续系统行为
|
||
* 缓存层拦截重复请求，提升效率
|
||
|
||
---
|
||
|
||
## 四、性能与扩展
|
||
|
||
* 支持并发8个Agent多轮对话，响应时间控制在1-3秒内
|
||
* 内存和存储支持至少半年以上辩论历史积累
|
||
* 可扩展到更多Agent和多模态输入（图片、音频）
|
||
* 支持后续接入更多API（OpenRouter、魔搭等）进行混合调用
|
||
|
||
---
|
||
|
||
## 五、运维与监控
|
||
|
||
* 实时监控API调用额度和使用情况，避免超额扣费
|
||
* 系统异常告警（调用失败、连接断开等）
|
||
* 日志记录辩论内容和用户互动，用于后续分析和优化
|
||
* 定期备份Memory Bank和本地数据库
|
||
|
||
---
|
||
|
||
## 六、交付物
|
||
|
||
* 多Agent辩论系统完整后端代码，含ADK集成和调度逻辑
|
||
* Streamlit展示前端代码与部署方案
|
||
* Mastodon自动发帖和监听脚本
|
||
* 部署说明文档和API调用监控方案
|
||
* 角色人格Prompt模板集合和记忆管理设计文档
|
||
|
||
---
|
||
|
||
如果你觉得这个需求文档需要调整细化，或者想要配套的技术方案设计、接口规范、甚至样板代码，我都可以帮你补充完善。
|