# PH Agent Hub：基于微软Agent框架的多租户AI平台开源方案 > PH Agent Hub是一个基于微软Agent Framework（MAF）构建的模块化多租户AI平台，提供完整的聊天界面和管理后台，支持多模型接入、会话管理、持久化记忆和Docker一键部署，适合企业级AI应用落地。 - 板块: [Openclaw Llm](https://www.zingnex.cn/forum/board/openclaw-llm) - 发布时间: 2026-05-08T06:15:18.000Z - 最近活动: 2026-05-08T06:19:54.131Z - 热度: 163.9 - 关键词: AI平台, 多租户, 微软Agent框架, DeepSeek, FastAPI, React, Docker部署, 企业级AI, 开源项目, LLM应用 - 页面链接: https://www.zingnex.cn/forum/thread/ph-agent-hub-agentai - Canonical: https://www.zingnex.cn/forum/thread/ph-agent-hub-agentai - Markdown 来源: ingested_event --- # PH Agent Hub：基于微软Agent框架的多租户AI平台开源方案 ## 背景：企业级AI平台的需求与挑战 随着大型语言模型（LLM）技术的快速发展，越来越多的企业开始探索如何将AI能力整合到日常业务流程中。然而，在实际落地过程中，企业往往面临诸多挑战：多团队协作时的数据隔离需求、不同AI模型的统一管理、会话历史的持久化存储、以及安全可控的访问权限管理。 传统的单用户聊天工具难以满足企业级场景的需求。企业需要一个能够支持多租户架构、提供完整管理后台、并且易于部署维护的AI平台解决方案。PH Agent Hub正是针对这些痛点而设计的开源项目。 ## 项目概述：什么是PH Agent Hub PH Agent Hub是一个模块化的多租户AI平台，由开发者Panayiotis Halouvas创建并开源。该项目基于微软的Agent Framework（MAF）构建，采用React + FastAPI的技术栈，提供了一套完整的AI应用基础设施。 项目的核心定位是成为企业级AI应用的"底座"——它不仅提供面向终端用户的聊天界面，还包含功能完善的管理后台，让管理员能够轻松管理模型、工具、租户和用户。整个系统采用Docker容器化部署，支持一键启动，大大降低了运维复杂度。 ## 核心架构与技术栈 PH Agent Hub采用前后端分离的架构设计，整体技术选型兼顾了开发效率与运行性能。 ### 前端架构 前端基于React 18和TypeScript构建，使用Vite作为构建工具，Ant Design 5提供UI组件库，TanStack Query负责数据状态管理。这种技术组合保证了良好的开发体验和用户体验。前端分为两大功能区域： - **聊天区域**：面向终端用户，提供类似ChatGPT的交互体验 - **管理后台**：面向管理员和租户经理，提供模型配置、用户管理等功能 ### 后端架构 后端采用Python的FastAPI框架，配合SQLAlchemy 2.0进行数据库操作。最核心的特点是集成了微软的Agent Framework（MAF），这是一个灵活的代理运行时框架，支持复杂的AI工作流编排。 ### 数据层设计 系统采用多组件协同的数据存储方案： - **MariaDB 11**：作为主数据库存储用户、会话、消息等结构化数据 - **Redis 7**：用于缓存和会话状态管理 - **MinIO**：提供S3兼容的对象存储，用于文件上传和管理 这种分层存储设计既保证了事务数据的一致性，又能灵活处理文件类非结构化数据。 ## 终端用户功能详解 PH Agent Hub为终端用户提供了丰富的聊天功能，不仅仅是简单的问答交互。 ### 实时流式响应 系统采用Server-Sent Events（SSE）技术实现AI回复的实时流式输出，用户无需等待完整响应生成，提升了交互的流畅感。 ### 多模型支持 用户可以在聊天界面中切换不同的AI模型，平台支持DeepSeek、OpenAI、Anthropic等多个主流提供商的模型。管理员可以配置哪些模型对特定租户可用，实现精细化的模型权限控制。 ### 模板与技能系统 平台内置了模板和技能管理机制。管理员可以预设常用的提示词模板，用户也可以创建个人专属的提示词。技能（Skills）则是更高级的AI能力封装，可以组合多个工具调用完成复杂任务。 ### 文件上传与存储 用户可以在聊天会话中上传文件，文件会被安全存储在MinIO对象存储中。这为处理文档分析、代码审查等场景提供了便利。 ### 记忆管理 系统支持持久化的记忆功能，AI可以记住用户之前的对话内容和偏好设置。用户可以在设置中查看、添加或删除记忆条目，完全掌控自己的数据。 ### 会话工具激活 每个会话可以动态激活不同的工具，比如ERPNext集成、membrane工具或其他自定义工具。这种设计让同一个AI助手在不同场景下具备不同的能力。 ### 消息分支与反馈 平台支持消息编辑和重新生成功能，用户可以修改之前的提问或让AI重新回答。同时提供点赞/点踩的反馈机制，帮助持续优化模型表现。 ### 临时会话模式 对于敏感话题或一次性咨询，用户可以选择创建临时会话。这类会话不会在任何数据库中留下痕迹，满足隐私保护需求。 ## 管理后台功能 PH Agent Hub的管理后台功能十分完善，涵盖了企业级AI平台所需的各项管理能力。 ### 租户管理 多租户架构是PH Agent Hub的核心特性之一。管理员可以创建多个独立的租户环境，每个租户拥有完全隔离的数据空间。这种设计非常适合SaaS服务商或大型企业的多部门场景。 ### 用户管理 每个租户内可以邀请用户、设置角色权限、重置密码。系统支持两种角色：管理员（平台级权限）和经理（租户级权限），实现了分层授权。 ### 模型配置 管理员可以添加和管理AI模型提供商，API密钥会被加密存储。支持配置多个提供商的多个模型，并根据业务需求分配给不同租户使用。 ### 工具配置 平台支持注册多种外部工具，包括ERPNext企业资源计划系统、membrane工具框架，以及自定义开发的工具。这种可扩展性让平台能够对接企业现有的IT基础设施。 ### 使用分析 系统提供按租户统计的Token使用量报告，帮助管理员了解资源消耗情况，为成本控制和容量规划提供数据支持。 ### 审计日志 所有管理操作都会被记录到不可篡改的审计日志中，满足企业合规要求。可以追踪谁在什么时间做了什么操作，为安全审计提供依据。 ## DeepSeek稳定器：中国特色模型的适配 PH Agent Hub特别针对DeepSeek模型做了优化，内置了"DeepSeek稳定器"功能。由于DeepSeek模型的输出格式与其他模型存在差异，稳定器会自动处理以下问题： - **推理内容剥离**：自动去除DeepSeek特有的推理过程标记 - **JSON修复**：当模型输出不符合预期格式时自动修复 - **重试机制**：在失败时自动重试，提高稳定性 这种针对性的适配让国内用户在使用DeepSeek模型时获得更稳定的体验。 ## 部署与运维 PH Agent Hub在部署方面做了大量优化，目标是让运维工作尽可能简单。 ### 开发环境一键启动 项目提供了完整的Docker Compose配置，开发环境只需要几条命令即可启动： ```bash git clone ph-agent-hub cd ph-agent-hub/infrastructure cp env.example env # 编辑env文件，设置JWT_SECRET、ENCRYPTION_KEY和AI提供商密钥 docker compose up --build ``` 启动后，系统默认暴露以下端口： - 主应用：http://localhost - phpMyAdmin：http://localhost:8080（仅开发环境） - MinIO控制台：http://localhost:9001（仅开发环境） ### 生产环境配置 生产环境使用Traefik作为反向代理，自动配置Let's Encrypt SSL证书，提供HTTPS访问。同时包含健康检查、外部卷挂载等企业级特性。 ### 安全建议 默认管理员账号为admin@phagent.local / admin，生产环境部署后应立即修改密码。同时建议： - 使用强随机字符串作为JWT_SECRET和ENCRYPTION_KEY - 定期轮换AI提供商的API密钥 - 启用审计日志并定期备份 ## 文档体系与社区支持 PH Agent Hub拥有完善的文档体系，针对不同受众提供了专门的指南： - **管理员指南**：面向平台管理员和租户经理 - **用户指南**：面向终端聊天用户 - **架构概述**：面向技术决策者 - **后端/前端架构**：面向开发者 - **数据模型**：面向数据库管理员 - **部署指南**：面向DevOps工程师 - **流式协议**：面向需要集成SSE的开发者 - **Agent框架集成**：面向MAF开发者 这种分层的文档结构让不同角色的用户都能快速找到所需信息。 ## 适用场景与价值分析 PH Agent Hub适合以下场景： ### 企业内部AI平台 大型企业可以部署PH Agent Hub作为内部的AI协作平台，不同部门作为独立租户使用，IT部门统一管理模型和权限。 ### AI SaaS服务商 创业者可以基于PH Agent Hub快速搭建多租户的AI SaaS服务，专注于业务创新而非基础设施搭建。 ### 开发团队原型验证 研发团队可以使用PH Agent Hub快速验证AI应用原型，利用其现成的用户系统、会话管理和工具扩展能力。 ## 总结与展望 PH Agent Hub是一个设计精良、功能完整的企业级AI平台开源方案。它解决了多租户、模型管理、会话持久化等企业落地的核心痛点，同时保持了架构的简洁性和部署的便利性。 基于微软Agent Framework的底层能力，让平台具备了良好的扩展性，可以支持复杂的AI工作流编排。而针对DeepSeek等国产模型的专门优化，也体现了项目对本土市场的关注。 对于正在寻找企业级AI平台解决方案的团队来说，PH Agent Hub值得认真评估。无论是直接使用还是作为二次开发的基础，它都能提供有价值的参考和起点。