快速开始 | 功能特性 | 架构设计 | API 文档 | 部署指南 | 贡献指南

BridgeAI 是一个开源的企业级智能 Agent 平台,帮助企业快速构建、部署和管理 AI Agent。通过 MCP (Model Context Protocol) 连接企业内部系统,结合 RAG 知识库和行业插件,让 AI 真正理解并服务企业业务。

核心价值:

• 零代码创建 Agent -- 通过 Web 界面配置 Agent 人设、工具和知识库
• 连接企业系统 -- 通过 MCP 连接器对接数据库、API、飞书等企业工具
• 私有化部署 -- 支持国产大模型(DeepSeek、通义千问),数据不出企业
• 多渠道触达 -- 企业微信、钉钉、飞书一键接入

# 1. 克隆项目
git clone https://github.com/SourceSeeker-SameOrigin/BridgeAI.git && cd BridgeAI
# 2. 启动基础设施(PostgreSQL + Redis + MinIO)
docker compose -f docker/docker-compose.dev.yml up -d
# 3. 启动后端
cd backend && cp .env.example .env # 编辑 .env 填入你的 API Key
pip install -r requirements.txt
alembic upgrade head
uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload

前端启动:

cd frontend && npm install && npm run dev

系统分层架构

• LangGraph 6 阶段管线 -- 意图理解 → 上下文增强 → 工具选择 → 模型路由 → 执行 → 结果整合
• 3 层智能模型路由 -- 默认模型 → 意图自适应调整 → 用户等级控制
• 熔断降级链 -- 主模型失败自动切换备选模型,保障可用性
• Prompt 四层融合 -- Agent 人设 + RAG 上下文 + Few-shot 示例 + 分析指令
• 流式输出 (SSE) -- 实时逐字输出,支持工具调用状态推送
• 反馈学习 -- 用户评分驱动 Few-shot 案例池自动优化

• 多类型支持 -- MySQL/PostgreSQL 数据库、HTTP API、飞书
• 即插即用 -- Web 界面配置连接信息即可使用
• 安全机制 -- 参数校验、输出脱敏(手机号/身份证/银行卡)、调用审计
• 网关管理 -- 连接器注册/注销、健康检查、工具列表发现

• 多格式解析 -- PDF、DOCX、Markdown、纯文本
• 智能切分 -- 可配置 chunk_size 和 overlap
• 向量检索 -- Milvus HNSW 向量检索
• 后台处理 -- 文档上传后异步解析入库,不阻塞用户

• 插件基类 -- 标准化工具定义和执行接口
• 内置行业 -- 跨境电商、财税、法律
• 提示模板 -- 每个插件可携带行业专属提示词
• 动态加载 -- 运行时发现和注册插件

• 企业微信 -- 消息接收/回复、事件验签、Access Token 管理
• 钉钉机器人 -- Webhook 回复、主动推送
• 微信小程序 -- C 端对话入口,jscode2session 静默登录
• 统一路由 -- 所有渠道消息统一进入 Agent 管线处理

• 钱包预充值 + 按量计费 -- 按 Token 实时扣费(model_pricing 表分别定价 input/output,含平台加价),类 DeepSeek 在线充值模式
• 注册即试用 -- 每个注册者创建独立租户并成为管理员,开通 24 小时全功能试用,到期后凭钱包余额继续
• 全站计费门控 -- 受保护接口要求「试用期内或余额 > 0」,否则返回 402,余额耗尽即停
• 双层钱包 -- B 端租户共享钱包(企业成员共用额度),C 端小程序用户个人钱包(各充各付,首登赠体验金)
• 充值方式 -- 微信/支付宝个人收款码人工确认(无需商户号),管理员后台上传收款码、审核到账
• 低余额预警 -- 余额低于阈值前端提示充值

• 多租户隔离 -- 租户级数据隔离,API Key + JWT 双认证
• 角色权限 -- 普通用户 / 租户管理员 / 平台超管(superadmin)三级,敏感操作(确认到账、改套餐、上传收款码)限超管
• 用量计费 -- Token 消耗和 MCP 调用次数统计,钱包流水可查
• 审计日志 -- 全链路操作记录,支持合规审计
• 仪表盘 -- 对话量、Token 消耗、意图分布、情感分析可视化

所有 API 均以 /api/v1 为前缀,统一响应格式:

{
 "code": 200,
 "message": "success",
 "data": { ... }
}

完整 API 文档请参考 API Reference 或启动后访问 /docs。

环境变量配置参考 .env.example:

*至少配置一个 LLM Provider 的 API Key

docker compose -f docker/docker-compose.dev.yml up -d # 基础设施
cd backend && uvicorn app.main:app --reload # 后端热重载
cd frontend && npm run dev # 前端热重载

docker compose -f docker/docker-compose.yml up -d # 全栈部署

BridgeAI 支持完全私有化部署,推荐配合国产大模型使用:

• 使用 DeepSeek 或通义千问作为 LLM 后端
• 使用 Ollama 运行本地模型(无需外网)
• 所有数据存储在企业内部,不外传

详细部署指南请参考 部署文档。

BridgeAI/
├── backend/ # Python 后端
│ ├── app/
│ │ ├── main.py # FastAPI 入口
│ │ ├── config.py # 配置管理
│ │ ├── api/v1/ # API 路由层
│ │ ├── services/ # 业务逻辑层
│ │ ├── models/ # ORM 模型
│ │ ├── schemas/ # Pydantic 数据模型
│ │ ├── engine/ # Agent 管线引擎
│ │ ├── agents/ # 模型路由 + 熔断器
│ │ ├── mcp/ # MCP 网关 + 连接器
│ │ ├── rag/ # RAG 引擎
│ │ ├── plugins/ # 行业插件
│ │ ├── channels/ # 渠道接入
│ │ ├── providers/ # LLM 提供商适配
│ │ └── middleware/ # 中间件
│ ├── migrations/ # Alembic 数据库迁移
│ └── tests/ # 测试
├── frontend/ # React 前端(B 端 Web 管理)
├── miniapp/ # 微信小程序(C 端对话)
├── docker/ # Docker 配置
├── scripts/ # 运维脚本
├── docs/ # 项目文档
└── blueprint/ # 产品蓝图

欢迎贡献代码!请阅读 贡献指南 了解开发流程和代码规范。

本项目采用 MIT License 开源协议。