agentscope-ai /agentscope-java
Build distributed, production-grade, long-running agents.
★ 6,374⑂ 1,612👁 45⑃ 2,529● 1,628▤ 30
+7
日增长
6,374
stars
1,612
forks
45
watchers
2,529
prs
1,628
issues
30
releases
README
English Homepage | 日本語ホームページ | 文档
什么是 AgentScope Java 2.0?
AgentScope Java 2.0 是面向企业级、分布式、生产环境的智能体框架,提供与模型能力相匹配的核心 Harness 抽象,可支持长期、稳定、安全可控的智能体任务执行。
- 事件系统 → 统一的事件流,32 种类型化事件,服务于前端实时渲染与 human-in-the-loop。
- 权限系统 → 工具调用决策机制:允许 / 用户审批 / 拒绝。
- Middleware → 基于 AOP 模式的 hook 事件拦截机制,灵活扩展推理-行动循环。
- Workspace 与沙箱 → 在隔离环境中执行工具 —— 本地、Docker、Kubernetes 或 AgentRun 云沙箱。
- 多智能体编排 → 多种子智能体定义模式,agent_spawn / agent_send + 事件流实时转发。
- 分布式部署 → 真正的分布式 session 与 memory 管理(Redis / MySQL / PostgreSQL / OSS / COS),跨副本 session 恢复。
- 智能体进化 → 提供 Agent 全栈观测与审计、Agent 评估与实验、Agent 资产管理与持续优化等能力。
新闻
- [2026-07] v2.0.0 GA: 首个正式版本发布!双层 Agent 架构、事件流、权限系统、Middleware、Workspace 沙箱、多智能体编排、分布式部署全面就绪。 文档 | Release Notes
- [2026-07] v2.0.0-RC5: 模型提供商模块化拆分;统一 DataBlock 多模态支持;原生结构化输出;Channel IM 平台接入;腾讯云 COS 状态持久化。 Release Notes
- [2026-06] v2.0.0-RC4: 异步工具执行与定时唤醒调度;子 agent 跨副本路由与 session 恢复。 Release Notes
- [2026-06] v2.0.0-RC3: call() / streamEvents() 共享执行核心;AgentResultEvent、CustomEvent、HintBlockEvent 新事件类型。 Release Notes
- [2026-06] v2.0.0-RC2: Agent 完全无状态改造;DistributedBackend 一键配置;子 agent 事件流转发;Channel 模块(钉钉、飞书、企业微信);A2A / AG-UI 协议支持。 Release Notes
- [2026-05] v2.0.0-RC1: 首个 2.0 RC 版本,包含 Harness 工程化、企业级分布式部署、事件流 / 消息模型 / Middleware / HITL 全面重构。 Release Notes
- [2026-05] v1.1.0: 引入 agentscope-harness 与 HarnessAgent;Workspace 工作区(人格 / 记忆 / 技能 / 子 agent);可插拔文件系统(本地 / 共享存储 / 沙箱);Session 持久化与跨进程恢复;分层记忆与上下文压缩;声明式子 agent 编排。 Release Notes
社区
欢迎加入我们的社区
| Discord | 钉钉 | 微信 |
|--------------------------------------------------------------|-----------------------------------------------------------------------|--------------------------------------------------------------|
| | | |
快速开始
安装
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。详见模型文档。
文本和图片的类型化分类可使用 OpenAI Decisions,需要包含该扩展的 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_BTop issues
#2338Wanted: Who's using AgentScope 用户案例征集17 comments · 2026-07-21#1535历史对话消息页面如何加载渲染,ag-ui的实现里并没有MESSAGES_SNAPSHOT事件类型15 comments · 2026-05-30#1875MCP 动态注入12 comments · 2026-06-23#3178[Bug]: Declared/general-purpose subagents never inherit MCP tools (inherited toolkit captured from b.toolkit before MCP registration)9 comments · 2026-09-17#1797为什么模型会返回DSML9 comments · 2026-06-17#1619[Bug]:同一个HarnessAgent,不同的sessionId,不同的userId,上下文能互相访问到9 comments · 2026-06-05#918[Bug]:agentscope agent as tools模式下流式场景报错:Cannot add messages without tool results when pending tool calls exist.9 comments · 2026-03-11#2821开启长期记忆后,每次对话完成,会同步卡在那里等待,能不能做成异步的8 comments · 2026-08-24
Discussions
#4044关于 2.1.x 中的 HarnessAgent 事件仅存单kv 表的问题。2 comments · 2026-11-07#3706[Bug] Service 2.1.0-BETA1: Chat remains empty despite successful model response0 comments · 2026-10-21#3698agentscope-java realtime0 comments · 2026-10-21#3605Declarative Extension (Middleware/Hook) Mounting for Managed Agents0 comments · 2026-10-16#3530历史对话消息存储问题1 comments · 2026-10-13#3523基于仓库的doc生成了一个更易读的学习文档0 comments · 2026-10-12#3522如何工具运行在workspace之外的路径 (指定项目路径)1 comments · 2026-10-12#3478内置 ShellExecuteTool 没有规则配置 只能自定义tool吗1 comments · 2026-10-10
Latest release
v2.0.5 v2.0.5 2026-11-14AgentScope Java 2.0.5 is a maintenance release that backports fixes from the main branch to 2.0.x. It hardens state persistence and cancellation, tool-call argument handling, context compaction, memory durability, skills, and sandboxes, and updates the default Anthropic and Gemini models. There are no new modules and no removed public APIs. Behavior changes and upgrade notes - Default model changes. AnthropicChatModel.builder() now defaults to claude-sonnet-5-5, and GeminiChatModel.builder() defaults to gemini-3.8-flash. Set modelName(...) explicitly to keep model selection, behavior, a