Skip to content

huxuehao/apboa

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

128 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Apboa

企业级智能体平台 · Agent 原生架构

Java 21 Spring Boot Vue 3.5 AgentScope MIT License

基于 AgentScope 构建的可视化智能体平台
敏感词 · 多模型接入 · 多模态 · Tool · Skill · MCP · RAG · Human-in-the-Loop · Agent-as-Tool · AGUI
多节点部署 · 智能体缓存 · API Key 管理


Note: 因 issue 被恶意注入大量广告,issue 暂时关闭。有问题欢迎扫描底部二维码,进群讨论。


目录


为什么选择 Apboa?

在大模型应用进入工程化阶段之后,仅仅调用 API 已经远远不够。你需要的是:

需求 Apboa 的回答
可管理的智能体 可视化创建、配置、监控全生命周期
可扩展的能力模块 Tool / Skill / MCP / RAG 即插即用
可控的运行与审核机制 Human-in-the-Loop + Hook 灵活控制
可落地的企业级架构 多节点部署、智能体缓存、API Key 管理

Apboa 正是为此而生。 基于 AgentScope 构建,提供一套完整的 Agent 工程化解决方案,让你快速搭建企业级智能体系统,而不是拼凑工具链。


核心能力

Agent 原生架构

  • 可视化创建与配置智能体
  • 模块化能力组合(提示词 / 工具 / MCP / 知识库 / 审核策略等核心能力)
  • 支持 Agent 作为 Tool 被其他 Agent 调用
  • 支持复杂协作与任务分解

多模型统一接入

  • 支持 OpenAI / DashScope / Anthropic / Ollama 等主流模型
  • 统一抽象接口,模型自由切换
  • API Key 轮询与容错机制
  • 易于扩展新的模型供应商

API Key 管理

  • 支持为模型配置多个 API Key,自动轮询调度
  • 内置容错与失败重试机制,单 Key 异常自动切换
  • API Key 用量统计与状态监控
  • 支持按模型维度独立管理密钥,灵活配置

智能体缓存

  • 内置 Agent 运行时缓存机制,提升重复调用响应速度
  • 基于 Redis 实现分布式缓存,支持多节点共享
  • 支持缓存策略配置(过期时间、淘汰策略等)
  • 有效降低模型调用成本,减少不必要的重复推理

多节点部署

  • 支持水平扩展,多实例集群部署
  • 基于 Redis 实现节点间状态同步与协调
  • 会话与任务自动路由,无状态服务设计
  • 支持负载均衡,提升系统整体吞吐量与高可用性

多模态支持

  • 支持 3 种存储方案(S3 | FTP | 本地存储)
  • 支持 3 种文件类型(图片 | 音频 | 视频)

定时任务

  • 支持为智能体配置定时任务,自动化周期性执行

Hook 定义

  • 支持硬编码 Hook,在代码中预定义生命周期钩子
  • 支持在线编写 Hook,通过平台界面动态配置与热更新
  • 灵活扩展 Agent 运行流程与行为控制

技能包

  • 支持手动创建
  • 支持装载本地技能包
  • 支持导入技能压缩包
  • 支持下载 Git 技能包

Tool 定义

  • 支持硬编码 Tool,在代码中预定义工具能力
  • 支持在线编写 Tool,通过平台界面动态创建与编排
  • 工具可被 Agent 灵活调用,支持复杂业务逻辑

MCP 接入

  • 支持 MCP(Model Context Protocol)协议接入
  • 支持 HTTP、SSE、STDIO 多种传输方式
  • 与 MCP 生态工具无缝集成,扩展智能体能力边界

原生 RAG 能力

  • 内置知识增强生成流程
  • 支持百炼 / Dify / RagFlow 等知识源
  • 向量语义检索提升回答准确率
  • 可插拔式知识库结构

企业级运行控制

  • Human-in-the-Loop 审核机制
  • WebSocket 实时通信
  • 流式对话与工具调用

演示视频

平台整体介绍

序号 主题 链接
1 智能体的配置介绍 观看
2 智能体操作菜单的介绍 观看
3 智能体对话演示 观看
4 智能体对话操作按钮说明 观看
5 在对话过程中使用多模态的前提条件 观看
6 在线工具的注意事项 观看
7 技能包的说明 观看
8 系统设置介绍 观看

技术栈

层级 技术
语言 Java 21
框架 Spring Boot 3.4.9
AI 框架 AgentScope 1.0.8
ORM MyBatis-Plus
数据库 MySQL
缓存/集群 Redis
前端框架 Vue 3.5 + TypeScript
UI 组件 Ant Design Vue
构建工具 Vite
状态管理 Pinia

