# 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 2.1.0-SNAPSHOT cn.iocoder.agentscope agentscope-bom ${yudao-agentscope.version} pom import cn.iocoder.agentscope agentscope-spring-boot-starter ``` 只使用 Java 核心 API 时,可将 starter 换为同 groupId 的 `agentscope-core`;Java 导入仍为 `io.agentscope.*`。模型扩展按实际需要单独引入,不能将核心和基础 starter 的验证结果理解为全部扩展兼容。 Boot 2.7/JDK 8 分支的支持模块、构建与 HTTP 依赖配置见 [Java 8 使用说明](https://github.com/yudaocode/yudao-agentscope-java/blob/main-jdk8/JAVA8-COMPATIBILITY.md)。 独立沙箱 SDK 通过 `cn.iocoder.agentscope:agentscope-runtime-sandbox-core` 按需引入,版本由 AgentScope BOM 管理。Boot 2 使用 `2.1.0-jdk8-SNAPSHOT`,Boot 3/4 共用 `2.1.0-SNAPSHOT`;不需要引入整个 AgentScope core。使用兼容 SandboxService 管理服务,或配置本机 Docker 与所需沙箱镜像。源码来源、构建、请求超时及资源关闭说明见 [Runtime sandbox 使用说明](agentscope-runtime-sandbox-core/README_zh.md)。外部平台与具体工具服务需按实际环境配置,不能将本地兼容测试理解为所有外部后端均已验收。 下方逐字保留官方项目原始 README,其中的官方 Maven 坐标和发布状态仅针对上游项目;使用本兼容版时,以本节坐标、版本线和支持范围为准。 ---

AgentScope Logo

