> ## 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 2.0 是什么？

> Harness 工程化、企业级分布式部署、底层框架重构。

AgentScope Java 2.0 从"构建一个智能体"的工具箱，迈向**面向生产环境运行智能体**的完整平台。本次升级围绕三大主题展开，每一部分都对应一个具体要解决的问题。

<Note>
  AgentScope Java 2.0 版本尽量保持了对 1.x 版本的兼容，确保大部分用户的平滑升级；但同时 2.0 也带来了 API 层面的不兼容变更，并在核心抽象、API 和架构上均有大幅改进。完整迁移指南详见 [V1 迁移指南](/v2/zh/docs/change-log)。
</Note>

## 1 · Harness 工程化 —— 长期运行、复杂任务的工程底座

裸的 ReAct 循环只解决"一次推理"。真实任务往往要跑数小时、积累大量状态、依赖可持续沉淀的能力。**Harness** 把这套工程基础设施一次给齐：核心推理循环原样保留，能力按需叠加，让智能体能稳定长跑、能力越用越强、能从容完成复杂作业。

<CardGroup cols={2}>
  <Card title="自进化与技能仓库" href="/v2/zh/docs/harness/skill">
    成功模式以 Markdown 技能自动沉淀到 `workspace/skills/`，每轮按需加载、跨会话共享 —— know-how 在每次运行之间累积。
  </Card>

  <Card title="分层记忆管理" href="/v2/zh/docs/harness/memory">
    三层记忆：上下文对话、agent 自维护的 `MEMORY.md`、磁盘事实流水账。自动压缩控制 prompt 体量，`memory_*` 工具提供显式回忆。
  </Card>

  <Card title="子智能体" href="/v2/zh/docs/harness/subagent">
    在 Markdown 里声明子 agent 规格，运行时按需 `agent_spawn` / `agent_send`，支持同步与后台委派。后台终态经 system-reminder 反向推送，无需轮询。
  </Card>

  <Card title="上下文自动管理" href="/v2/zh/docs/harness/compaction">
    结构化压缩保留目标 / 状态 / 关键发现 / 下一步；超大工具结果落盘、只留占位符；ContextOverflow 兜底重试是最后防线。
  </Card>

  <Card title="复杂任务规划（Plan Mode）" href="/v2/zh/docs/harness/plan-mode">
    只读规划态编排长任务；计划文件持久化到 `workspace/plans/` 并驱动执行，让意图与动作解耦。
  </Card>

  <Card title="Workspace 工程底座" href="/v2/zh/docs/harness/workspace">
    人格、知识、技能、子 agent 规格、会话日志全部以磁盘 Markdown / JSON 表达，每轮自动注入 system prompt。
  </Card>
</CardGroup>

## 2 · 企业级分布式部署

生产环境的智能体要服务多租户、要安全运行不可信工具代码、要在滚动发布时不丢失在途上下文。AgentScope 2.0 天然面向**无状态水平扩展**：任意副本都能恢复任意用户的完整上下文，沙箱状态可跨进程恢复，权限闸门 + 多维隔离把每一个租户的数据严格分开。

<CardGroup cols={2}>
  <Card title="多租户隔离" href="/v2/zh/docs/building-blocks/context">
    支持 `session` / `user` / `agent` / `org` 多维度状态隔离。`RuntimeContext` 的键贯穿工作区路径、KV 命名空间、沙箱状态槽。
  </Card>

  <Card title="安全沙箱执行" href="/v2/zh/docs/harness/sandbox">
    工具执行限定在隔离环境内 —— 本地子进程 / Docker / 远端 AgentRun 任选 —— 支持快照与恢复，长任务能在进程重启后继续。
  </Card>

  <Card title="工具权限管控" href="/v2/zh/docs/building-blocks/permission-system">
    权限三态决策（允许 / 审批 / 拒绝）综合静态规则、工具类型、输入分析；敏感工具强制人工审批，HITL 是框架内生能力。
  </Card>

  <Card title="优雅上下线与会话恢复" href="/v2/zh/docs/building-blocks/context">
    同一 `(userId, sessionId)` 在任意进程恢复完整对话；`AgentStateStore`（内存 / JSON 文件 / MySQL / Redis）支撑零停机滚动发布与崩溃恢复。
  </Card>
</CardGroup>

## 3 · 底层框架升级 —— 更轻、更顺手的核心抽象

底层做了一次重构：消息、事件、扩展机制更小、更正交、更顺手；HITL 与事件流式不再是外挂层，而是框架运行的一部分。

<CardGroup cols={2}>
  <Card title="事件流式输出原生支持" href="/v2/zh/docs/building-blocks/message-and-event">
    每一步 —— 模型调用、文本增量、工具执行、工具结果 —— 都以类型化事件流出。订阅一次，前端 UI 实时跟上。
  </Card>

  <Card title="更简洁的消息模型" href="/v2/zh/docs/building-blocks/message-and-event">
    文本、文件、图片、音视频、模型思考、工具结果统一收敛到一个 `ContentBlock`；按 role 严格校验，非法消息在构造期就被拦下。
  </Card>

  <Card title="Middleware 取代松散 Hook" href="/v2/zh/docs/building-blocks/middleware">
    `onAgent` / `onReasoning` / `onActing` / `onModelCall` / `onSystemPrompt` 五个阶段取代 v1 的扁平 hook。每个关注点各居其层，组合干净利落。
  </Card>

  <Card title="HITL 一等公民" href="/v2/zh/docs/building-blocks/permission-system">
    可在执行中确认工具参数、审批敏感操作，或把执行交给外部系统。智能体在暂停点等待并精确恢复，无需自己搭脚手架。
  </Card>
</CardGroup>

***

正在评估升级时间表的开发者，可以查阅 [V1 迁移指南](/v2/zh/docs/change-log) —— 拆成"必须迁移 / 推荐迁移"两层的迁移指南，加上新功能罗列，足以端到端规划一次升级。各版本具体变更请见 [Release Notes](/v2/zh/docs/others/release-notes)。

## AgentScope Service

[AgentScope Service：部署与使用](/v2/zh/service/index)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.