项目结构

apboa
├── common/                  # 通用基础层:实体、DTO、VO、枚举、工具类、异常、常量等
├── cluster/                 # 集群通信:基于 Redis 发布订阅实现多节点状态同步
├── websocket/               # WebSocket 实时通信模块
├── core/                    # 核心整合层:串联 Agent 全生命周期(模型/提示词/工具/MCP/知识库/Hook/技能等)
├── job/                     # 定时任务:基于 Quartz 的智能体周期调度
├── console/                 # 应用入口:会话配置、启动引导
├── biz/                     # 业务功能层
│   ├── model/               #   模型管理
│   ├── prompt/              #   提示词管理
│   ├── tool/                #   工具管理(硬编码 + 在线编写)
│   ├── mcp/                 #   MCP 协议接入(HTTP / SSE / STDIO)
│   ├── skill/               #   技能包管理与脚本执行
│   ├── knowledge/           #   知识库与 RAG 管理
│   ├── hook/                #   生命周期钩子
│   ├── sensitive/           #   敏感词过滤
│   ├── agent/               #   智能体核心(整合上述所有 biz 子模块)
│   ├── account/             #   账户与权限管理
│   ├── resource/            #   资源与文件存储(S3 / FTP / 本地)
│   ├── params/              #   系统参数配置
│   ├── a2a/                 #   Agent-to-Agent 通信
│   ├── studio/              #   Studio 集成
│   └── sk/                  #   技能框架初始化
├── ui/                      # 前端:Vue 3.5 + TypeScript + Ant Design Vue
└── docs/                    # 数据库脚本(schema + 增量 SQL)

模块依赖关系

console -> core -> agent -> [model, prompt, tool, mcp, skill, knowledge, hook, sensitive, params, a2a, studio]
                        |        |
                        |        └-> resource -> params
                        |
                        ├-> account -> params, websocket
                        ├-> job (Quartz)
                        └-> sk

common ← 被所有模块依赖(实体、工具类、缓存键等)
cluster ← 被 common / websocket 依赖(Redis 发布订阅)

快速启动

1. 克隆项目

git clone https://gitee.com/studioustiger/apboa.git
cd apboa

2. 初始化数据库

# 创建数据库
mysql -u root -p -e "CREATE DATABASE apboa CHARACTER SET utf8mb4;"

# 执行基础表结构
mysql -u root -p apboa < docs/schema.sql

# 按时间顺序执行增量 SQL(必须全部执行)
mysql -u root -p apboa < docs/2026-02-23-01.sql
mysql -u root -p apboa < docs/2026-02-27-01.sql
mysql -u root -p apboa < docs/2026-03-01-01.sql
mysql -u root -p apboa < docs/2026-03-02-01.sql
mysql -u root -p apboa < docs/2026-03-04-01.sql
mysql -u root -p apboa < docs/2026-03-05-01.sql
mysql -u root -p apboa < docs/2026-03-10-01.sql
mysql -u root -p apboa < docs/2026-03-20-01.sql
mysql -u root -p apboa < docs/2026-03-31-01.sql
mysql -u root -p apboa < docs/2026-04-01-01.sql
mysql -u root -p apboa < docs/2026-04-02-01.sql
mysql -u root -p apboa < docs/2026-04-04-01.sql
...

注意: schema.sql 为基础表结构,必须首先执行。其余 SQL 文件为增量更新脚本,请严格按照文件名中的日期顺序依次执行,不可跳过。

3. 启动后端

cd console
mvn clean install
mvn spring-boot:run

4. 启动前端

cd ui
pnpm install
pnpm run dev

5. 访问平台

http://localhost:3000

默认账号:admin / Admin@123.com


适用场景

  • 企业智能客服
  • 内部知识问答系统
  • AI 工作流自动化
  • 多 Agent 协作系统
  • AI 工具平台

Roadmap

  • 可视化编排实现多智能体协同

参与贡献

欢迎 Issue、PR、讨论与建议。

如果这个项目对你有帮助,请点一个 Star 支持一下!


License

MIT License


有问题,欢迎进群讨论:

微信群二维码


让智能体真正具备工程能力
Build production-ready AI agents, not demos.

About

Apboa 一个基于 AgentScope 构建的可视化智能体平台,支持敏感词 · 多模型接入 · 多模态 · Hook(硬编码 + 在线) · Tool(硬编码 + 在线) · Skill · MCP · RAG · Human-in-the-Loop · 多智能体 · AGUI 。

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors