Skip to content

最易用的本地可部署开源智能体框架 JManus

JManus 是 Manus 的一个 Java 实现,目前已经在阿里巴巴集团内的很多应用都有使用。其主要有以下几个特性:

  1. 可以使用远程模型,如 qwen,也可以使用本地 ollama 模型
  2. 内置了丰富的 agent 和工具,也支持自己配置 agent/tool/mcp
  3. 极其易操作的界面,一用就会
  4. 使用 plan-act 多智能体模式,执行任务效果不错

软件安装

以 windows11 为例。官方给出了两种安装方式,第一种是 docker 模式,对于 windows 来讲,可以安装 wsl2 来进行操作;第二种是通过源码方式安装。此处介绍第二种。JManus 服务端使用 Java 实现,UI 界面使用 vue 实现,故在真正安装 JManus 之前,需要首先安装 JDK(版本必须 >=17) 和 NodeJS。

  1. 安装 JManus 框架包
shell
git clone https://github.com/alibaba/spring-ai-alibaba.git
cd spring-ai-alibaba/spring-ai-alibaba-jmanus
  1. 打开 pom.xml 文件,删除掉如下代码:
xml
<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-checkstyle-plugin</artifactId>
    <version>${maven-checkstyle-plugin.version}</version>
    <dependencies>
        <dependency>
            <groupId>com.puppycrawl.tools</groupId>
            <artifactId>checkstyle</artifactId>
            <version>${puppycrawl-tools-checkstyle.version}</version>
        </dependency>
    </dependencies>
    <configuration>
        <consoleOutput>true</consoleOutput>
        <configLocation>../tools/src/checkstyle/checkstyle.xml</configLocation>
        <headerLocation>../tools/src/checkstyle/checkstyle-header.txt</headerLocation>
        <includeTestSourceDirectory>true</includeTestSourceDirectory>
    </configuration>
    <executions>
        <execution>
            <id>validate</id>
            <phase>validate</phase>
            <goals>
                <goal>check</goal>
            </goals>
        </execution>
    </executions>
</plugin>

开始使用

shell
mvn spring-boot:run

之后会自动打开可视化界面如下:http://localhost:18080/ui/index.html#/init

首先配置语言,此处选择中文。 img.png

之后配置模型,如果使用百炼模型,可以直接在 https://bailian.console.aliyun.com/?tab=model#/api-key 申请一个免费额度的 ApiKey,仅配置该 ApiKey 即可;也可以设置本地 ollama 模型。此处使用百炼模型。 img_1.png

模型配置就绪之后,会进入欢迎页 img_2.png

在欢迎页可以直接预设的5个例子来尝鲜,也可以直接点击“直接进入工作台”,来进行后续操作,此处直接进入工作台。 img_3.png

好了,此时我们就给智能体发送消息了。我们输入“用浏览器基于百度,查询今天阿里巴巴的股价,并返回最新股价”。 img_5.png 可以看到,JManus 首先会将我们的问题设置执行步骤,这里一共是三步:

  1. [completed] [BROWSER_AGENT] 打开百度并搜索阿里巴巴股价信息
  2. [completed] [BROWSER_AGENT] 解析搜索结果页面,找到最新的阿里巴巴股价信息
  3. [completed] [DEFAULT_AGENT] 整理获取到的股价信息,并返回给用户

步骤的格式是固定的:[该步骤执行状态][该步骤需要使用的agent] 该步骤的描述,在 JManus 中,会有一个agent专门用于创建计划(设置执行步骤),每一步的执行都会有一个agent来完成,每个agent都可以配置自己的 prompt/tool/mcp/大模型 等

在我们点击某一个步骤时,可以详细的查看该步骤的执行明细,包括使用到的 prompt 和工具等 img_6.png

设置项

JManus 的设计很巧妙,提供了较多的设置项,我们打开设置页看下 img_4.png

设置项具体包含:

  1. 基础配置:支持浏览器配置(请求浏览器的超时时间/是否使用无头模式)/智能体的最大执行步数/memory最多记录多少条消息/MCP连接超时时间等
  2. Agent 配置:支持新增自定义的Agent,支持配置每个Agent的Prompt和其要使用的模型(例如,一个图像识别Agent需要使用一个多模态模型)和工具/MCP img_7.png
  3. Model 配置:支持新增模型,支持配置每个模型的模型参数,例如温度 img_8.png
  4. Tools/MCP 配置:支持新增 MCP, img_9.png
  5. Prompt 配置:支持提示语配置 img_10.png

文章的最后,如果您觉得本文对您有用,请打赏一杯咖啡!感谢!