支持 DeepSeek Harness 接入:AgentScope Service 开源智能体服务控制面解读

AgentScope Java 社区开源发布 AgentScope Service 组件,从设计定位上与 Python 开源版本基本对齐,面向企业级分布式智能体场景,通过控制面组件为 AgentScope 数据面智能体提供多租户、可视化调试、多智能体编排能力。

同时,AgentScope Service 还支持 Claude、DeepSeek Harness、Langchain 等多种形态智能体接入。

AgentScope Service 为智能体调试、分布式部署提供开源解决方案,如果您需要企业级智能体编排、Teams 编排、观测评估等能力,请访问文章最后给出的阿里云 AgentTeams、AgentLoop 产品了解详情。

  • AgentScope Service 是一个控制面。为企业内的所有 agent 提供智能体注册、查询、分布式协调服务,兼容 AgentScope、LangChain、ADK、Claude / Qoder 等主流 Agent 运行时,让企业可以有一个集中的 Agent 指标查看入口,同时可以对运行中的 Session 会话进行上下文压缩等操作;
  • AgentScope Service 提供低代码 Agent 创建与部署能力。底层基于 AgentScope Harnes 运行时,可以让您快速将多个 Agent 运行在一套统一管理的 Managed Agents 平台上,平台提供 Harness 能力托管,工具执行则可以委托给用户自己控制的 sandbox 沙箱;
  • 注册在 AgentScope Service 中的智能体,可以被组建为一个或多个 Teams 团队。不论是自己部署的 AgentScope 运行时还是低代码托管的 agent harness 运行时,都可以被编排在一起,共同协作完成更复杂的任务。

什么是 AgentScope Service




Cloud Native

AgentScope Service 的目标不是替换你现有的 Agent 框架,而是提供一层统一控制面,让你把用不同框架、不同技术栈(Claude、OpenClaw、QwenPaw等)搭建的智能体统一管控起来。

今天,构建企业级 Agent 已经有很多不同的选择。AgentScope 作为一款优秀的 Agent Framework,为企业提供了构建智能体的完整方案。但传统 Agent Framework 并不是当前唯一的智能体构建方式,我们看到 Coding Agent 产品正延伸到更多领域,比如使用 Claude SDK、Qoder CLI 等构建企业级智能体也正成为很多企业用户的选择。

1. 使用 Agent Framework。用 AgentScope、LangChain、ADK 等在业务服务里直接跑 agent loop。灵活度高,但租户隔离、版本发布、Session 恢复、HITL、事件落库、跨副本协调都要自己补齐。每个业务线做一遍,标准很难对齐。
2. 使用 Coding Agent 或个人工作区助手。如 Claude Code、各类 Coding Agent、个人工作区助手。启动快、体验好,但状态落在本机,难共享、难审计,也不适合多团队共管。电脑关机,任务也常常跟着停。
3. 使用低代码或 Managed Agents 平台。传统低代码平台通过可视化节点拼装 Agent,上手容易,却常把记忆管理、上下文压缩、工具组装等拆成大量配置项,让用户为效果和稳定性负责。Managed Agents 则强调云端 Harness 能力全面托管,让用户不再为担心、客户 VPC 内 Hands、以及企业级多 Agent 协作仍不完整。

这些路径并不互斥,一家公司里,研发可能用 Coding Agent,业务中台用 AgentScope,新项目想直接上托管 Harness——这很常见。AgentScope Service 不绑定任何智能体框架或平台,它为所有智能体运行时提供统一的管控能力。


Control Plane

Control Plane(控制面)是 AgentScope Service 的核心组件,所有 Agent 应用都通过控制面进行统一注册,通过 SDK 或 Sidecar 方式支持主流 Agent Framework(AgentScope、LangChain、ADK)以及 Claude、Qoder 等注册与接入。

Dashboard 则是控制面的可视化 UI 控制台,为整个集群提供在线 Agent 列表、部署实例信息、活跃 Session 信息、token 消耗等全局观测信息,方便了解集群工作状况。

此外,还可以在 dashboard 中查看 Session 会话信息,查看活跃 Session 的实时上下文状态(各部分数据占比),动态调整或压缩会话上下文,介入会话过程等。


Managed Agents

Managed Agents 是由 agentscope-builder 平台升级而来,它的定位仍旧是一个低代码 Agent 平台,为开发者提供 Agent 定义、Agent 托管运行的 SaaS 化平台能力。同时更强调推理与工具执行的分离,推理 Harness 能力更彻底的托管,工具执行则开放给用户更多的控制权。

Agent 定义总体围绕 AgentScope Harness 的核心设计理念设计,首先定义好 Workspace、Memory 等基础概念,通过将 workspace、memory 与 Agent 关联即可创建一个智能体。

定义 Workspace:

定义 Agent:

此次升级最大的变化是底层托管运行时逻辑与架构 -- Managed Agents。平台总体将静态定义(Agent、Workspace)与动态运行(Environment、Session)区分开来,通过 Environment、Session 等来编排 Agent 运行时行为。

创建 Session,绑定 self_hosted sandbox 运行时 environment:

Session 创建后,本身并不会启动 SSE Event 事件流,用户主动发起 user message 才会启动会话,执行整个推理过程。如下图,你可以在控制台 chat 页面发送 user message:

创建 Agent → 创建 Environment → 创建 Session → 发送第一条消息 → 在 Dashboard 观察事件流。Session 创建本身不会立刻跑 Agent。对长任务场景,Managed Agents 尤其关键的是可恢复:事件落库、状态可重建、HITL 可暂停续跑。前端刷新或服务副本切换,不应等于任务从头开始。

在运行架构上,设计与 Claude Managed Agents 非常类似,Harness 基础设施与运行时全托管(底层依赖 AgentScope Harness Runtime),基于 Brain/Hands 分离的架构让用户对工具执行环境有更多控制权。部署架构上,分为控制面、托管数据面两大组件,具体可参考后面的部署架构章节。


Agent Teams

注册在 AgentScope Service 控制面的所有智能体,不论是使用框架开发部署、自行注册到控制面的(Langchain、AgentScope、ADK、Claude SDK等)智能体,或者是使用 Managed Agents 低代码方式直接创建的托管 Agent,都可以把它们按照你想要的方式编排在一起,形成一个可以互相协作的 Agent Teams 来协作处理复杂。

在 AgentScope Service 设计中,Teams 团队不是聊天室,而是一套可运营的协作单元:任务可认领、计划可审批、成员可唤醒,状态也不会因为某个 Session 结束而全部消失。一个常见模式是 Lead 负责任务拆解与验收,Member 按能力认领调研、编码、核验等子任务,平台负责消息路由、任务板与生命周期,而不是让业务代码手写一套临时多进程通信。

值得特别说明的是,AgentScope 框架原生支持 Agent Teams 能力,这套机制是基于 AgentScope Service 控制面做分布式任务管理与调度,所以您既可以使用 AgentScope Framework 原生的 Teams 能力在主 Agent 编码阶段实现多 Agent 编排,也可以在控制台上根据需求将多个独立的 Agent 动态编排在一起完成某一项复杂任务。具体取决于您的使用场景。

整体架构




Cloud Native


总体架构

Human 通过 Dashboard(浏览器操作)或 REST API(SDK / curl / 第三方系统集成)两条入口进入 AgentScope Service Control Plane;控制面之下统一管理四类 Agent 接入方式:AgentScope 原生接入、LangChain 通过 instrument() 接入,Claude 与 QwenPaw 则通过 Sidecar 旁路接入。


Managed Agents


Agent Teams 协作流程

一个 Team 里的成员不要求来自同一个框架、同一种托管方式。用户在控制台里选择若干个已经注册到控制面的 Agent,指定谁是 Lead、谁是 Worker,就完成了一次编排——Lead 负责创建与分配任务,Worker 负责认领与执行,协作状态则统一交给控制面维护:

图里几个关键点:

  • 成员类型可以异构。示例里的 Lead 与 Worker 1 是 Managed Agent(控制面为其创建绑定 teamContext 的 Session,直接投递 user.message 起跑),Worker 2 是自行部署的 AgentScope 原生运行时,Worker 3 则是 LangChain(或经 Sidecar 接入的 Claude)——控制面对不同成员下发的加入方式不同(Managed 走 find-or-create session,BYO 走 team_join 命令),但暴露给 Lead 的协作模型是一致的:都是 Team 里可以被分配任务、可以收发消息的成员。
  • Lead 分配,Worker 认领,两条路径都存在。Lead 创建任务时可以直接指定 owner(assign 给某个 Worker),该 Worker 收到后走 claim → start → complete;Lead 也可以创建一个不指定 owner 的任务扔进 Task Board,由空闲的 Worker 自己 POST .../claim 完成 self-claim——两种模式在同一个 Task Board 上并存,不需要 Lead 时刻盯着谁在忙。
  • 消息分单播和广播。Mailbox 支持指定 to=member 的定向消息(比如 Lead 单独提醒某个 Worker),也支持不填 to 的广播(所有成员可见),二者共用同一套持久化通道。
  • 协作状态不挂在某一次会话上。Task Board 和 Mailbox 的数据独立于任何单个成员的 Session 生命周期:某个 Worker 的进程重启、Session 结束,不影响任务是否还在、消息是否还能追溯——这也是为什么某个 Worker 崩溃后,控制面能够识别成员状态变为 Lost 并触发恢复,而不是直接丢掉整个团队的进度。


AgentScope原生框架 + 控制面

AgentScope 框架本身提供了完善的企业级 Agent 解决方案,支持 Harness、Agent Teams、Multi-agent 协作、Sandbox 隔离等,在真正的企业级部署架构下,很多能力依赖分布式组件协调,AgentScope Service 控制面为 AgentScope 提供了原生分布式协调能力。

控制面分布式协调

AgentScope HarnessAgent 一旦从单实例走向多副本部署,会话状态、工作区文件、沙箱快照与并发锁、跨副本消息、异步工具、子任务与 Turn 并发控制,都不能再假设"进程内存里就是权威数据"。

下图展示的是运行时拓扑:多个 HarnessAgent 副本如何分别与 Control Plane、AgentStateStore 后端交互,而不是 DistributedStore 的接口定义。

图中有两条互不经过彼此的独立链路,这一点很关键:

  • 向上:协调类 API 调用。每个 HarnessAgent 副本通过 SDK 调用 Control Plane,托管的是开发者实际感知到的四类 Harness 能力:底层分别对应 BaseStore、SandboxSnapshotSpec / SandboxExecutionGuard
— 以上为试看内容(约 40%),开通会员后阅读全文 —