> ## Documentation Index
> Fetch the complete documentation index at: https://java.agentscope.io/llms.txt
> Use this file to discover all available pages before exploring further.
# AgentScope Java dev
> 使用 AgentScope Harness SDK 开发自己的 Agent 应用，组合上下文、工具、工作区与持久会话。
当前为开发版本，已发布的 SDK 请使用 [2.0 文档](https://java.agentscope.io/v2/zh/intro.md)。AGENTSCOPE DEV JAVA
让智能体持续工作，\
将能力嵌入应用。
========
使用 Harness SDK 开发自己的 Agent 应用，组合上下文、工作区、工具与持久会话，自主管理应用部署。
[开始构建 Harness ](https://java.agentscope.io/dev/zh/docs/quickstart.md)
[开源代码 ](https://github.com/agentscope-ai/agentscope-java)
[SDK · 自主开发
AgentScope Harness
将 SDK 嵌入自己的应用，组合上下文、工作区与工具执行，自主定制 Agent 逻辑并管理应用部署。
上下文管理工具与沙箱持久会话](https://java.agentscope.io/dev/zh/docs/harness/architecture.md)
## 为自己的应用构建 Agent
在应用代码中组合 Harness SDK 能力，按业务需要定制 Agent 行为。
HARNESS
AgentScope Harness
适合需要嵌入 Java 或 Spring Boot 应用、自定义运行逻辑的团队。HarnessAgent 提供推理与工具循环、工作区、上下文、技能和会话管理；你用代码组合这些能力，并负责应用的部署与运维。
[上下文与工作区按推理步骤构建上下文，压缩长任务历史，按需加载记忆、Skill 与工作文件。](https://java.agentscope.io/dev/zh/docs/harness/context.md)
[工具、沙箱与协作接入 Java 工具和 MCP，在选定的执行环境中完成操作，并委派子 Agent 处理独立任务。](https://java.agentscope.io/dev/zh/docs/harness/architecture.md)
[事件、交互与恢复保存消息和工具过程，处理用户补充与人工确认，通过持久会话和 checkpoint 继续工作。](https://java.agentscope.io/dev/zh/docs/harness/session-log.md)
## 从你需要的入口开始
将 Agent 嵌入已有 Java 应用。
[Java 快速开始 ](https://java.agentscope.io/dev/zh/docs/quickstart.md)
Harness 示例共享 Builder，每次请求构建新实例。
Harness · Java
```java theme={null}
// 共享配置；每次请求创建实例
var builder = HarnessAgent.builder()
.name("notes-assistant")
.agentId("notes-assistant")
.model("dashscope:qwen-plus")
.workspace(Path.of(".agentscope/workspace"));
try (var agent = builder.build()) {
var context = RuntimeContext.builder()
.userId("alice").sessionId("notes").build();
agent.streamEvents(
new UserMessage("整理材料中的任务与待确认事项"), context)
.doOnNext(System.out::println)
.blockLast();
}
```
生产环境验证 · Battle-tested in Production
阿里巴巴集团 集团内使用最广泛的智能体框架（Java & Python），十余条核心业务线生产环境深度使用
开源社区 开源与阿里云公有云用户覆盖 10+ 行业的头部企业
阿里巴巴集团
飞猪淘宝闪购虎鲸文娱AIDC阿里控股淘天交易淘天手淘1688千问 APP高德阿里云蚂蚁国际蚂蚁全球支付…
开源 · 公有云
金融交通物流消费零售制造能源医疗教育政媒互联网SaaS咨询等行业头部企业
## 开始前，你可能想了解
HarnessAgent 与 ReActAgent 是什么关系？
ReActAgent 提供推理、工具执行、消息、权限和中间件等基础能力。HarnessAgent 基于同一套 ReAct 循环，内置工作区、记忆、技能、子 Agent 与会话管理。推荐从 HarnessAgent 开始；需要自行组合运行层时，也可以直接使用 ReActAgent。如何继续中断的任务？
原生 Thread 日志保存消息、工具事实与 checkpoint。后台任务排队、交互和恢复使用 Durable；checkpoint 不会撤销已经发生的外部操作。需要哪些运行环境？
Java Harness 需要 JDK 17 及以上，并配置所选模型的凭据。工具可在本地或配置的沙箱中执行。