好的！以下是针对你“八仙多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模板集合和记忆管理设计文档 --- 如果你觉得这个需求文档需要调整细化，或者想要配套的技术方案设计、接口规范、甚至样板代码，我都可以帮你补充完善。