专为分布式、企业级智能体
打造的 Harness 框架。
AgentScope Java 是面向 JVM 的开源 Agent 框架。提供 ReAct 推理、Harness 工程化基础设施、多智能体编排与 MCP/A2A 协议支持，覆盖从本地原型到企业级分布式部署全链路。
import io.agentscope.harness.*; var agent = HarnessAgent.builder() .name("coder") .model(new QwenConfig("qwen-plus")) .filesystem(new LocalFilesystemSpec("./workspace")) .session(new RedisSession(jedisPool)) .build(); // 有状态 · 可恢复 · 记忆持久化 agent.call(messages, RuntimeContext.builder() .sessionId("user-123").build()).block();
io.agentscope:agentscope-harness
企业级工程范式，开箱即用。
Harness 模块通过 Hook 机制在推理循环之外注入工作区管理、记忆持久化、对话压缩等工程能力，无需修改核心推理逻辑。
- 结构化工作区作为 Agent 唯一状态来源
- 跨会话长期记忆沉淀与自动整理
- 上下文超长自动压缩，防止 Token 溢出
- 本机磁盘 → Docker 沙箱 → 对象存储，一行切换
workspace/ ├── AGENTS.md # 人格 + 系统指令 ├── MEMORY.md # 长期记忆（自动维护） ├── knowledge/ # 领域知识与 RAG 索引 ├── skills/ # 可复用技能文件 ├── subagents/ # 子 Agent 配置 └── agents/coder/session-user-123/ ├── chat-history.jsonl └── scratchpad/ $ 每次 call → 自动加载 → 推理 → 回写记忆
+------------------------------------------------------------+ | Supervisor (HarnessAgent) | | - 规划任务 / 调度子 Agent / 聚合结果 | +---------------------------+--------------------------------+ | +-----------------+------------------+ | | +---------v---------+ +---------v---------+ | researcher Agent | | coder Agent | | - web_search | | - filesystem/tool | | - read_file | | - code execution | +---------+---------+ +---------+---------+ | | +-----------------+------------------+ | +---------------------------v--------------------------------+ | Shared Runtime Infrastructure | | Session (Redis) · Workspace · Memory · MCP · A2A | +------------------------------------------------------------+
像微服务一样编排 Agent。
在 Markdown 文件中声明子 Agent 规格，主 Agent 在运行时按需 spawn 子 Agent，支持同步阻塞与异步非阻塞两种委派模式。
- 声明式子 Agent 定义，无需修改代码
- 同步阻塞 / 异步非阻塞两种委派模式
- A2A 协议支持跨进程、跨机器调用
- 子 Agent 可独立继承或覆盖 Harness 配置
全栈能力，专为生产打磨
从推理核心到企业部署，AgentScope Java 覆盖智能体开发全链路。
ReAct 推理
自主规划、工具调用与结果整合。内置安全中断、优雅取消与 Hook 人机协作，自主性与可控性兼得。
快速开始 →记忆 & RAG
跨会话持久化记忆，支持语义检索。后台自动整理长期记忆，防止上下文无限膨胀，多租户隔离开箱即用。
了解记忆 →MCP 协议
接入任意 MCP 兼容服务器——文件系统、数据库、浏览器、代码解释器，扩展 Agent 工具能力无需自定义集成代码。
查看 MCP →A2A 协议
将 Agent 注册到 Nacos 等服务发现中心，其他 Agent 可像调用微服务一样动态发现和委派任务。
查看 A2A →沙箱隔离
工具执行在隔离环境（本地 Unix / Docker / E2B）内完成。多轮对话间沙箱状态完整保留，支持跨会话快照恢复。
了解沙箱 →可观测性
可插拔 Tracer SPI，原生支持 OpenTelemetry 分布式追踪。AgentScope Studio 提供可视化调试与实时监控面板。
查看 Studio →常见问题
还有疑问？欢迎在 GitHub Discussions 提问。
AgentScope Java 需要什么 Java 版本？
需要 JDK 17 或更高版本。框架使用了 Records、Sealed Classes 等现代 Java 特性，并基于 Project Reactor 构建响应式非阻塞执行模型。如需极低冷启动延迟，可通过 Quarkus 进行 GraalVM 原生镜像编译。
支持哪些 LLM 提供商？
支持所有兼容 OpenAI Chat Completions API 的模型，包括阿里云通义千问、OpenAI GPT 系列、Anthropic Claude、本地 Ollama 等。框架提供标准 ModelConfig SPI，可通过插件扩展接入任意模型服务商。
Harness 和普通 ReActAgent 有什么区别？
ReActAgent 是推理—工具—回复的核心循环；HarnessAgent 在此之上通过 Hook 系统注入工作区加载、记忆持久化、对话压缩、沙箱生命周期等工程能力，二者使用同一套推理核心。你可以从 ReActAgent 起步，需要工程化能力时无缝迁移到 HarnessAgent，无需改动业务逻辑。
可以和 Spring Boot / Quarkus 一起使用吗？
可以。AgentScope Java 的核心模块是框架无关的 Java 库，可以直接在 Spring Boot、Quarkus、Micronaut 或任意 JVM 应用中作为依赖引入，无任何侵入性。Quarkus 可进一步利用 GraalVM 原生镜像编译实现超低延迟冷启动，适合 Serverless 场景。
如何在生产环境中水平扩展？
AgentScope Java 天然支持无状态水平扩展：将会话状态托管到 RedisSession，文件工作区迁移到对象存储（OssFilesystemSpec），任意副本均可恢复同一用户的完整上下文。结合 Kubernetes 与 HPA，可实现毫秒级弹性扩缩容。