openJiuwen Core Java 是 openJiuwen 面向 Java 生态的独立框架实现，是一款面向大模型应用的 Java 软件开发工具包，为运行在 openJiuwen 框架上的智能体提供高性能运行时。这款开发工具包不仅封装了 Agent 创建、工作流编排、大模型与工具调用等多层次、易上手的对外接口；还内置了支持异步 IO、流式处理的高性能运行时，实现智能体的状态保存和中断接续；更配备了全链路观测等一系列智能体调试调优工具。openJiuwen Core Java 开发工具包兼顾灵活性与稳定性，助力开发者高效构建稳定的大模型应用。
-
开箱即用的组件：提供丰富的预置组件，包括意图识别、提问器、大模型调用、工具组件等，大幅降低开发门槛。
-
高效精准的任务执行：内置高性能执行引擎，支持异步并行图执行、组件并发、流式处理等能力，确保Agent在执行任务时的高效性与精准性。
-
灵活可控的多工作流跳转能力：支持Agent在同一会话中管理多个工作流，支持用户在不同工作流间自由切换，由框架保障被打断工作流的断点接续。解决了用户在同一对话中切换不同任务场景的需求，提供了灵活的多任务管理能力。
-
丰富的存储支持：内置多种存储后端支持，包括向量数据库（Milvus、Chroma、PostgreSQL/pgvector）、键值存储、图数据库等，满足不同的数据持久化需求。
- 操作系统：兼容Windows、Linux、macOS。
- Java 版本：Java 21或更高版本。
- 构建工具：Maven 3.9+。
从源码构建
git clone <repository-url>
cd agent-core-java
mvn clean install -DskipTests然后将agent-core-java加入你的maven项目依赖
<dependency>
<groupId>com.openjiuwen</groupId>
<artifactId>agent-core-java</artifactId>
<version>0.1.7</version>
</dependency>让我们创建一个简单的WorkflowAgent，调用工作流处理金融场景业务： 将examples文件夹拷贝至你的maven工程的src/main目录，将examples内的apiconfig.json,apiconfig_example.json复制到工程的src/resources,即可运行样例代码
// 示例代码位于 examples/workflow_agent/WorkflowAgentExample.java
public class WorkflowAgentExample {
public static void main(String[] args) throws Exception {
WorkflowAgentExampleSupport.run(args);
}
}预期输出
assistant> 请补充转账金额，必须是数字或带货币单位的金额描述。
// 用户回复: 2000元
assistant> 转账服务完成，记录的转账金额为 2000元。
更多完整示例请查看examples/workflow_agent目录。
openJiuwen Core Java作为openJiuwen架构的核心引擎，核心能力包括：
-
SDK接口层：聚焦大模型应用的开发需求，为开发者提供Java SDK接口。接口能力覆盖Agent实例创建、工作流设计与编排、大模型调用及输出结果解析、提示词模板构建与动态填充，并支持本地工具调用外部服务。
-
Agent引擎：针对ReAct智能交互与工作流自动跳转两大场景，通过构建Agent控制器，支撑复杂任务规划、工具选择与调用、工作流任务切换。内置开箱即用的标准化组件，降低Agent的开发门槛。提供Agent运行时环境，同时配套对话历史上下文管理、基础工具集等底层能力。
-
高性能图执行引擎：基于Pregel模型的异步并行图执行器，支持组件并发执行、状态中断与恢复、流式数据传输。
openJiuwen Core Java内置了ReActAgent和WorkflowAgent两类预置智能体，功能丰富、开发灵活，可满足不同场景下的智能需求。
-
ReActAgent：遵循ReAct（Reasoning + Action）规划范式，以思考→行动→观察的循环迭代完成任务。凭借强大的多轮推理与自我修正能力，具备动态决策和环境适应特性，适用于需复杂推理、策略调整的多样化场景。
-
WorkflowAgent：专注多步骤任务导向的流程自动化，严格按照用户预定义流程高效执行复杂任务，也能够随着用户意图的变更灵活切换任务。其侧重于基于预设流程实现任务的规范化与高效化执行，适用于任务结构清晰、可拆解为多步骤的场景。
openJiuwen Core Java提供高性能执行引擎，支持分布式部署与低成本运行，可有效解决海量智能体执行效率低、运维成本高的痛点，为大规模智能体集群运转及行业级生产应用落地提供坚实支撑。
-
异步并行图执行器：具备组件并发执行、异步IO处理、结构化上下文管理能力，支持多工作流任务高效并行处理，实现异构组件的灵活调用。
-
组件基础能力：支持组件间流批一体传值、动态跳转、状态中断与恢复，同时提供组件动态配置与多实例管理功能。
-
数据存储与流式处理：提供流式输出、组件间流式传输等数据管控能力，可对接外部存储系统实现智能体上下文数据外置，助力分布式场景下的弹性扩展。
支持多种存储后端，满足不同的数据持久化需求：
- 向量存储：Milvus、Chroma、PostgreSQL/pgvector、内存向量存储
- 图存储：基于内存的图数据存储
- 键值存储：数据库-backed KV存储、内存KV存储
- 对象存储：本地对象存储客户端
agent-core-java/
├── src/main/java/com/openjiuwen/core/
│ ├── application/ # Agent应用层
│ │ ├── llm/ # LLM Agent
│ │ ├── workflow/ # Workflow Agent
│ │ └── schema/ # 配置Schema
│ ├── controller/ # Agent控制器
│ ├── foundation/ # 基础设施层
│ │ ├── llm/ # 大模型客户端
│ │ ├── tool/ # 工具系统
│ │ ├── store/ # 存储系统
│ │ └── prompt/ # 提示词模板
│ ├── graph/ # 图执行引擎
│ ├── memory/ # 记忆系统
│ ├── context/ # 上下文管理
│ ├── runner/ # 运行器
│ └── session/ # 会话管理
├── src/test/ # 测试代码
├── examples/ # 示例代码
└── documents/ # 文档
└── zh/ # 中文文档
└── SUMMARY.md # 开发指南与 API 文档导航
完整文档索引请参考 documents/zh/SUMMARY.md。
文档入口分为两层：
建议先从开发指南进入，再按问题查看对应栏目：
- 基础功能：模型接入、提示词模板和工具系统。
- 多智能体：group 组织、协作模式与 agent 能力暴露。
- 工作流：工作流图、组件体系与执行路径。
- 高阶用法：检索、记忆、上下文、Session、Runner、Skills 等能力。
- API文档：应用层、控制器、foundation、graph、memory、session、workflow 等包索引。
我们欢迎所有形式的贡献，包括但不限于:
- 提交问题和功能建议
- 改进文档
- 提交代码
- 分享使用经验
本项目依据Apache-2.0许可证授权。
本产品仅作为流程编排工具，不包含 AI 模型能力；用户在连接 AI 模型用于特定业务场景时，需自行承担欧盟 AI 法案等相关合规义务。