agentscope-ai/agentscope-java

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

What it solves

AgentScope Java 2.0 provides a production-ready framework for building and deploying distributed, enterprise-grade AI agents. It moves beyond simple prototyping by addressing the challenges of long-running tasks, secure tool execution, multi-tenant isolation, and session recovery in production environments.

How it works

The framework uses a dual-layer architecture where a reasoning core (ReActAgent) is wrapped in a "Harness" (HarnessAgent) that adds production infrastructure. It employs a unified event stream for real-time rendering and human-in-the-loop (HITL) interactions, a middleware system for intercepting the reasoning-acting loop, and a permission system to gate tool calls. For deployment, it supports stateless horizontal scaling with external state stores (Redis, MySQL, PostgreSQL) and isolated execution environments (Docker, Kubernetes, or cloud sandboxes).

Who it’s for

Java developers and enterprise architects who need to build scalable, secure, and observable AI agent applications that can handle complex, long-term workflows and integrate into existing business systems.

Highlights

  • Harness Engineering: Includes a skill repository for self-evolution, layered memory with auto-compaction, and the ability to spawn and delegate tasks to sub-agents.
  • Enterprise Deployment: Supports multi-tenant isolation, session recovery for zero-downtime deploys, and secure sandboxing for running untrusted code.
  • Event-Driven Core: A system of 32 typed events for real-time streaming and a first-class Human-in-the-Loop (HITL) mechanism for approving sensitive actions.
  • Flexible Middleware: AOP-style hooks at six different stages (e.g., onReasoning, onActing) to extend agent behavior without modifying the core logic.

Related

  • Project
  • Project
  • Project
  • Project
  • Project