AgentScope Java is a framework for building distributed, production-grade, long-running agents in Java.
The framework addresses the challenge of deploying agents safely and reliably in enterprise environments. It provides a unified event system with typed events for real-time monitoring and human oversight, a permission system for controlling tool execution through approval workflows, and middleware hooks that allow flexible extension of the agent reasoning-acting loop. Tool execution can be isolated in sandboxed environments ranging from local execution to Docker, Kubernetes, or cloud-based sandboxes. For multi-agent scenarios, the framework supports orchestration patterns including agent spawning and message passing with real-time event forwarding between agents.
Teams building production agents should consider this framework if they need distributed deployment across multiple replicas with session recovery, persistent memory management across Redis, MySQL, PostgreSQL, and object storage systems, or human-in-the-loop control over agent actions. The tool suits long-running agent applications where observability, auditability, and safe tool execution are requirements. It requires Java 17 or later and is distributed through Maven Central.
The project maintains active development with regular updates to its core abstractions and production deployment patterns. Documentation is comprehensive and available in both English and Chinese. The framework includes built-in support for agent observability and evaluation workflows, suggesting ongoing investment in the operational lifecycle of deployed agents beyond initial development.
