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-08] AgentScope Service： Agent 控制面与 Dashboard，面向 Agent 观测、注册与编排，兼容 AgentScope、LangChain、ADK、Claude / Qoder 等。
- [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;

publ

Top issues

Discussions

Latest release

AgentScope Java 2.0.4 adds OpenAI Responses API support, a redesigned AgentScope Service, new channel and storage integrations, and stronger isolation for concurrent agent runs, tools, and skills.

 Added

Core / Models

- Add the OpenAI Responses API module (3078).
- Support returnDirect tool results to short-circuit the reasoning loop (2891).
- Expose detailed chat usage token metrics and model-fallback failover listeners (3215, 3145).
- Support Anthropic bearer token authentication (3038).
- Add a type-safe Jev System One client, Spring Boot starter, and example middlewares (3240)