Skip to content
Back to search

langchat

LangChat 是由 LangChat Team 开发的开源 AI Agent 应用平台,支持多模型、Agent、知识库 RAG、Skills、MCP 与智能问数。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/langchat--langchat/badge.svg)](/listings/langchat--langchat)

HTML

<a href="/listings/langchat--langchat"><img src="/api/listings/langchat--langchat/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 427 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <div align="center">
  2. <a href="https://agentic.langchat.cn/" title="了解 LangChat Agentic 企业商业版">
  3. <img src="docs/assets/langchat-platform-zh.svg" width="100%" alt="LangChat 开源 AI 智能体应用平台能力总览">
  4. </a>
  5. <h1>LangChat</h1>
  6. <p>由 LangChat Team 开发的开源 AI Agent 应用平台</p>
  7. <p>
  8. <a href="https://langchat.cn">官网</a> ·
  9. <a href="https://agentic.langchat.cn/">企业商业版</a> ·
  10. <a href="README.en.md">English</a>
  11. </p>
  12. <p>
  13. <img src="https://img.shields.io/badge/license-Apache--2.0-2563eb" alt="Apache-2.0 License">
  14. <img src="https://img.shields.io/badge/Java-17-ef4444" alt="Java 17">
  15. <img src="https://img.shields.io/badge/Spring_Boot-3.3-6db33f" alt="Spring Boot 3.3">
  16. <img src="https://img.shields.io/badge/Vue-3-42b883" alt="Vue 3">
  17. </p>
  18. </div>
  19. ## LangChat Agentic 企业商业版
  20. [LangChat Agentic](https://agentic.langchat.cn/) 是 LangChat Team 面向企业采购、交付与长期运营推出的商业产品。商业版拥有比当前开源版本更丰富、完整的产品能力,适合需要将 AI 应用规模化部署到真实业务流程中的组织。
  21. 商业版主要提供:
  22. - 标准智能体、工作流智能体与 Agentic 智能体三种应用构建范式;
  23. - 长期记忆、记忆压缩、独立会话工作空间与容器化沙箱执行;
  24. - Supervisor、顺序、并行和循环等多 Agent 协同编排;
  25. - 企业知识库、混合检索、索引版本切换、融合排序与可选重排;
  26. - 受控 Text2SQL 智能问数、企业数据源接入与可解释图表;
  27. - Function Call、MCP、A2A、Skill、OpenAPI 与 HTTP 扩展通道;
  28. - 模型治理、权限安全、内容安全、用量与成本控制、运行审计;
  29. - 私有化部署、信创适配、实施交付、培训与持续版本服务。
  30. <a href="https://agentic.langchat.cn/" title="访问 LangChat Agentic 企业商业版官网">
  31. <img src="docs/assets/langchat-agentic-preview.png" width="100%" alt="LangChat Agentic 企业智能体应用工作平台产品界面">
  32. </a>
  33. 如果你正在进行企业级 AI 平台选型或采购,建议优先了解 LangChat Agentic:
  34. [查看商业版完整能力](https://agentic.langchat.cn/) · [阅读商业白皮书](https://agentic.langchat.cn/docs) · [查看价格与交付方案](https://agentic.langchat.cn/price) · [了解团队](https://agentic.langchat.cn/about)
  35. ## 关于 LangChat
  36. LangChat 是一个模块化、可扩展的开源 AI Agent 应用平台。它将模型接入、Agent 构建、知识库 RAG、Skills、MCP、数据分析和权限管理整合到同一套 Java 与 Vue 技术体系中,帮助开发者快速搭建可运行、可集成的 AI 应用。
  37. 开源版本适合技术验证、二次开发和团队内部场景建设。项目采用模块化单体架构,在保持部署简单的同时,为后续按领域拆分和能力扩展保留清晰边界。
  38. ## 功能体系
  39. | 能力 | 说明 |
  40. | --- | --- |
  41. | 多模型接入 | 统一管理 OpenAI、Azure OpenAI、Anthropic、Gemini、DeepSeek、通义千问、智谱、Ollama 及 OpenAI 兼容服务 |
  42. | Agent 构建 | 配置模型、系统提示词、知识库、Skills 与 MCP,提供构建、调试和运行界面 |
  43. | 对话运行时 | 支持会话与消息管理、SSE 流式响应,并提供 OpenAI 兼容的 Chat Completions 接口 |
  44. | 知识库 RAG | 管理知识库、文档上传、解析预览、分段、索引状态和向量存储配置 |
  45. | Skills 扩展 | 支持技能包或文件夹上传、文件浏览、下载和运行时工具注册 |
  46. | MCP 集成 | 管理外部 MCP 服务配置,并在 Agent 运行时复用客户端会话 |
  47. | 智能问数 | 接入数据源、读取结构目录,以自然语言生成分析结果与图表 |
  48. | 图像能力 | 提供图像生成与图像识别接口,复用统一模型配置体系 |
  49. | 应用市场 | 发布和发现 Agent,并从统一聊天界面直接运行应用 |
  50. | 权限与治理 | 提供登录、用户、角色、菜单、动态路由与 RBAC 权限管理 |
  51. ## 核心亮点
  52. - **统一的 AI 运行时**:模型、Agent、知识库、Skills 与 MCP 通过清晰的运行时定义装配,降低业务代码对具体模型 SDK 的耦合。
  53. - **开放的协议入口**:同时提供平台 API 与 OpenAI 兼容接口,便于现有客户端和内部系统接入。
  54. - **面向扩展的工具体系**:技能文件、工具注册与 MCP 服务可以按 Agent 组合,适合持续接入企业工具和业务能力。
  55. - **从知识到数据分析**:同一平台覆盖文档知识检索与结构化数据分析,减少多套 AI 工具之间的上下文割裂。
  56. - **模块化单体架构**:后端按 common、auth、aigc、core、datasource、server 划分边界,兼顾开发效率与演进空间。
  57. - **完整管理界面**:Vue 3 前端覆盖概览、模型、Agent、知识库、Skills、MCP、数据源、用户与角色等主要工作流。
  58. ## 界面预览
  59. 以下截图来自本地开发环境启动后的实际界面,按功能分类展示。信息密度较高的页面(Agent 构建器、文档导入、数据源详情)采用一行两张,其余一行三张。
  60. ### 登录与总览
  61. <table align="center" style="width: 100%; max-width: 1200px; border-collapse: separate; border-spacing: 12px 4px;">
  62. <tr>
  63. <td align="center" style="padding-bottom: 4px;"><b>登录页</b></td>
  64. <td align="center" style="padding-bottom: 4px;"><b>概览</b></td>
  65. <td align="center" style="padding-bottom: 4px;"><b>应用市场</b></td>
  66. </tr>
  67. <tr>
  68. <td><img src="docs/assets/screenshots/login.png" width="100%" alt="LangChat 登录页"></td>
  69. <td><img src="docs/assets/screenshots/overview.png" width="100%" alt="LangChat 概览页,展示指标与趋势图"></td>
  70. <td><img src="docs/assets/screenshots/market.png" width="100%" alt="LangChat 应用市场"></td>
  71. </tr>
  72. </table>
  73. ### Agent 应用
  74. <table align="center" style="width: 100%; max-width: 880px; border-collapse: separate; border-spacing: 12px 4px;">
  75. <tr>
  76. <td align="center" style="padding-bottom: 4px;"><b>Agent 管理</b></td>
  77. <td align="center" style="padding-bottom: 4px;"><b>构建器 · 应用配置</b></td>
  78. </tr>
  79. <tr>
  80. <td><img src="docs/assets/screenshots/agents.png" width="100%" alt="Agent 管理列表"></td>
  81. <td><img src="docs/assets/screenshots/agent-builder-config.png" width="100%" alt="Agent 构建器应用配置与聊天调试"></td>
  82. </tr>
  83. <tr>
  84. <td align="center" style="padding-bottom: 4px;"><b>构建器 · API 接入</b></td>
  85. <td align="center" style="padding-bottom: 4px;"><b>构建器 · 消息日志</b></td>
  86. </tr>
  87. <tr>
  88. <td><img src="docs/assets/screenshots/agent-builder-api.png" width="100%" alt="Agent 构建器 API 接入页"></td>
  89. <td><img src="docs/assets/screenshots/agent-builder-logs.png" width="100%" alt="Agent 构建器消息日志页"></td>
  90. </tr>
  91. <tr>
  92. <td align="center" style="padding-bottom: 4px;"><b>构建器 · 统计报表</b></td>
  93. <td align="center" style="padding-bottom: 4px;"><b>应用对话</b></td>
  94. </tr>
  95. <tr>
  96. <td><img src="docs/assets/screenshots/agent-builder-stats.png" width="100%" alt="Agent 构建器统计报表页"></td>
  97. <td><img src="docs/assets/screenshots/market-chat.png" width="100%" alt="应用市场中的 Agent 对话页"></td>
  98. </tr>
  99. </table>
  100. ### 知识库与文档导入
  101. <table align="center" style="width: 100%; max-width: 880px; border-collapse: separate; border-spacing: 12px 4px;">
  102. <tr>
  103. <td align="center" style="padding-bottom: 4px;"><b>知识库管理</b></td>
  104. <td align="center" style="padding-bottom: 4px;"><b>导入文档 · 上传文件</b></td>
  105. </tr>
  106. <tr>
  107. <td><img src="docs/assets/screenshots/knowledges.png" width="100%" alt="知识库管理页"></td>
  108. <td><img src="docs/assets/screenshots/knowledge-import-upload.png" width="100%" alt="知识库导入文档的上传文件步骤"></td>
  109. </tr>
  110. <tr>
  111. <td align="center" style="padding-bottom: 4px;"><b>知识库 · 文档管理</b></td>
  112. <td align="center" style="padding-bottom: 4px;"><b>知识库 · 文档分段</b></td>
  113. </tr>
  114. <tr>
  115. <td><img src="docs/assets/screenshots/knowledge-documents.webp" width="100%" alt="知识库文档管理、向量化状态与任务操作"></td>
  116. <td><img src="docs/assets/screenshots/knowledge-segments.webp" width="100%" alt="知识库文档分段列表、元数据与向量化状态"></td>
  117. </tr>
  118. <tr>
  119. <td align="center" style="padding-bottom: 4px;"><b>导入文档 · 分段配置</b></td>
  120. <td align="center" style="padding-bottom: 4px;"><b>导入文档 · 执行向量化</b></td>
  121. </tr>
  122. <tr>
  123. <td><img src="docs/assets/screenshots/knowledge-import-chunking.png" width="100%" alt="知识库导入文档的分段配置步骤"></td>
  124. <td><img src="docs/assets/screenshots/knowledge-import-vectorize.png" width="100%" alt="知识库导入文档的执行向量化步骤"></td>
  125. </tr>
  126. </table>
  127. ### 智能问数与图片能力
  128. <table align="center" style="width: 100%; max-width: 1200px; border-collapse: separate; border-spacing: 12px 4px;">
  129. <tr>
  130. <td align="center" style="padding-bottom: 4px;"><b>智能问数</b></td>
  131. <td align="center" style="padding-bottom: 4px;"><b>图片生成</b></td>
  132. <td align="center" style="padding-bottom: 4px;"><b>图片识别</b></td>
  133. </tr>
  134. <tr>
  135. <td><img src="docs/assets/screenshots/data-analysis.png" width="100%" alt="智能问数页"></td>
  136. <td><img src="docs/assets/screenshots/studio-image.png" width="100%" alt="图片生成页"></td>
  137. <td><img src="docs/assets/screenshots/studio-ocr.png" width="100%" alt="图片识别页"></td>
  138. </tr>
  139. </table>
  140. ### 数据源
  141. <table align="center" style="width: 100%; max-width: 880px; border-collapse: separate; border-spacing: 12px 4px;">
  142. <tr>
  143. <td align="center" style="padding-bottom: 4px;"><b>数据源管理</b></td>
  144. <td align="center" style="padding-bottom: 4px;"><b>数据源详情 · 表内省</b></td>
  145. </tr>
  146. <tr>
  147. <td><img src="docs/assets/screenshots/datasources.png" width="100%" alt="数据源管理页"></td>
  148. <td><img src="docs/assets/screenshots/datasource-introspection.png" width="100%" alt="数据源详情页,展示数据库表内省结果"></td>
  149. </tr>
  150. </table>
  151. ### 模型与扩展能力
  152. <table align="center" style="width: 100%; max-width: 1200px; border-collapse: separate; border-spacing: 12px 4px;">
  153. <tr>
  154. <td align="center" style="padding-bottom: 4px;"><b>模型管理</b></td>
  155. <td align="center" style="padding-bottom: 4px;"><b>向量存储</b></td>
  156. <td align="center" style="padding-bottom: 4px;"><b>技能管理</b></td>
  157. </tr>
  158. <tr>
  159. <td><img src="docs/assets/screenshots/models.png" width="100%" alt="模型管理页"></td>
  160. <td><img src="docs/assets/screenshots/vector-stores.png" width="100%" alt="向量存储管理页"></td>
  161. <td><img src="docs/assets/screenshots/skills.png" width="100%" alt="技能管理页"></td>
  162. </tr>
  163. <tr>
  164. <td align="center" style="padding-bottom: 4px;"><b>MCP 管理</b></td>
  165. <td align="center" style="padding-bottom: 4px;"><b>模型监控</b></td>
  166. </tr>
  167. <tr>
  168. <td><img src="docs/assets/screenshots/mcp.png" width="100%" alt="MCP 管理页"></td>
  169. <td><img src="docs/assets/screenshots/model-monitor.png" width="100%" alt="模型监控页"></td>
  170. </tr>
  171. </table>
  172. ### 权限与治理
  173. <table align="center" style="width: 100%; max-width: 880px; border-collapse: separate; border-spacing: 12px 4px;">
  174. <tr>
  175. <td align="center" style="padding-bottom: 4px;"><b>用户管理</b></td>
  176. <td align="center" style="padding-bottom: 4px;"><b>角色管理</b></td>
  177. </tr>
  178. <tr>
  179. <td><img src="docs/assets/screenshots/users.png" width="100%" alt="用户管理页"></td>
  180. <td><img src="docs/assets/screenshots/roles.png" width="100%" alt="角色管理页,展示菜单授权标签"></td>
  181. </tr>
  182. <tr>
  183. <td align="center" style="padding-bottom: 4px;"><b>菜单管理</b></td>
  184. <td align="center" style="padding-bottom: 4px;"><b>关于</b></td>
  185. </tr>
  186. <tr>
  187. <td><img src="docs/assets/screenshots/menus.png" width="100%" alt="菜单管理页"></td>
  188. <td><img src="docs/assets/screenshots/about.png" width="100%" alt="关于页面"></td>
  189. </tr>
  190. </table>
  191. ## 技术架构
  192. ```mermaid
  193. flowchart LR
  194. U[用户 / 外部系统] --> UI[Vue 3 管理端]
  195. U --> API[REST / OpenAI-compatible API]
  196. UI --> API
  197. API --> AUTH[langchat-auth<br/>认证与 RBAC]
  198. API --> AIGC[langchat-aigc<br/>配置与资源管理]
  199. API --> CORE[langchat-core<br/>Agent / Chat / RAG / Skills]
  200. API --> DS[langchat-datasource<br/>数据源与智能问数]
  201. CORE --> LLM[模型服务<br/>OpenAI / Gemini / Ollama / ...]
  202. CORE --> MCP[MCP 服务与工具]
  203. CORE --> VECTOR[Pgvector / Milvus]
  204. AIGC --> MYSQL[(MySQL)]
  205. AUTH --> MYSQL
  206. DS --> DATA[(业务数据源)]
  207. ```
  208. ### 技术栈
  209. | 层级 | 主要技术 |
  210. | --- | --- |
  211. | 后端 | Java 17、Spring Boot 3.3、LangChain4j 1.12、MyBatis-Plus、Sa-Token |
  212. | 前端 | Vue 3、TypeScript、Vite、Pinia、Naive UI、Tailwind CSS、VXE Table、ECharts |
  213. | 数据 | MySQL、PostgreSQL / Pgvector、Milvus |
  214. | 工程 | Maven 多模块、pnpm workspace、SSE、OpenAI-compatible API |
  215. ### 项目结构
  216. ```text
  217. langchat
  218. ├── build-release.sh # 构建后端、前端并生成非 Docker 交付目录
  219. ├── build-docker.sh # Docker 配置准备、镜像构建与服务管理入口
  220. ├── langchat-common # 公共基础能力与依赖管理
  221. ├── langchat-auth # 认证、用户、角色、菜单与权限
  222. ├── langchat-aigc # 模型、Agent、知识库、Skills 等业务管理
  223. ├── langchat-core # 对话运行时、RAG、MCP、图像与数据分析
  224. ├── langchat-datasource # 数据源接入、结构读取与查询能力
  225. ├── langchat-server # Spring Boot 启动与应用配置
  226. ├── langchat-ui # Vue 3 前端工作区
  227. └── docs/db # 数据库初始化脚本
  228. ```
  229. ## 快速开始
  230. ### 环境要求
  231. - JDK 17+
  232. - Maven 3.9+
  233. - Node.js 22.22+
  234. - pnpm 10.32+
  235. - MySQL 8+
  236. ### 1. 获取代码
  237. ```bash
  238. git clone -b next https://github.com/langchat/langchat.git
  239. cd langchat
  240. ```
  241. ### 2. 配置本地环境
  242. 本地配置文件已被 Git 忽略,不会被提交:
  243. ```bash
  244. cp langchat-server/src/main/resources/application-local.example.yml \
  245. langchat-server/src/main/resources/application-local.yml
  246. ```
  247. 编辑 `application-local.yml`,填写数据库连接和本地管理员密码。生产环境请使用环境变量,不要将密码或密钥写入仓库。
  248. 数据库初始化脚本位于 `docs/db/langchat.sql`。
  249. ### 3. 安装前端依赖
  250. ```bash
  251. cd langchat-ui
  252. corepack enable
  253. pnpm install
  254. cd ..
  255. ```
  256. ### 4. 启动项目
  257. ```bash
  258. SPRING_PROFILES_ACTIVE=local ./langchat.sh
  259. ```
  260. 默认地址:
  261. - 前端:`http://localhost:5888`
  262. - 后端:`http://localhost:8080`
  263. - 健康检查:`http://localhost:8080/actuator/health`
  264. 也可以分别运行后端与前端:
  265. ```bash
  266. mvn -pl langchat-server -am spring-boot:run
  267. pnpm --dir langchat-ui --filter @vben/web-naive dev
  268. ```
  269. ## 构建与部署
  270. 项目根目录提供两个统一入口脚本。两者用途不同:`build-release.sh` 用于生成可复制到服务器的传统交付目录,`build-docker.sh` 用于构建和管理 Docker Compose 服务。
  271. ### 生成非 Docker 交付目录
  272. 执行:
  273. ```bash
  274. bash build-release.sh
  275. ```
  276. 脚本会依次完成 Maven 后端打包、Vue 前端生产构建和交付文件检查,并在根目录生成已被 Git 忽略的 `release/`:
  277. ```text
  278. release/
  279. ├── app/langchat.jar
  280. ├── config/
  281. ├── html/
  282. ├── logs/
  283. ├── nginx/default.conf
  284. ├── sql/01-langchat.sql
  285. └── langchat-workspace/
  286. ```
  287. 可以通过环境变量修改输出目录:
  288. ```bash
  289. LANGCHAT_RELEASE_DIR=/opt/releases/langchat bash build-release.sh
  290. ```
  291. 脚本不会自动安装前端依赖。首次构建前请先在 `langchat-ui/` 中执行 `pnpm install`。部署后端时,应复制并修改 `release/config/application-runtime.example.yml`,再通过 Spring Boot 的 `spring.config.additional-location` 参数加载真实配置。
  292. ### Docker Compose 部署
  293. 首次部署先生成本地配置:
  294. ```bash
  295. bash build-docker.sh prepare
  296. ```
  297. 该命令仅在文件不存在时创建以下配置,不会覆盖已有内容:
  298. - `docker/.env`:MySQL、Pgvector、RustFS 和镜像等基础设施参数;
  299. - `docker/application-docker.yml`:LangChat 后端数据库、管理员和 S3 客户端配置。
  300. 修改两份配置并确保数据库与 RustFS 凭据相互一致,然后执行:
  301. ```bash
  302. bash build-docker.sh deploy
  303. ```
  304. `deploy` 会构建 LangChat 镜像并在后台启动 LangChat、MySQL、Pgvector 与 RustFS。后端业务配置通过 Compose 同目录的 YAML 文件挂载到容器中,不需要在 `docker-compose.yml` 内维护大量应用参数。
  305. 常用命令:
  306. | 命令 | 作用 |
  307. | --- | --- |
  308. | `bash build-docker.sh build` | 仅构建 LangChat 应用镜像 |
  309. | `bash build-docker.sh up` | 使用现有镜像启动全部服务 |
  310. | `bash build-docker.sh down` | 停止并删除容器,保留数据卷 |
  311. | `bash build-docker.sh restart` | 重启 LangChat 应用容器 |
  312. | `bash build-docker.sh logs [服务名]` | 持续查看日志,默认服务为 `langchat` |
  313. | `bash build-docker.sh status` | 查看服务状态 |
  314. | `bash build-docker.sh config` | 展开并校验 Compose 配置 |
  315. | `bash build-docker.sh release` | 调用 `build-release.sh` 生成传统交付目录 |
  316. 可通过 `LANGCHAT_DOCKER_ENV_FILE` 指定其他 Compose 环境变量文件,通过 `LANGCHAT_CONFIG_SOURCE` 指定相对于 `docker/docker-compose.yml` 的后端 YAML。完整的容器端口、存储和健康检查说明见 [Docker 部署文档](docker/README.md)。
  317. ## 配置与安全
  318. - `application.yml` 保存通用配置。
  319. - `application-dev.yml`、`application-test.yml` 和 `application-prod.yml` 对应不同运行环境。
  320. - `application-local.yml` 仅用于本机真实配置,已加入 `.gitignore`。
  321. - Docker 部署的后端业务参数写入本地 `docker/application-docker.yml`,基础设施参数写入 `docker/.env`;两个文件均已被 Git 忽略。
  322. - 部署前必须替换示例中的 `change-me`、默认密码和访问密钥;`build-docker.sh` 会拒绝使用仍包含 `change-me` 的配置启动。
  323. - 非 Docker 部署可以使用外部 YAML 或环境变量覆盖配置,不要直接修改并提交生产凭据。
  324. - 不要在 Issue、日志、提交记录或截图中公开 API Key、数据库密码和访问令牌。
  325. ## 参与贡献
  326. 欢迎通过 Issue 报告问题、讨论设计或提出功能建议。提交代码前请阅读 [贡献指南](CONTRIBUTING.md) 与 [行为准则](CODE_OF_CONDUCT.md)。安全问题请按照 [安全政策](SECURITY.md) 私下报告。
  327. 当前开发基线为 `next` 分支,请基于该分支创建功能分支并向 `next` 提交 Pull Request。
  328. ## 商业支持
  329. LangChat Agentic 是面向企业采购的完整商业产品。如果你的组织正在建设企业级智能体平台,或需要私有化部署、系统集成、实施交付与持续服务,建议直接评估 [LangChat Agentic](https://agentic.langchat.cn/)。
  330. - [LangChat 官网](https://langchat.cn)
  331. - [LangChat Agentic 产品介绍](https://agentic.langchat.cn/)
  332. - [商业白皮书](https://agentic.langchat.cn/docs)
  333. - [价格与交付方案](https://agentic.langchat.cn/price)
  334. ## 许可证
  335. 除子目录另有声明外,本项目基于 [Apache License 2.0](LICENSE) 开源。`langchat-ui` 包含基于 MIT License 分发的 Vue Vben Admin 相关代码,详情请参阅 [langchat-ui/LICENSE](langchat-ui/LICENSE) 和 [NOTICE](NOTICE)。
  336. Copyright © 2026 LangChat Team.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.