SubagentTaskController
@RestController public class SubagentTaskController源码Source
io/agentscope/spring/boot/admin/controller/SubagentTaskController.java:50–133子智能体任务控制器，承载智能体的部署、调度与服务化运行。位于 io.agentscope.spring.boot.admin.controller 包。核心成员包括 list、get、cancel、SubagentTaskController。
Data-plane REST for BackgroundTasks dispatched to subagents via
TaskRepository.
Path layout:
GET /v1/admin/sessions/{id}/subagent-tasks?status=RUNNING
GET /v1/admin/sessions/{id}/subagent-tasks/{taskId}
DELETE /v1/admin/sessions/{id}/subagent-tasks/{taskId} # cancel (write)
When no TaskRepository bean is wired, GET returns 200 + empty list and
DELETE returns 404 — a deliberate fail-soft so the route is always reachable and
/actuator/agentscope-doctor can flag the missing repository as a config issue.
构造器摘要Constructor Summary
| 构造器Constructor | 说明Description |
|---|---|
public SubagentTaskController(SubagentTaskOperations ops, AdminAuditLogger audit, AdminProperties properties) | 初始化 `SubagentTaskController` 实例。 Creates a new instance. |
方法摘要Method Summary
| 方法Method | 说明Description |
|---|---|
public Mono<List<SubagentTaskView>> list(String sessionId, String status, String operator) | 执行列表相关操作。 Performs the list operation. |
public Mono<ResponseEntity<SubagentTaskView>> get(String sessionId, String taskId, String operator) | 按条件读取数据。 Performs the get operation. |
public Mono<ResponseEntity<Map<String, Object>>> cancel(String sessionId, String taskId, String operator, String token) | 执行取消相关操作。 Performs the cancel operation. |
构造器详情Constructor Detail
SubagentTaskController
public SubagentTaskController(SubagentTaskOperations ops, AdminAuditLogger audit, AdminProperties properties)初始化 SubagentTaskController 实例。
Creates a new instance.
参数Parameters
| 名称Name | 类型Type | 说明Description |
|---|---|---|
ops | SubagentTaskOperations | ops（类型 `SubagentTaskOperations`）。The ops. |
audit | AdminAuditLogger | audit（类型 `AdminAuditLogger`）。The audit. |
properties | AdminProperties | 属性（类型 `AdminProperties`）。The properties. |
源码Source
io/agentscope/spring/boot/admin/controller/SubagentTaskController.java:60–65方法详情Method Detail
list
public Mono<List<SubagentTaskView>> list(String sessionId, String status, String operator)执行列表相关操作。
Performs the list operation.
参数Parameters
| 名称Name | 类型Type | 说明Description |
|---|---|---|
sessionId | String | 会话标识（类型 `String`）。The session id. |
status | String | 状态（类型 `String`）。The status. |
operator | String | operator（类型 `String`）。The operator. |
Mono<List<SubagentTaskView>>返回Mono>。Returns mono.
源码Source
io/agentscope/spring/boot/admin/controller/SubagentTaskController.java:67–86get
public Mono<ResponseEntity<SubagentTaskView>> get(String sessionId, String taskId, String operator)按条件读取数据。
Performs the get operation.
参数Parameters
| 名称Name | 类型Type | 说明Description |
|---|---|---|
sessionId | String | 会话标识（类型 `String`）。The session id. |
taskId | String | 任务标识（类型 `String`）。The task id. |
operator | String | operator（类型 `String`）。The operator. |
Mono<ResponseEntity<SubagentTaskView>>返回Mono>。Returns mono.
源码Source
io/agentscope/spring/boot/admin/controller/SubagentTaskController.java:88–109cancel
public Mono<ResponseEntity<Map<String, Object>>> cancel(String sessionId, String taskId, String operator, String token)执行取消相关操作。
Performs the cancel operation.
参数Parameters
| 名称Name | 类型Type | 说明Description |
|---|---|---|
sessionId | String | 会话标识（类型 `String`）。The session id. |
taskId | String | 任务标识（类型 `String`）。The task id. |
operator | String | operator（类型 `String`）。The operator. |
token | String | 令牌（类型 `String`）。The token. |
Mono<ResponseEntity<Map<String, Object>>>返回Mono>>。Returns mono.
源码Source
io/agentscope/spring/boot/admin/controller/SubagentTaskController.java:111–132