agentscope-java README

The project's README from github.com/agentscope-ai/agentscope-java. As one markdown file: README.md.

AgentScope Logo

中文主页 | Documentation

discord docs Maven Central JDK 17+ license Ask DeepWiki

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.

agentscope

News

Community

Welcome to join our community on

Discord DingTalk WeChat

Quickstart

Installation

AgentScope Java requires JDK 17 or higher.

Maven

<dependency>
    <groupId>io.agentscope</groupId>
    <artifactId>agentscope-harness</artifactId>
    <version>2.0.1</version>
</dependency>

Model providers are shipped as separate extension modules in 2.0. Add the one you need — for example, DashScope:

<dependency>
    <groupId>io.agentscope</groupId>
    <artifactId>agentscope-extensions-model-dashscope</artifactId>
    <version>2.0.1</version>
</dependency>

Other options: agentscope-extensions-model-openai, agentscope-extensions-model-anthropic, agentscope-extensions-model-gemini, agentscope-extensions-model-ollama. See the Model docs for details.

If you only need a bare ReActAgent without workspace / persistence / sandbox, depend on agentscope-core alone.

Hello AgentScope!

Start your first agent with AgentScope Java 2.0:

import io.agentscope.core.agent.RuntimeContext;
import io.agentscope.core.message.UserMessage;
import io.agentscope.harness.agent.HarnessAgent;
import java.nio.file.Paths;

public class FirstAgent {
    public static void main(String[] args) {
        HarnessAgent agent = HarnessAgent.builder()
                .name("assistant")
                .sysPrompt("You are a helpful AI assistant.")
                // ModelRegistry resolves the string and reads the matching
                // API-key env var (e.g. OPENAI_API_KEY or DEEPSEEK_API_KEY)
                // automatically.
                // Examples: "openai:gpt-4.1", "openai:o3",
                // "deepseek:deepseek-v4-flash", "dashscope:qwen-plus",
                // "anthropic:claude-sonnet-4-7", "ollama:llama3"
                .model("dashscope:qwen-plus")
                // Or pass a ChatModel object directly:
                // .model(OpenAIChatModel.builder().model("gpt-4.1").build())
                .workspace(Paths.get(".agentscope/workspace"))
                .build();

        RuntimeContext ctx = RuntimeContext.builder()
                .sessionId("demo").userId("alice").build();

        // Blocking call
        agent.call(new UserMessage("Hello!"), ctx).block();

        // Or stream events for real-time UI rendering
        agent.streamEvents(new UserMessage("Summarize today in three bullets."), ctx)
                .doOnNext(event -> {
                    switch (event.getType()) {
                        case TEXT_BLOCK_DELTA -> System.out.print(
                                ((io.agentscope.core.event.TextBlockDeltaEvent) event).getDelta());
                        case TOOL_CALL_START -> System.out.println(
                                "\n[tool] " + ((io.agentscope.core.event.ToolCallStartEvent) event).getToolCallName());
                        default -> { }
                    }
                })
                .blockLast();
    }
}

AgentScope Service

AgentScope Service — an Agent Control Plane built on AgentScope Harness that provides:

agentscope-service-architecture.png

Key Design

AgentScope Java 2.0 is a major step up from a "build an agent" toolkit toward a complete platform for running agents in production. The improvements fall into three focus areas:

1 · Harness Engineering — built for long-running, complex tasks

A bare ReAct loop solves one reasoning turn. HarnessAgent layers engineering infrastructure on top of ReActAgent via Middleware and Toolkit channels — the reasoning core stays untouched, capabilities layer on:

2 · Enterprise-grade distributed deployment

Production agents must serve many tenants, run untrusted code safely, and survive rolling restarts. AgentScope 2.0 is built for stateless horizontal scaling:

3 · Foundation framework — a leaner, more developer-friendly core

Messages, events, and the extension model are smaller, more orthogonal — HITL and event streaming are part of how the framework runs, not add-ons:

For the complete architecture overview, see the documentation.

Contributing

We welcome contributions from the community! Please refer to our CONTRIBUTING.md for guidelines on how to contribute.

License

AgentScope is released under Apache License 2.0.

Contributors

All thanks to our contributors:

agentscope-java (agentscope-ai/agentscope-java)

Searching Database…

6K ·GitHub
Agentscope-java
Что это такое?AgentScope Java 2.0 — это готовый к промышленной эксплуатации фреймворк на Java для создания распределённых корпоративных ИИ-агентов, которые безопасно справляются с длительными и сложными задачами. Во фреймворке встроены оркестрация нескольких агентов, песочница и управление с участием человека.
Это просто библиотека для агентов или полноценная платформа?Это многоуровневый продукт: 'agentscope-core' даёт простой ReActAgent, 'HarnessAgent' добавляет промышленные возможности (память, подагенты, промежуточное ПО), а необязательный AgentScope Service предоставляет панель управления для работы с множеством агентов в разных средах выполнения.
Как добавить это в Java-проект?Добавьте Maven-зависимость AgentScope и модуль расширения нужного провайдера модели (например, dashscope, openai, anthropic, gemini или ollama). Если нужен только простой ReActAgent без рабочей области, хранилища и песочницы, достаточно зависимости от 'agentscope-core'.
Что нужно установить перед началом?Нужны JDK 17 или выше и Maven для сборки. Для полноценной работы распределённых и корпоративных функций дополнительно требуется хранилище данных, например Redis, MySQL, PostgreSQL, OSS или COS.
Что требуется для работы на полную мощность?Код ядра агента простой, но корпоративные возможности, такие как изоляция между арендаторами, безопасная песочница и восстановление сессий без простоя, требуют дополнительной инфраструктуры: Docker или Kubernetes для песочниц и Redis, MySQL или PostgreSQL для распределённого состояния.
Для кого это предназначено?Это для Java-команд, которые создают промышленных агентов: их нужно масштабировать на несколько реплик, обслуживать несколько арендаторов и безопасно выполнять недоверенный код инструментов. Это не для любителей, которым нужен быстрый чат-бот в одном процессе.
Что такое AgentScope Service?Это необязательная панель управления (Agent Control Plane и Dashboard) для регистрации, поиска и координации агентов в разных средах выполнения, включая AgentScope, LangChain, ADK и Claude/Qoder, из одного места.
Что делает хранилище навыков для самосовершенствования?Успешные шаблоны решения задач автоматически сохраняются как Markdown-файлы «навыки». Они используются в разных сессиях и подгружаются по необходимости, поэтому агенты совершенствуются при повторных запусках без переобучения.
Как здесь работает подтверждение действий человеком?Система разрешений задаёт для каждого вызова инструмента одно из трёх состояний: разрешить, требовать подтверждения или запретить. Чувствительные действия приостанавливаются и через поток событий передаются человеку на подтверждение до выполнения.
Может ли агент делегировать работу подагентам?Да. Агенты описывают спецификации дочерних агентов в Markdown и во время выполнения используют 'agentspawn' и 'agentsend', чтобы передавать работу синхронно или в фоновом режиме. События в реальном времени пересылаются между репликами.
What are similar projects?deer-flow, hive, adk-python, PocketFlow, ruflo, ai-agents-the-definitive-guide, go-micro, open-multi-agent
Which topics is it in?multi-tenant, middleware, human-in-the-loop, agentic, langchain, harness, agent-framework, enterprise, agent-memory, sandbox, orchestration, agent-orchestration
Creator
agentscope-ai
Size
57.4 MB
Stars
6K
Updated
CommitOct 18Releasev2.0.4Oct 08
Age
1y
Commits · 90 Days