Erupt AI 大模型深度集成

与当下流行的大模型深度集成，低代码开发大模型应用。

全面拥抱 Harness Engineering

能力	说明
LLM	支持：ChatGPT、Claude、Gemini、Ollama、Qwen、Doubao、GLM、DeepSeek、Moonshot、MinMax、Mistral、Grok、Fireworks、Together、OpenRouter 等
Chat	会话管理（AiChat）、消息历史（AiChatMessage）、SSE 流式输出、可配置上下文轮次（maxContext）
Agent	自定义可视化控制 Prompt、可动态控制 Agent 提示词
Tools	通过 @AiToolbox + @Tool 注册工具并在对话中调用；EruptAiToolbox 提供基础模型列表、Schema、当前用户、HQL 查询、模块列表等能力
MCP	支持挂载外部 MCP Server，灵活扩展工具能力
MCP Server	内置 MCP Server，Bearer 鉴权，支持 Cursor / Claude 等客户端直连
Security	内置严格的接口权限控制，AI 聊天能力可以通过用户权限动态授予

使用方法

1. 添加依赖：

<dependency>
    <groupId>xyz.erupt</groupId>
    <artifactId>erupt-ai</artifactId>
    <version>${erupt.version}</version>
</dependency>

2. 可配置项：

erupt:
  ai:
    # 定义全局系统提示词
    system-prompt: |
      你是 Erupt AI，你更擅长中文和英文的对话。你会为用户提供安全，有帮助，准确的回答。
      同时，你会拒绝一切涉及恐怖主义，种族歧视，黄色暴力等问题的回答。
      Erupt AI 为专有名词，不可翻译成其他语言。
    # SSE 超时时间
    sse-timeout: 300000
    # 打字配置
    message-chunk-size: 20
    message-delay: 30

3. 启动后会增加如下菜单：

4. 交互式对话：

大模型接入 LLM

增加对应的大模型，对应的 key 到大模型官网中申请即可。

点击对应图标测试大模型会话：

交互式 AI 对话

TIP

与大模型自然对话，所见即所得——代码高亮、Mermaid 图表、数学公式实时渲染，支持工具自动调用与智能体编排，让每一次交互都触达 AI 的真实能力边界。

智能体管理 Agent

输入对应提示词后保存即可

创建后可在 AI 对话中智能体列表中看到

提示词动态处理器，实现 EruptPromptHandler 接口，在界面中选择即可

@Component
public class TestPromptHandler implements EruptPromptHandler {
    @Override
    public String name() {
        return "提示词处理器";
    }

    @Override
    public String handle(String prompt) {
        return prompt + "，你是一个测试提示词处理器";
    }
}

工具扩展 Tools

INFO

通过 @AiToolbox + @Tool 将任意 Spring Bean 方法注册为 AI 工具，AI 在对话中可自动识别意图并调用，实现与当前系统的深度交互——查数据、触发业务、执行操作，一句话即可完成。

1.14.1 以下版本，详见： https://www.yuque.com/erupts/1.13.x/qsk71q5zyy3segr6_gxxnld#jA3q1

1.14.1 及以上版本：

import dev.langchain4j.agent.tool.P;
import dev.langchain4j.agent.tool.Tool;
import xyz.erupt.ai.annotation.AiToolbox;

/**
 * 1. 添加类注解 @AiToolbox
 * 2. 需要暴漏的方法增加 @Tool 注解即可，参数可使用 @P 注解
 **/
@AiToolbox
@Component
public class TestTools {

    @Tool("快捷使用shell open命令，当用户输入网址或者文件路径时帮助用户快捷打开")
    public String call(@P("路径信息") String uri) {
        Runtime runtime = Runtime.getRuntime();
        try {
            runtime.exec("open " + uri);
            return "已打开: " + uri;
        } catch (IOException e) {
            throw new RuntimeException(e);
        }
    }

    @Tool("当前系统硬件信息")
    public String systemInfo() {
        try {
            Process process = Runtime.getRuntime().exec("system_profiler SPHardwareDataType");
            return String.join("\n",
                    new BufferedReader(new InputStreamReader(process.getInputStream()))
                            .lines().collect(Collectors.toList()));
        } catch (IOException e) {
            throw new RuntimeException(e);
        }
    }

}

挂载外部 MCP

INFO

接入任何外部的 MCP，支持完整的 MCP 协议，可在 erupt 平台内操作任意 MCP，如控制浏览器、操作桌面文件等。

调用示例：操控 Google 浏览器，并且与当前系统 Tool 配合使用：

对外提供 MCP 服务

TIP

将系统的 AI Tools 对外暴露，提供其他工具的调用，例如：Cursor、Claude Code 等

1. 在 application.yml 中开启 MCP 配置：

erupt:
  ai:
    mcp:
      server-enabled: true

2. 在 Claude Code / Cursor / VS Code 中增加 MCP 配置：

{
  "mcpServers": {
    "erupt": {
      "type": "sse",
      "url": "http://localhost:9999/mcp",
      "headers": {
        "Authorization": "Bearer {{your secret}}"
      }
    }
  }
}

Authorization 可进入 Open API 菜单生成，值对应"秘钥"列，请注意妥善保管切勿泄露。

3. 连接成功：

4. Cursor 交互效果演示：

动态系统提示词 System Prompt

TIP

支持动态扩展系统提示词，在用户发起提问时按需注入，精准控制 Token 消耗，同时提升回答的相关性与准确性。

1. 实现 SystemPromptProvider 接口
2. 注册 registerProvider
3. 实现 getPrompt 方法体

@Component
public class CubeAiTools implements SystemPromptProvider {

    @PostConstruct
    public void init() {
        SystemPromptProvider.registerProvider(this);
    }

    @Override
    public String getPrompt() {
        return """
                ## Chart Rendering
                When the user requests a chart or visualization, output ONLY a valid ECharts option JSON in the fenced block below — no other code or prose:
                ```echarts
                { ...option json... }
                ```
                - Map dimensions → xAxis.data / series name field; measures → series[].data values
                - Choose chart type by data shape: bar/line for category+metric, pie for proportion, line for time trend, grouped bar/multi-line for multiple measures
                - Inline actual query result data into the option — do not reference variables
                - Always include: title.text, tooltip, legend (if multiple series), and appropriate axis labels
                """;
    }

}

驱动 Erupt Claw 🦞

🦞 Erupt AI Claw