项目介绍
什么是 Snail AI?
Snail AI 是一款开源企业级 AI Agent 平台,基于 Java 21 + Spring Boot 4 + Spring AI 2.0 构建,采用分布式 Server-Agent 架构,致力于为企业提供安全、可控、可扩展的智能体开发与运行环境。
设计理念
| 理念 | 说明 |
|---|---|
| 企业级 | 面向生产环境设计,支持多数据库、分布式部署、全链路追踪,满足企业信创合规要求 |
| 可扩展 | 责任链架构、拦截器机制、MCP 协议、技能系统,每个环节都可灵活定制与扩展 |
| 自主可控 | 客户端 SDK 提供拦截器链,深度介入 AI 交互全流程;支持本地工具执行,数据不出域 |
核心优势
- Spring AI 原生集成 -- 深度拥抱 Spring 生态,基于 Spring AI 2.0 构建,天然适合 Java/Spring 技术栈团队
- 分布式 gRPC 架构 -- Server 负责编排调度,Agent Client 负责执行,通过 gRPC 双向流通信,支持多节点水平扩展
- 客户端拦截器机制 -- SDK 提供完整的拦截器链(Interceptor)和 Advisor 流水线,可自定义请求/响应处理逻辑,实现业务深度定制
- 多数据库适配 -- 原生支持 MySQL、PostgreSQL、SQL Server、达梦、MariaDB,满足不同企业的数据库选型和信创合规需求
- MCP 工具集成 -- 完整实现 Model Context Protocol(SSE/Streamable HTTP/Stdio),支持 API Key/Bearer Token/OAuth 多种认证
- 生产级 RAG -- 支持 10+ 文档格式、4 种分片策略、混合检索(向量 + BM25 + RRF 融合 + 重排序),文档智能去重
- 全链路可观测性 -- Langfuse 风格的 Observation 追踪树,瀑布图可视化各阶段耗时,内置评分系统
技术栈
后端
| 技术 | 版本/说明 |
|---|---|
| Java | 21+ |
| Spring Boot | 4.x |
| Spring AI | 2.0 |
| gRPC | Server-Agent 双向流通信 |
| MyBatis-Plus | ORM 框架 |
| Sa-Token | 认证鉴权 |
前端
| 技术 | 版本/说明 |
|---|---|
| Vue | 3.x |
| TypeScript | 类型安全 |
| Vite | 7.x 构建工具 |
| Naive UI | 组件库 |
数据库
| 类型 | 支持 |
|---|---|
| 关系型数据库 | MySQL、PostgreSQL、SQL Server、达梦(DM)、MariaDB |
| 向量存储 | PgVector、Milvus、Elasticsearch |
| 文件存储 | MinIO、本地文件系统 |
支持的大模型
| 厂商 | 说明 |
|---|---|
| OpenAI | GPT 系列,兼容 OpenAI 接口的第三方服务 |
| Claude | Anthropic Claude 系列 |
| Ollama | 本地部署开源模型 |
| Gemini | Google Gemini 系列 |
| 火山引擎 | 字节跳动豆包等模型 |
支持 CHAT / EMBEDDING / RERANKER / IMAGE / SPEECH 五种模型类型的统一管理。
开源协议
Snail AI 采用 Apache License 2.0 开源协议,可免费用于商业项目。
相关链接
- Gitee 仓库(后端): https://gitee.com/opensnail/snail-ai
- Gitee 仓库(前端): https://gitee.com/opensnail/snail-ai-admin
- 问题反馈: https://gitee.com/opensnail/snail-ai/issues