构建分布式、企业级智能体！
AgentScope Java 2.0 是面向企业级、分布式、生产环境的智能体框架，提供与模型能力相匹配的核心 Harness 抽象，可支持长期、稳定、安全可控的智能体任务执行。
io.agentscope:agentscope-harness:${agentscope.version}长期稳定运行的工程底座。
裸的 ReActAgent 只解决”一次推理”，HarnessAgent 通过 Middleware 与 Toolkit 两个扩展通道，把工作区、记忆、沙箱、子 agent、技能与计划模式打包成一套面向长期稳定运行的工程基础设施——核心推理循环原样保留，只叠加不替换。
- 身份持续：工作区即 agent 的人格 + 长期记忆 + 领域知识，每轮自动注入
- 上下文可控：自动压缩、大工具结果落盘、ContextOverflow 兜底重试
- 状态可恢复：同 sessionId 跨进程恢复完整对话；沙箱状态可快照
- 能力可沉淀：四层 Skill 合成 + 自学习闸门；声明式子 agent 编排
让执行过程可展示、可干预。
消息通过统一 ContentBlock 承载文本、文件、图片、思考与工具结果；一次 call() 不再只返回最终文本，而是流式产生模型调用、文本增量、工具调用、工具结果、用户确认等类型化事件。HITL 与权限审批是框架内生能力。
- 类型化事件：
streamEvents()逐步发出，前端无需手动 diff - 多模态消息：
DataBlock同时兼容 base64 与 URL 两种数据源 - 权限三态决策：静态规则 + 工具类型 + 输入分析 → 允许 / 用户审批 / 拒绝
- 外部执行回环：工具可在外部环境完成后回写结果，任务继续推进
组成可靠智能体系统的核心组件
从模型容错到沙箱执行，AgentScope Java 2.0 把”让 Agent 稳下来”所需的每一块工程拼图都给齐。
模型容错
通过模型扩展模块提供统一的 Credential + ChatModel 抽象，覆盖 Qwen / OpenAI / Anthropic / Gemini / DeepSeek / Ollama；可配置最大重试与备用模型，主模型不可用时自动切换。
了解模型 →上下文工程
结构化压缩保留目标 / 状态 / 关键发现 / 下一步；超大工具结果自动落盘、上下文只留占位符；文件读写强制”先读后改”，减少重复 IO。
了解记忆 →Middleware
onAgent / onReasoning / onActing / onModelCall 四个洋葱钩子 + onSystemPrompt 变换钩子。日志、追踪、权限、上下文注入、业务策略都能挂上去，框架核心保持稳定。
Workspace 抽象
把”agent 做什么”与”在哪里执行”分离。WorkspaceBase 统一身份、生命周期、资源发现与上下文卸载；本地磁盘、Docker、E2B 云沙箱一行切换；内置预热池适配 RL rollout。
了解 Workspace →多智能体
在 Markdown 里声明子 agent 规格，主 agent 在运行时按需 agent_spawn / agent_send，同步阻塞与后台委派两种模式。后台任务终态会通过 system-reminder 反向推送，不再要求轮询。
工具与 MCP
注解驱动的工具注册、按属性自动批处理串行或并发；统一接入任意 MCP 兼容服务器（文件系统、数据库、浏览器、代码解释器），workspace/tools.json 集中管理白名单。
常见问题
完整问答见 FAQ，或到 GitHub Discussions 提问。