背景与定位

JManus 是阿里巴巴基于 Spring AI Alibaba 生态构建的智能体开发平台。它的诞生源于对通用 AI Agent 的探索与企业级场景需求的深度结合。在最初的设计中，JManus 被定位为 OpenManus 的 Java 语言复刻实现，旨在提供一个开源、可扩展的通用 AI Agent 解决方案。随着对智能体技术的深入研究，团队发现完全依赖自动规划的通用智能体在解决确定性企业场景时存在局限性。因此，JManus 的定位逐渐从“产品”转向“平台”，致力于协助开发者以低成本、高效率的方式构建垂直领域的智能体系统。

核心特性

1.Java 语言为核心，深度集成 Spring AI Alibaba

JManus 基于 Spring AI Alibaba（GitHub 仓库）实现，充分利用了 Spring Boot 的生态优势。开发者可以借助 Spring 的依赖注入、配置管理、微服务集成等能力，快速构建智能体应用。其核心模块 spring-ai-alibaba-jmanus 提供了智能体框架的基础能力，包括任务规划、工具调用、状态管理等。

2.从通用智能体到开发平台的演进

• 第一阶段（通用 AI Agent）
  初期的 JManus 模仿 OpenManus 的设计，专注于自动规划与执行复杂任务。例如，通过自然语言解析用户指令，动态调用工具（如数据库查询、API 接口），并生成结果。这种方式适用于开放性问题，如日常办公自动化、跨平台信息整合等。
• 第二阶段（企业级开发平台）
  随着实践发现，企业场景往往需要 确定性更强的流程 和 定制化工具。JManus 通过引入子 Agent、流程编排、工具链扩展等能力，支持开发者构建符合业务逻辑的智能体系统。例如，企业可以定义固定的工作流（如审批流程），并通过子 Agent 调用内部系统（如 ERP、CRM）完成任务。

3.直观的 UI 交互界面

JManus 提供了前端 UI 界面，用户可通过可视化方式配置智能体的行为。例如，拖拽式流程编排、工具参数设置、日志监控等功能，降低了非技术人员的使用门槛。

技术架构与核心模块

JManus 的架构分为以下几个核心模块：

典型使用场景

1.通用智能体场景

• 自动化办公：解析用户指令（如“生成月度报告”），自动调用数据源、生成文档并发送邮件。
• 跨平台操作：通过指令控制多个系统（如“将 GitHub 仓库代码部署到 Kubernetes 集群”）。

2.企业级定制化场景

• 业务流程自动化：例如，采购审批流程中，JManus 可作为“审批 Agent”，根据规则自动触发审批步骤，并通知相关人员。
• 数据治理：通过子 Agent 定期校验数据质量，生成报告并触发修复流程。

安装部署

方式一：使用 Docker (推荐)：

使用 Docker Hub 镜像

# 拉取最新的 develop 镜像
docker pull springaialibaba/jmanus:develop

# 基础启动（临时数据存储）
docker run -d 
  --name jmanus 
  -p 18080:18080 
  -e DASHSCOPE_API_KEY=your_api_key_here 
  springaialibaba/jmanus:develop

# 或者启动并持久化数据（推荐）
docker run -d 
  --name jmanus 
  -p 18080:18080 
  -e DASHSCOPE_API_KEY=your_api_key_here 
  -v $(pwd)/h2-data:/app/extracted/h2-data 
  -v $(pwd)/extensions:/app/extracted/extensions 
  springaialibaba/jmanus:develop

使用阿里云镜像（中国加速)

# 拉取阿里云加速镜像
docker pull sca-registry.cn-hangzhou.cr.aliyuncs.com/spring-ai-alibaba/jmanus:develop

# 基础启动（临时数据存储）
docker run -d 
  --name jmanus 
  -p 18080:18080 
  -e DASHSCOPE_API_KEY=your_api_key_here 
  sca-registry.cn-hangzhou.cr.aliyuncs.com/spring-ai-alibaba/jmanus:develop

# 或者启动并持久化数据（推荐）
docker run -d 
  --name jmanus 
  -p 18080:18080 
  -e DASHSCOPE_API_KEY=your_api_key_here 
  -v $(pwd)/h2-data:/app/extracted/h2-data 
  -v $(pwd)/extensions:/app/extracted/extensions 
  sca-registry.cn-hangzhou.cr.aliyuncs.com/spring-ai-alibaba/jmanus:develop

如果您需要自定义配置或持久化数据：

# 创建数据目录
mkdir -p /path/to/jmanus/h2-data
mkdir -p /path/to/jmanus/extensions

# 使用自定义配置启动（推荐数据持久化）
docker run -d 
  --name jmanus 
  -p 18080:18080 
  -e DASHSCOPE_API_KEY=your_api_key_here 
  -v /path/to/jmanus/h2-data:/app/extracted/h2-data 
  -v /path/to/jmanus/extensions:/app/extracted/extensions 
  --restart unless-stopped 
  springaialibaba/jmanus:develop

• H2 数据库: /app/extracted/h2-data – 存储应用的数据库文件
• 运行时数据: /app/extracted/extensions – 存储扩展和运行时配置
• 提议挂载这两个目录以实现数据持久化，避免容器重启后数据丢失

方式二：从源码运行

1、克隆并导航

git clone https://github.com/alibaba/spring-ai-alibaba.git
cd spring-ai-alibaba/spring-ai-alibaba-jmanus

2、配置您的 API 密钥

# 设置您的 DashScope API 密钥
export DASHSCOPE_API_KEY=your_api_key_here

3、数据库配置（可选）

JManus 支持 H2（默认）、MySQL以及PostgreSQL数据库。

如何使用 MySQL/PostgreSQL

配置数据库连接： 在 src/main/resources/下的
application-mysql.yml/application-postgres.yml中更新数据库配置和jpa方言：

spring:
  datasource:
    url: your_url
    username: your_username
    password: your_password
  jpa:
    database-platform: org.hibernate.dialect.MySQLDialect/PostgreSQLDialect

激活 MySQL/PostgreSQL 配置： 在
src/main/resources/application.yml 中更新配置：

spring:
  ...
  profiles:
    active: mysql/postgres  

4、启动应用程序

对于类 Unix 系统 (macOS, Linux):

../mvnw spring-boot:run

对于 Windows 系统:

../mvnw.cmd spring-boot:run

系统访问

通过以上步骤部署后，可以通过在浏览器中访问 http://localhost:18080 即可使用 JManus

原生支持模型上下文协议（Model Context Protocol），实现与外部服务和工具的无缝集成。

通过直观的网页管理界面轻松配置 agent，无需修改代码。

准确控制每一步执行细节，提供极高的执行确定性

总结

JManus 从通用 AI Agent 到企业级开发平台的转型，体现了智能体技术从“研究探索”向“生产落地”的关键一步。通过结合 Spring AI Alibaba 的生态优势，JManus 为开发者提供了灵活、高效的智能体开发工具，助力企业在数字化转型中释放 AI 的潜力。随着技术的不断迭代，JManus 将继续在智能体领域深耕，成为企业智能化的重大基础设施。