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/
下载:v2.0.5v2.0.5 ↓2.0.52026-11-14
+7
日增长
6,374
stars
1,612
forks
45
watchers
2,529
prs
1,628
issues
30
releases

README

English Homepage | 日本語ホームページ | 文档




    
        
    
    
        
    
    
        
    
    
        
    
    
        
    
    
        
    


 什么是 AgentScope Java 2.0?

AgentScope Java 2.0 是面向企业级、分布式、生产环境的智能体框架,提供与模型能力相匹配的核心 Harness 抽象,可支持长期、稳定、安全可控的智能体任务执行。

- 事件系统 → 统一的事件流,32 种类型化事件,服务于前端实时渲染与 human-in-the-loop。
- 权限系统 → 工具调用决策机制:允许 / 用户审批 / 拒绝。
- Middleware → 基于 AOP 模式的 hook 事件拦截机制,灵活扩展推理-行动循环。
- Workspace 与沙箱 → 在隔离环境中执行工具 —— 本地、Docker、Kubernetes 或 AgentRun 云沙箱。
- 多智能体编排 → 多种子智能体定义模式,agent_spawn / agent_send + 事件流实时转发。
- 分布式部署 → 真正的分布式 session 与 memory 管理(Redis / MySQL / PostgreSQL / OSS / COS),跨副本 session 恢复。
- 智能体进化 → 提供 Agent 全栈观测与审计、Agent 评估与实验、Agent 资产管理与持续优化等能力。



 新闻

- [2026-07] v2.0.0 GA: 首个正式版本发布!双层 Agent 架构、事件流、权限系统、Middleware、Workspace 沙箱、多智能体编排、分布式部署全面就绪。 文档 | Release Notes
- [2026-07] v2.0.0-RC5: 模型提供商模块化拆分;统一 DataBlock 多模态支持;原生结构化输出;Channel IM 平台接入;腾讯云 COS 状态持久化。 Release Notes
- [2026-06] v2.0.0-RC4: 异步工具执行与定时唤醒调度;子 agent 跨副本路由与 session 恢复。 Release Notes
- [2026-06] v2.0.0-RC3: call() / streamEvents() 共享执行核心;AgentResultEvent、CustomEvent、HintBlockEvent 新事件类型。 Release Notes
- [2026-06] v2.0.0-RC2: Agent 完全无状态改造;DistributedBackend 一键配置;子 agent 事件流转发;Channel 模块(钉钉、飞书、企业微信);A2A / AG-UI 协议支持。 Release Notes
- [2026-05] v2.0.0-RC1: 首个 2.0 RC 版本,包含 Harness 工程化、企业级分布式部署、事件流 / 消息模型 / Middleware / HITL 全面重构。 Release Notes
- [2026-05] v1.1.0: 引入 agentscope-harness 与 HarnessAgent;Workspace 工作区(人格 / 记忆 / 技能 / 子 agent);可插拔文件系统(本地 / 共享存储 / 沙箱);Session 持久化与跨进程恢复;分层记忆与上下文压缩;声明式子 agent 编排。 Release Notes


 社区

欢迎加入我们的社区

| Discord                     | 钉钉                                                                    | 微信                                                           |
|--------------------------------------------------------------|-----------------------------------------------------------------------|--------------------------------------------------------------|
|  |  |  |

 快速开始

 安装

 AgentScope Java 需要 JDK 17 及以上版本。

 Maven

xml

    io.agentscope
    agentscope-harness
    2.0.3



2.0 中模型提供商已拆分为独立扩展模块,需额外引入所需的模型依赖。例如使用 DashScope:

xml

    io.agentscope
    agentscope-extensions-model-dashscope
    2.0.3



其他可选:agentscope-extensions-model-openai、agentscope-extensions-model-anthropic、agentscope-extensions-model-gemini、agentscope-extensions-model-ollama。详见模型文档。

文本和图片的类型化分类可使用 OpenAI Decisions,需要包含该扩展的 2.1.0-SNAPSHOT 构建。

如果希望直接使用 ReActAgent 的推理和工具 API、自行组合工程能力,可依赖 agentscope-core 和所需模型扩展。

 Hello AgentScope!

推荐在应用启动时定义共享 Builder,每次请求用 builder.build() 创建新 Agent,执行结束后关闭。新实例通过相同的身份和持久化配置延续会话。运行前设置 DASHSCOPE_API_KEY:

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

public class FirstAgent {
    // 应用启动时配置共享 Builder;请求期间只调用 build()。
    private static final HarnessAgent.Builder AGENT_B

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