Solon-AI 技术文档：Java AI 应用开发框架指南

Solon-AI 技术文档：Java AI 应用开发框架指南

【免费下载链接】solon-ai Java AI & MCP 应用开发框架（LLM，Function Call，RAG，Embedding，Reranking，Flow，MCP Server，Mcp Client，Mcp Proxy）。同时兼容 java8 ~ java24。也可嵌入到 SpringBoot2、jFinal、Vert.x 等框架中使用。 项目地址: https://gitcode.com/opensolon/solon-ai

1. 安装指南

环境要求

• JDK 版本：8/11/17/21/24
• 构建工具：Maven 或 Gradle

Maven 安装

在项目的 pom.xml 中添加依赖：

<dependency>
    <groupId>org.noear</groupId>
    <artifactId>solon-ai</artifactId>
    <version>[最新版本号]</version>
</dependency>

Gradle 安装

在 build.gradle 中添加依赖：

implementation 'org.noear:solon-ai:[最新版本号]'

2. 项目使用说明

核心功能概述

Solon-AI 提供以下核心能力：

• 多模型对话接口（ChatModel）
• 函数调用（Function Calling）
• 多媒体感知（Vision）
• 检索增强生成（RAG）
• AI 流程编排（Ai Flow）
• MCP 服务端/客户端支持

快速开始示例

// 初始化聊天模型
ChatModel chatModel = ChatModel.of("http://127.0.0.1:11434/api/chat")
                .provider("ollama")
                .model("qwen2.5:1.5b")
                .build();

// 同步调用
String response = chatModel.prompt("你好").call().getMessage();
System.out.println(response);

3. 项目API使用文档

3.1 ChatModel API

// 同步调用
ChatResponse response = chatModel.prompt("问题内容").call();

// 流式调用
chatModel.prompt("问题内容").stream().subscribe(res -> {
    System.out.println(res.getMessage());
});

// 带工具调用
chatModel.prompt("今天杭州天气？")
    .options(op->op.toolsAdd(new FunctionTools()))
    .call();

3.2 RAG API

// 构建知识库
EmbeddingModel embeddingModel = EmbeddingModel.of(apiUrl)
                .apiKey(apiKey)
                .provider(provider)
                .model(model)
                .build();

InMemoryRepository repository = new InMemoryRepository(embeddingModel);
repository.insert(new PdfLoader(pdfUri).load());

// 检索文档
List<Document> docs = repository.search(query);

// 提示语增强
ChatMessage message = ChatMessage.augment(query, docs);

3.3 MCP Server API

@McpServerEndpoint(name="mcp-server", sseEndpoint = "/api/sse") 
public class McpService {
    @ToolMapping(description = "查询天气")
    public String getWeather(@Param(description = "城市") String location) {
        return "晴，25℃";
    }
}

3.4 MCP Client API

McpClientToolProvider client = McpClientToolProvider.builder()
                .apiUrl("http://localhost:8080/api/sse")
                .build();

String weather = client.callToolAsText("getWeather", 
                Map.of("location", "北京")).getContent();

4. 项目安装方式

4.1 独立安装

1. 克隆项目仓库：

git clone https://github.com/opensolon/solon-ai.git

2. 构建项目：

mvn clean install

4.2 嵌入其他框架

Solon-AI 可嵌入到 SpringBoot、jFinal、Vert.x 等框架中使用：

1. 添加依赖（如前述 Maven/Gradle 配置）
2. 按照标准方式初始化组件

4.3 Docker 部署（示例）

FROM openjdk:17
COPY target/solon-ai-demo.jar /app.jar
EXPOSE 8080
ENTRYPOINT ["java","-jar","/app.jar"]

---

本文档详细介绍了 Solon-AI 框架的安装、使用和 API 参考，帮助开发者快速构建 Java AI 应用。如需更高级功能，请参考项目示例代码库。

【免费下载链接】solon-ai Java AI & MCP 应用开发框架（LLM，Function Call，RAG，Embedding，Reranking，Flow，MCP Server，Mcp Client，Mcp Proxy）。同时兼容 java8 ~ java24。也可嵌入到 SpringBoot2、jFinal、Vert.x 等框架中使用。 项目地址: https://gitcode.com/opensolon/solon-ai