[**English Homepage**](https://github.com/agentscope-ai/agentscope-java/blob/main/README.md) | [**日本語ホームページ**](https://github.com/agentscope-ai/agentscope-java/blob/main/README_ja.md) | [**文档**](https://java.agentscope.io/dev/zh/intro.html)

discord docs Maven Central JDK 17+ license Ask DeepWiki

## 什么是 AgentScope Java 2.0? AgentScope Java 2.0 是面向企业级、分布式、生产环境的智能体框架,提供与模型能力相匹配的核心 Harness 抽象,可支持长期、稳定、安全可控的智能体任务执行。 - [**事件系统** →](https://java.agentscope.io/dev/zh/docs/building-blocks/message-and-event.html) 统一的事件流,32 种类型化事件,服务于前端实时渲染与 human-in-the-loop。 - [**权限系统** →](https://java.agentscope.io/dev/zh/docs/building-blocks/permission-system.html) 工具调用决策机制:允许 / 用户审批 / 拒绝。 - [**Middleware** →](https://java.agentscope.io/dev/zh/docs/building-blocks/middleware.html) 基于 AOP 模式的 hook 事件拦截机制,灵活扩展推理-行动循环。 - [**Workspace 与沙箱** →](https://java.agentscope.io/dev/zh/docs/harness/workspace.html) 在隔离环境中执行工具 —— 本地、Docker、Kubernetes 或 AgentRun 云沙箱。 - [**多智能体编排** →](https://java.agentscope.io/dev/zh/docs/harness/subagent.html) 多种子智能体定义模式,`agent_spawn` / `agent_send` + 事件流实时转发。 - [**分布式部署** →](https://java.agentscope.io/dev/zh/docs/others/going-to-production.html) 真正的分布式 session 与 memory 管理(Redis / MySQL / PostgreSQL / OSS / COS),跨副本 session 恢复。 - [**智能体进化** →](https://help.aliyun.com/zh/document_detail/3042583.html) 提供 Agent 全栈观测与审计、Agent 评估与实验、Agent 资产管理与持续优化等能力。 agentscope ## 新闻 - **[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 io.agentscope agentscope-harness 2.0.3 ``` 2.0 中模型提供商已拆分为独立扩展模块,需额外引入所需的模型依赖。例如使用 DashScope: ```xml io.agentscope agentscope-extensions-model-dashscope 2.0.3 ``` 其他可选:`agentscope-extensions-model-openai`、`agentscope-extensions-model-anthropic`、`agentscope-extensions-model-gemini`、`agentscope-extensions-model-ollama`。详见[模型文档](https://java.agentscope.io/dev/zh/docs/building-blocks/model.html)。 文本和图片的类型化分类可使用 [OpenAI Decisions](docs/v2/zh/integration/judge/openai-decisions.md),需要包含该扩展的 `2.1.0-SNAPSHOT` 构建。 如果希望直接使用 `ReActAgent` 的推理和工具 API、自行组合工程能力,可依赖 `agentscope-core` 和所需模型扩展。 ## Hello AgentScope! 推荐在应用启动时定义共享 Builder,每次请求用 `builder.build()` 创建新 Agent,执行结束后关闭。新实例通过相同的身份和持久化配置延续会话。运行前设置 `DASHSCOPE_API_KEY`: ```java import io.agentscope.core.agent.RuntimeContext; import io.agentscope.core.event.TextBlockDeltaEvent; import io.agentscope.core.event.ToolCallStartEvent; import io.agentscope.core.message.UserMessage; import io.agentscope.harness.agent.HarnessAgent; import java.nio.file.Paths; public class FirstAgent { // 应用启动时配置共享 Builder;请求期间只调用 build()。 private static final HarnessAgent.Builder AGENT_BUILDER = HarnessAgent.builder() .name("assistant") .agentId("assistant") .sysPrompt("你是一个有用的 AI 助手。") .model("dashscope:qwen-plus") .workspace(Paths.get(".agentscope/workspace")); public static void main(String[] args) { try (HarnessAgent agent = AGENT_BUILDER.build()) { RuntimeContext ctx = RuntimeContext.builder() .sessionId("demo").userId("alice").build(); agent.call(new UserMessage("你好!"), ctx).block(); } // COMMENT_帮我把今天的关键点列三条。 try (HarnessAgent agent = AGENT_BUILDER.build()) { RuntimeContext ctx = RuntimeContext.builder() .sessionId("demo").userId("alice").build(); agent.streamEvents(new UserMessage("帮我把今天的关键点列三条。"), ctx) .doOnNext(event -> { switch (event.getType()) { case TEXT_BLOCK_DELTA -> System.out.print( ((TextBlockDeltaEvent) event).getDelta()); case TOOL_CALL_START -> System.out.println( "\n[tool] " + ((ToolCallStartEvent) event).getToolCallName()); default -> { } } }) .blockLast(); } } } ``` 普通问答、多轮对话和工作流节点从 `call` / `streamEvents` 开始,详见[快速开始](https://java.agentscope.io/dev/zh/docs/quickstart)。两者默认也会记录 Harness 会话历史。需要关闭页面后继续执行、任务排队或中断后续做时,再引入 [AgentSession](https://java.agentscope.io/dev/zh/docs/harness/session-log);[可恢复聊天示例](./agentscope-examples/agents/agentscope-chat/README_zh.md)提供完整接入流程。 ## 核心设计 AgentScope Java 2.0 从"构建一个智能体"的工具箱,迈向**面向生产环境运行智能体**的完整平台。升级围绕三大主题展开: ### 1 · Harness 工程化 —— 长期运行、复杂任务的工程底座 裸的 ReAct 循环只解决"一次推理"。**HarnessAgent** 在 ReActAgent 之上通过 Middleware 与 Toolkit 叠加工程基础设施,核心推理循环原样保留,能力按需叠加: - **自进化与技能仓库** —— 成功模式自动沉淀为 Markdown 技能,跨会话共享、按需加载 - **分层记忆** —— 上下文对话 + agent 自维护的 `MEMORY.md` + 磁盘事实流水账,自动压缩控制 prompt 体量 - **子智能体** —— Markdown 声明子 agent 规格,`agent_spawn` / `agent_send` 按需启动,同步与后台委派两种模式 - **上下文自动管理** —— 结构化压缩保留目标 / 状态 / 关键发现 / 下一步;超大工具结果落盘只留占位符 - **Plan Mode** —— 只读规划态编排长任务,计划文件持久化并驱动执行 ### 2 · 企业级分布式部署 生产环境的智能体要服务多租户、安全执行不可信代码、滚动发布不丢上下文。AgentScope 2.0 天然面向无状态水平扩展: - **多租户隔离** —— `session` / `user` / `agent` / `org` 多维度状态隔离,`RuntimeContext` 键贯穿工作区、KV 命名空间、沙箱状态槽 - **安全沙箱** —— 本地子进程 / Docker / Kubernetes / E2B 云沙箱任选,支持快照恢复 - **权限管控** —— 三态决策(允许 / 审批 / 拒绝),敏感操作强制 HITL 审批 - **会话恢复** —— `AgentStateStore`(内存 / JSON 文件 / MySQL / Redis / PostgreSQL)支撑零停机滚动发布 ### 3 · 底层框架升级 —— 更轻、更顺手的核心抽象 消息、事件、扩展机制更小、更正交;HITL 与事件流式是框架运行的一部分,不是外挂层: - **事件流** —— 32 种类型化事件,模型调用、文本增量、工具执行、用户确认全部实时流出 - **消息模型** —— 文本 / 文件 / 图片 / 音视频 / 工具结果统一收敛到 `ContentBlock`,按 role 严格校验 - **Middleware** —— `onAgent` / `onReasoning` / `onActing` / `onModelCall` / `onSystemPrompt` / `onAgentStateReady` 六阶段取代 v1 扁平 hook - **HITL 一等公民** —— 确认工具参数、审批敏感操作、交给外部系统执行,智能体在暂停点精确恢复 完整架构概览请参阅[文档](https://java.agentscope.io/dev/zh/docs/index.html)。 ## 贡献 我们欢迎社区的贡献!请参阅 [CONTRIBUTING_zh.md](./CONTRIBUTING_zh.md) 了解详情。 ## 许可 AgentScope 基于 Apache License 2.0 发布。 ## 贡献者 感谢所有贡献者: