Java 开发者们，是时候用熟悉的编程语言拥抱AI了！JManus 是一个完全基于 Java 的开源 AI 智能体框架，它让开发和部署多智能体协作系统变得前所未有的简单。本文将从核心功能到运行体验，带你一步步上手。
一、JManus 核心功能一览
JManus 继承了 OpenManus 的精髓，并与 Spring AI Alibaba 深度整合，具备以下四大核心特性：
- 完美实现 OpenManus 多 Agent 框架
借助 Spring AI 和 Java 的结合，你可以轻松构建、管理多个智能体，实现复杂任务的分工与协作，整个过程高效可控。 - 支持通过网页界面配置 Agent
无需修改底层代码，在直观的 Web 管理界面上即可灵活调整 Agent 的参数、模型和工具，大幅提升运维效率。 - 无缝支持 MCP（Model Context Protocol）协议
Agent 不仅能调用本地或云端的大语言模型，还能与外部服务、API、数据库等深度交互，极大拓展应用场景。 - 原生支持 PLAN-ACT 模式
让 Agent 具备复杂推理、分步执行和动态调整能力，适用于多轮对话、复杂决策、自动化流程等高级场景。
提示： 这四个特性共同构成了 JManus 的基石，无论是新手还是老手，都能快速上手搭建智能体系统。
二、快速运行指南
在开始之前，请确保你的开发环境满足以下条件。
1. 准备环境
- 下载软件源码
访问项目地址：https://github.com/alibaba/spring-ai-alibaba/tree/main/spring-ai-alibaba-jmanus，下载或克隆 spring-ai-alibaba-jmanus 模块源码。
git clone https://github.com/alibaba/spring-ai-alibaba
cd spring-ai-alibaba/spring-ai-alibaba-jmanus
- 确保安装了 JDK 17 或更新版本
可通过命令java -version检查本机 JDK 版本。 - 重要： 设置 DashScope API Key
在终端中执行以下命令，配置 API Key（请将 xxxx 替换为你的实际密钥）：
export AI_DASHSCOPE_API_KEY=xxxx
提示： API Key 可以通过阿里云 DashScope 控制台获取。请确保它已正确设置，否则 Agent 将无法调用大语言模型。
2. 运行项目
- 使用 IDE 运行
将spring-ai-alibaba-jmanus作为独立项目导入到你喜欢的 IDE（如 IntelliJ IDEA）中。找到OpenManusSpringBootApplication类，右键点击并选择 “运行”。
- 使用 Maven 运行
直接在项目根目录下执行：
mvn spring-boot:run
提示： 推荐使用 IDE 运行，便于调试和查看日志。如果使用 Maven，请确保已配置好 Maven 环境。
三、快速体验效果
程序启动成功后，会自动打开一个本地 http 页面。在页面下方的输入框中输入：
“通过百度查询阿里巴巴最新股价，将结果保存到用户目录本地文件”
点击“发送”，即可体验多智能体协作带来的智能问答与工具调用能力。
常见问题：
- Q：页面没有自动打开？ A：请检查控制台日志，通常会在最后一行打印类似
localhost:8080的地址，手动在浏览器中打开即可。 - Q：输入指令后没有反应？ A：首先确认 API Key 是否正确设置，其次检查网络是否能够访问 DashScope 服务。可以查看控制台错误日志定位问题。
- Q：如何在非本地环境运行？ A：JManus 是一个标准的 Spring Boot 应用，可以打包成 jar 后部署到服务器上运行，但需确保服务器能访问外部互联网（用于调用大模型）。
四、Plan-Act 深度功能体验
Plan-Act 模式是 JManus 的杀手锏，它让 Agent 具备分步规划与动态调整的能力。请按以下步骤操作：
- 点击输入框旁边的 “计划模式” 按钮。
- 在“需求输入”位置输入：
通过百度查询阿里巴巴最新股价，将结果保存到用户目录本地文件 - 选择 “生成计划”，此时会看到详细的执行计划。
- （可选玩法）将计划中的
阿里巴巴都改成$companyName，然后在“附加额外参数”部分增加配置$companyName=百度。 - 最后点击 “执行计划” 运行任务。
提示： 该模式特别适合需要多步推理或依赖外部数据的任务，例如股票查询、天气查询、文件操作等复杂场景。
常见问题：
- Q：修改参数后计划不会变？ A：修改参数后，需要重新点击“生成计划”才能生成基于新参数的计划，或直接点击“执行计划”让 Agent 在运行时动态替换。
- Q：执行计划时卡住了？ A：可能因为网络超时或 API 调用过慢。可以适当增加超时配置（在 application.yml 或环境变量中调整）。
总结
至此，你已经完成了 JManus 的初次体验！从多 Agent 协作到 PLAN-ACT 深度模式，这个框架为 Java 开发者打开了一扇通往 AI 智能体的便捷之门。赶快去 GitHub 上 star 项目，动手尝试更多有趣的场景吧！