diff --git a/README.md b/README.md index 679684e8..730dbb8d 100644 --- a/README.md +++ b/README.md @@ -70,9 +70,11 @@ * 2021 年终发布 Vue3 的前后分离版本,使得 JeeSite 拥有同一个后台服务 Web 来支撑分离版和全栈版两套前端技术栈。 -* 对接常见 AI 大模型(OpenAPI、Ollama、DeepSeek等),支持检索增强生成 RAG 技术,实现企业知识库智能对话。 +* 对接 OpenAPI、Ollama、DeepSeek 等热门 AI 大模型,凭借检索增强生成 RAG 技术,为企业知识库打造专属智能对话。 -* 支持国产化软硬件环境,如国产芯片、操作系统、数据库、中间件、国密算法等。 +* 提供大模型 Tool 本地工具调用及 MCP 服务端和客户端工具调用,助力大模型与您的业务深度融合,实现高效交互。 + +* 支持国产化软件和硬件环境,如国产芯片、操作系统、数据库、中间件、国密算法等。 ## 核心优势 @@ -90,7 +92,7 @@ * 至今 JeeSite 平台架构已经非常稳定,我们持续升级,并不失架构的先进性。 * JeeSite 精益求精,用心打磨每一个细节,界面 UI 操作便捷,体验性好。 -* JeeSite 是一个专业的平台,是一个可以让您使用放心的平台。 +* JeeSite 是一个专业的平台,是一个可以让您,用着省心的平台。 * 社区版基于 Apache License 2.0 开源协议,永久免费使用。 ### 架构特点及安全方面的优势: diff --git a/modules/cms-ai/README.md b/modules/ai/README.md similarity index 82% rename from modules/cms-ai/README.md rename to modules/ai/README.md index fd6ea2cc..6a93953d 100644 --- a/modules/cms-ai/README.md +++ b/modules/ai/README.md @@ -1,7 +1,7 @@ ## 模块简介 -本模块基于 Spring AI 和 JeeSite 内容管理系统(CMS)并结合了检索增强生成(Retrieval-Augmented Generation, RAG)技术 +该模块基于 Spring AI 和 JeeSite 内容管理系统(CMS)并结合了检索增强生成(Retrieval-Augmented Generation, RAG)技术 和先进的人工智能算法(AI),打造了一个强大的企业级知识管理和智能对话平台。该模块专为企业设计,旨在通过高效的知识获取和精准的对话能力, 提升企业的信息管理效率和员工的工作效能。 @@ -9,11 +9,13 @@ 能获得最新且准确的结果。这种检索与生成相结合的方式,不仅提高了信息检索的准确性,还增强了回答的上下文关联性, 特别适合处理复杂的企业知识库。 -此外该模块,支持在线大模型和本地部署的大模型,如:Ollama、DeepSeek、通义千问,理论上支持所有 OpenAPI 标准接口的 AI 提供商。 +此外该模块,支持云端模型和本地部署的大模型,如:Ollama、DeepSeek、通义千问,理论上支持所有 OpenAPI 标准接口的 AI 提供商。 并能无缝集成多种嵌入式 AI 模型的向量数据库,如 Chroma、PGVector、Elasticsearch、Milvus 等,实现高效的数据存储、检索及分析。 无论是大规模数据集还是高度专业化的领域知识,JeeSite CMS + RAG + AI 都能提供定制化解决方案,满足企业多样化的业务需求和技术要求。 企业可以轻松管理和访问复杂的信息资源,促进内部知识共享和创新,从而在竞争激烈的市场环境中保持领先地位。 +提供大模型 Tool 本地工具调用及 MCP 服务端和客户端工具调用,助力大模型与您的业务深度融合,实现高效交互。 + 优势:本模块结构清晰,代码简洁易懂,不管是正式项目、或是学习 AI 技术、都能轻松应对读懂源代码。 ## 在线演示 @@ -22,14 +24,14 @@ ## 源码下载 -* 后端: +* 后端: * 前端: ## AI 模型配置 支持的 AI 模型列表: -* 线上模型:理论上支持所有 [OpenAPI](https://help.aliyun.com/zh/model-studio/developer-reference/use-qwen-by-calling-api) 标准接口的 AI 提供商。 +* 云端模型:理论上支持所有 [OpenAPI](https://help.aliyun.com/zh/model-studio/developer-reference/use-qwen-by-calling-api) 标准接口的 AI 提供商。 * 本地模型:使用 [Ollama](https://ollama.com) 安装方法,本文不多赘述,网上有很多安装资料。 @@ -40,7 +42,7 @@ spring.ai.model.chat: openai ``` -具体配置项详见 [jeesite-cms-ai.yml](https://gitee.com/thinkgem/jeesite5/blob/v5.springboot3/modules/cms-ai/src/main/resources/config/jeesite-cms-ai.yml) 文件,有注释。 +具体配置项详见 [jeesite-ai-cms.yml](https://gitee.com/thinkgem/jeesite5/blob/v5.springboot3/modules/ai/ai-cms/src/main/resources/config/jeesite-ai-cms.yml) 文件,有注释。 ## 向量数据库配置 @@ -57,7 +59,7 @@ spring.ai.model.chat: openai spring.ai.vectorstore.type: none ``` -具体配置项详见 [jeesite-cms-ai.yml](https://gitee.com/thinkgem/jeesite5/blob/v5.springboot3/modules/cms-ai/src/main/resources/config/jeesite-cms-ai.yml) 文件,有注释。 +具体配置项详见 [jeesite-ai-cms.yml](https://gitee.com/thinkgem/jeesite5/blob/v5.springboot3/modules/ai/ai-cms/src/main/resources/config/jeesite-ai-cms.yml) 文件,有注释。 ### 安装 Chroma @@ -133,7 +135,42 @@ CREATE INDEX ON vector_store_1024 USING HNSW (embedding vector_cosine_ops); 工具调用 Tool Calling(也称 Function Calling)是人工智能应用程序中的常见模式,允许模型与一组 API 或工具交互,从而增强其功能。 -实例代码,详见 [CmsAiTools.java](https://gitee.com/thinkgem/jeesite5/blob/v5.springboot3/modules/cms-ai/src/main/java/com/jeesite/modules/cms/ai/tools/CmsAiTools.java) 让 AI 调用你的 java 实现你的业务联动。 +实例代码,详见 [TestAiTools.java、UserAiTools.java](https://gitee.com/thinkgem/jeesite5/blob/v5.springboot3/modules/ai/ai-tools/src/main/java/com/jeesite/modules/ai/tools/) 让 AI 调用你的 java 实现你的业务联动。并能保持当前用户会话,进行数据权限控制。 + +## MCP 模型上下文协议 + +实现 MCP(Model Context Protocol)服务端,基于 SSE(Server-Sent Events)的标准接入。 + +* 服务端:[web-mcp](https://gitee.com/thinkgem/jeesite5/blob/v5.springboot3/web-ai/web-mcp/) + +```yml +spring: + ai: + mcp: + server: + enabled: true + sse-endpoint: /api/v1/sse + sse-message-endpoint: /api/v1/mcp +``` +MCP SSE 接口地址:http://127.0.0.1:8981/api/v1/sse + +* 客户端:[web-cms](https://gitee.com/thinkgem/jeesite5/blob/v5.springboot3/web-ai/web-cms/) + +```yml +spring: + ai: + model: + chat: ollama + mcp: + client: + enabled: true + sse: + connections: + jeesite: + url: http://127.0.0.1:8981 + sse-endpoint: /api/v1/sse +``` +聊天窗口,询问“当前服务器时间”,在 MCP 服务端会显示调用日志,并返回相应信息。 ## 支持结构化输出