agentscope-ai /agentscope-java
Build distributed, production-grade, long-running agents.
★ 6,374⑂ 1,612👁 45⑃ 2,529● 1,628▤ 30
More from this author
+7
Daily
6,374
stars
1,612
forks
45
watchers
2,529
prs
1,628
issues
30
releases
README
中文主页 | 日本語ホームページ | Documentation
What is AgentScope Java 2.0?
AgentScope Java 2.0 is a production-ready framework for building distributed, enterprise-grade agents, providing essential abstractions that work with rising model capability and built-in support for long-running, safely-controlled agent execution.
- Event System → A unified event stream with 32 typed events for real-time frontend rendering and human-in-the-loop.
- Permission System → Tool-call gating: allow / require user approval / deny.
- Middleware → AOP-style hook interception for flexibly extending the reasoning-acting loop.
- Workspace & Sandbox → Run tools in isolated environments — local, Docker, Kubernetes, or AgentRun cloud sandbox.
- Multi-Agent Orchestration → Multiple subagent definition patterns with agent_spawn / agent_send and real-time event forwarding.
- Distributed Deployment → True distributed session and memory management (Redis / MySQL / PostgreSQL / OSS / COS) with cross-replica session recovery.
- Agent Evolution → Provides Agent observability and auditing, Agent evaluation and experimentation, and Agent asset management and continuous optimization.
News
- [2026-07] v2.0.0 GA: First production-ready release! Dual-layer agent architecture, event stream, permission system, middleware, workspace sandbox, multi-agent orchestration, and distributed deployment all ready. Docs | Release Notes
- [2026-07] v2.0.0-RC5: Model provider modularization; unified DataBlock multimodal support; native structured output; Channel IM integration; Tencent Cloud COS state persistence. Release Notes
- [2026-06] v2.0.0-RC4: Async tool execution and scheduled wakeup dispatching; subagent cross-replica routing and session recovery. Release Notes
- [2026-06] v2.0.0-RC3: Unified call() / streamEvents() execution core; AgentResultEvent, CustomEvent, HintBlockEvent new event types. Release Notes
- [2026-06] v2.0.0-RC2: Fully stateless agent; one-line DistributedBackend; subagent event forwarding; Channel module (DingTalk, Feishu, WeCom); A2A / AG-UI protocol support. Release Notes
- [2026-05] v2.0.0-RC1: First 2.0 RC — harness engineering, enterprise distributed deployment, event stream / message model / middleware / HITL full redesign. Release Notes
- [2026-05] v1.1.0: Introduced agentscope-harness and HarnessAgent; Workspace (persona / memory / skills / subagents); pluggable filesystem (local / shared store / sandbox); session persistence with cross-process resume; layered memory and context compaction; declarative subagent orchestration. Release Notes
Community
Welcome to join our community on
| Discord | DingTalk | WeChat |
|--------------------------------------------------------------|--------------------------------------Top 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