agentscope-ai /agentscope-java

Build distributed, production-grade, long-running agents.

★ 6,374⑂ 1,612👁 45⑃ 2,529● 1,628▤ 30
JavaApache-2.0Created 2025-09-23java.agentscope.io/
Download: v2.0.5v2.0.5 ↓2.0.52026-11-14
+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

Discussions

Latest release

v2.0.5 v2.0.5 2026-11-14
AgentScope 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

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON