# yudao-agentscope-java
**Repository Path**: yudaocode/yudao-agentscope-java
## Basic Information
- **Project Name**: yudao-agentscope-java
- **Description**: AgentScope Java 兼容维护版:为 Spring Boot 2.x / JDK 8 回迁可用能力;main 面向 Java 17+,覆盖 Spring Boot 3.x / 4.x。保留官方 Java 包名,提供独立 Maven 坐标。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 2
- **Forks**: 0
- **Created**: 2026-11-16
- **Last Updated**: 2026-11-17
## Categories & Tags
**Categories**: Uncategorized
**Tags**: Java8, agentscope, SpringBoot, ai-agent, multi-agent
## README
> 版本命名:保留当前源码基线的官方版本号;共用现代制品不加 JDK 后缀,隔离维护的兼容路线添加 `jdk8` / `jdk17` / `jdk25`。SNAPSHOT 尚未发布 Maven Central。JDK 路线后缀不等于最低字节码版本,框架依赖仍按 Boot 版本选择。
> 完整版本规则与预览命名见 [VERSIONING.md](VERSIONING.md)。
# yudao-agentscope-java
yudao-agentscope-java 是 [AgentScope Java](https://github.com/agentscope-ai/agentscope-java) 的芋道社区兼容维护版本,并非官方发布。主要补充 **Spring Boot 2.x + JDK 8** 支持;`main` 以 JDK 17 为最低目标,由同一份核心和基础 starter 制品验证 Spring Boot 3.x、4.x 与 JDK 17、25,其他扩展仍需逐项验收。
## 仓库与版本线
| 平台 | 仓库地址 |
| --- | --- |
| Gitee | [yudao-agentscope-java](https://gitee.com/yudaocode/yudao-agentscope-java) |
| GitHub | [yudao-agentscope-java](https://github.com/yudaocode/yudao-agentscope-java) |
| 分支 | 目标环境 | 源码开发版本 | 发布规则 | 状态 |
| --- | --- | --- | --- | --- |
| [`main`](https://github.com/yudaocode/yudao-agentscope-java/tree/main) | Boot 3.x / 4.x,JDK 17 / 25 | `2.1.0-SNAPSHOT` | 官方版本 + 日期 | 核心和基础 starter 已完成同 jar 四组合验证,其他扩展验收中 |
| [`main-jdk8`](https://github.com/yudaocode/yudao-agentscope-java/tree/main-jdk8) | Boot 2.x,JDK 8 | `2.1.0-jdk8-SNAPSHOT` | 官方版本 + 路线 + 日期 | 核心、基础与 DashScope starter 已通过 Boot 2.7/JDK 8 验证,其他扩展移植中 |
AgentScope 的现代制品由 Boot 3/4 共用,版本不带 JDK 后缀。当前分支:**`main`**。
Maven groupId 为 **`cn.iocoder.agentscope`**,artifactId 和 Java 包名沿用官方。同一个应用只选择一条版本线,同一项目的模块使用同一版本;替换已有依赖时,也要移除对应官方 groupId 下的同类模块,避免重复类。
**当前仅提供源码开发版,尚未发布这些坐标到 Maven Central 或远端 SNAPSHOT 仓库。** 下面的 SNAPSHOT 示例须先从源码安装到本地仓库。发布版本按 `官方版本[-jdk数字][-preview]-YYYYMMDD` 命名;共用制品省略 JDK,未发布上游基线增加 preview,无同日序号。
## 如何使用
目前可先使用核心及基础 starter;在 JDK 17 下按当前分支构建必要模块:
```bash
git clone -b main https://github.com/yudaocode/yudao-agentscope-java.git
cd yudao-agentscope-java
mvn -pl agentscope-dependencies-bom,agentscope-distribution/agentscope-bom,agentscope-extensions/agentscope-spring-boot-starters/agentscope-spring-boot-starter -am -DskipTests -Dmaven.javadoc.skip=true install
```
在 Boot 3/4 宿主中引入 BOM 和基础 starter。基础 starter 提供配置与装配入口,模型 provider、凭据及 Agent 行为仍需按需配置:
```xml
## 新闻
- **[2026-07] `v2.0.0 GA`:** 首个正式版本发布!双层 Agent 架构、事件流、权限系统、Middleware、Workspace 沙箱、多智能体编排、分布式部署全面就绪。 [文档](https://java.agentscope.io/) | [Release Notes](https://github.com/agentscope-ai/agentscope-java/releases/tag/v2.0.0)
- **[2026-07] `v2.0.0-RC5`:** 模型提供商模块化拆分;统一 DataBlock 多模态支持;原生结构化输出;Channel IM 平台接入;腾讯云 COS 状态持久化。 [Release Notes](https://github.com/agentscope-ai/agentscope-java/releases/tag/v2.0.0-RC5)
- **[2026-06] `v2.0.0-RC4`:** 异步工具执行与定时唤醒调度;子 agent 跨副本路由与 session 恢复。 [Release Notes](https://github.com/agentscope-ai/agentscope-java/releases/tag/v2.0.0-RC4)
- **[2026-06] `v2.0.0-RC3`:** `call()` / `streamEvents()` 共享执行核心;`AgentResultEvent`、`CustomEvent`、`HintBlockEvent` 新事件类型。 [Release Notes](https://github.com/agentscope-ai/agentscope-java/releases/tag/v2.0.0-RC3)
- **[2026-06] `v2.0.0-RC2`:** Agent 完全无状态改造;DistributedBackend 一键配置;子 agent 事件流转发;Channel 模块(钉钉、飞书、企业微信);A2A / AG-UI 协议支持。 [Release Notes](https://github.com/agentscope-ai/agentscope-java/releases/tag/v2.0.0-RC2)
- **[2026-05] `v2.0.0-RC1`:** 首个 2.0 RC 版本,包含 Harness 工程化、企业级分布式部署、事件流 / 消息模型 / Middleware / HITL 全面重构。 [Release Notes](https://github.com/agentscope-ai/agentscope-java/releases/tag/v2.0.0-RC1)
- **[2026-05] `v1.1.0`:** 引入 `agentscope-harness` 与 `HarnessAgent`;Workspace 工作区(人格 / 记忆 / 技能 / 子 agent);可插拔文件系统(本地 / 共享存储 / 沙箱);Session 持久化与跨进程恢复;分层记忆与上下文压缩;声明式子 agent 编排。 [Release Notes](https://github.com/agentscope-ai/agentscope-java/releases/tag/v1.1.0-RC1)
## 社区
欢迎加入我们的社区
| [Discord](https://discord.gg/eYMpfnkG8h) | 钉钉 | 微信 |
|--------------------------------------------------------------|-----------------------------------------------------------------------|--------------------------------------------------------------|
|
|
|
|
## 快速开始
### 安装
> AgentScope Java 需要 **JDK 17** 及以上版本。
#### Maven
```xml