AS AgentScopeAPI 手册 / API Reference
接口interface io.agentscope.harness.agent.team 2.x

TeamClient

public interface TeamClient
源码Source io/agentscope/harness/agent/team/TeamClient.java:26–114

定义团队客户端契约的接口。位于 io.agentscope.harness.agent.team 包。核心成员包括 listTasks、createTask、assignTask、claimTask、completeTask、failTask。

Client for AgentTeams coordination (Claude-parity task board + mailbox).

Implementations: LocalTeamClient (BaseStore CAS) and control-plane HTTP.

方法摘要Method Summary

方法Method说明Description
public Mono<List<TeamTask>> listTasks(String namespace, String teamName)
列出任务。
Lists all tasks on the team board.
public Mono<TeamTask> createTask(String namespace, String teamName, String subject, String description, List<String> blockedBy, String owner)
创建任务。
Creates a pending task; `owner` may be blank (unassigned).
public Mono<TeamTask> assignTask(String namespace, String teamName, String taskId, String owner, long expectedVersion)
执行 `assignTask` 方法。
Lead-assigns a pending task to `owner` (stays pending).
public Mono<TeamTask> claimTask(String namespace, String teamName, String taskId, String claimedBy, long expectedVersion)
执行 `claimTask` 方法。
Claims a pending unblocked task into in_progress when owner is empty (self-claim) or already equals `claimedBy` (assignee starts).
public Mono<TeamTask> completeTask(String namespace, String teamName, String taskId, String result)
执行 `completeTask` 方法。
Completes an in-progress task.
public Mono<TeamTask> failTask(String namespace, String teamName, String taskId, String reason)
执行 `failTask` 方法。
Marks a non-terminal task failed.
public Mono<TeamTask> unclaimTask(String namespace, String teamName, String taskId, long expectedVersion)
执行 `unclaimTask` 方法。
Unclaims an in-progress task back to pending.
public Mono<List<TeamTask>> listClaimableTasks(String namespace, String teamName, String forMember)
列出 `listClaimableTasks`。
Returns unblocked pending tasks the caller can start: unassigned open-board tasks, plus (when `forMember` is non-blank) pending tasks already assigned to that member.
default public Mono<List<TeamTask>> listClaimableTasks(String namespace, String teamName)
default
列出 `listClaimableTasks`。
Open-board claimable tasks only (`forMember` blank).
public Mono<TeamMessage> sendMessage(String namespace, String teamName, String from, String to, String content)
发送消息。
Point-to-point team mailbox message.
public Mono<List<TeamMessage>> broadcastMessage(String namespace, String teamName, String from, String content)
执行 `broadcastMessage` 方法。
Broadcast mailbox message to all other members (`to` empty on CP).
public Mono<List<TeamMessage>> listMessages(String namespace, String teamName, int limit)
列出消息。
Lists recent team messages.
public Mono<List<TeamMemberInfo>> listMembers(String namespace, String teamName)
列出成员。
Lists team members.
public Mono<Void> spawnMember(String namespace, String teamName, String name, String agentRef, String prompt)
执行 `spawnMember` 方法。
Dynamically spawn a teammate (lead).
public Mono<Void> shutdownMember(String namespace, String teamName, String memberName)
执行 `shutdownMember` 方法。
Shutdown / remove a teammate (lead).
public Mono<Void> submitPlan(String namespace, String teamName, String memberName, String planText)
执行提交计划相关操作。
Worker submits a plan for lead approval.
public Mono<Void> approvePlan(String namespace, String teamName, String memberName)
批准计划。
Lead approves a member plan.
public Mono<Void> rejectPlan(String namespace, String teamName, String memberName)
拒绝计划。
Lead rejects a member plan.
public Mono<TeamInfo> createTeam(TeamCreateSpec spec)
创建团队。
Creates a store-backed team and seed members.
public Mono<Void> completeTeam(String namespace, String teamName)
执行 `completeTeam` 方法。
Marks the team completed (retention TTL; not immediate delete).

方法详情Method Detail

listTasks

public Mono<List<TeamTask>> listTasks(String namespace, String teamName)

列出任务。

Lists all tasks on the team board.

参数Parameters
名称Name类型Type说明Description
namespaceString命名空间（类型 `String`）。The namespace.
teamNameString团队名称（类型 `String`）。The team name.
返回Returns Mono<List<TeamTask>>
返回Mono>。Returns mono.
源码Source io/agentscope/harness/agent/team/TeamClient.java:29

createTask

public Mono<TeamTask> createTask(String namespace, String teamName, String subject, String description, List<String> blockedBy, String owner)

创建任务。

Creates a pending task; owner may be blank (unassigned).

参数Parameters
名称Name类型Type说明Description
namespaceString命名空间（类型 `String`）。The namespace.
teamNameString团队名称（类型 `String`）。The team name.
subjectString主题（类型 `String`）。The subject.
descriptionString描述（类型 `String`）。The description.
blockedByList<String>blocked 通过（类型 `List`）。The blocked by.
ownerString所有者（类型 `String`）。The owner.
返回Returns Mono<TeamTask>
返回Mono。Returns mono.
源码Source io/agentscope/harness/agent/team/TeamClient.java:32–38

assignTask

public Mono<TeamTask> assignTask(String namespace, String teamName, String taskId, String owner, long expectedVersion)

执行 assignTask 方法。

Lead-assigns a pending task to owner (stays pending).

参数Parameters
名称Name类型Type说明Description
namespaceString命名空间（类型 `String`）。The namespace.
teamNameString团队名称（类型 `String`）。The team name.
taskIdString任务标识（类型 `String`）。The task id.
ownerString所有者（类型 `String`）。The owner.
expectedVersionlongexpected 版本（类型 `long`）。The expected version.
返回Returns Mono<TeamTask>
返回Mono。Returns mono.
源码Source io/agentscope/harness/agent/team/TeamClient.java:41–42

claimTask

public Mono<TeamTask> claimTask(String namespace, String teamName, String taskId, String claimedBy, long expectedVersion)

执行 claimTask 方法。

Claims a pending unblocked task into in_progress when owner is empty (self-claim) or already equals claimedBy (assignee starts).

参数Parameters
名称Name类型Type说明Description
namespaceString命名空间（类型 `String`）。The namespace.
teamNameString团队名称（类型 `String`）。The team name.
taskIdString任务标识（类型 `String`）。The task id.
claimedByStringclaimed 通过（类型 `String`）。The claimed by.
expectedVersionlongexpected 版本（类型 `long`）。The expected version.
返回Returns Mono<TeamTask>
返回Mono。Returns mono.
源码Source io/agentscope/harness/agent/team/TeamClient.java:51–56

completeTask

public Mono<TeamTask> completeTask(String namespace, String teamName, String taskId, String result)

执行 completeTask 方法。

Completes an in-progress task.

参数Parameters
名称Name类型Type说明Description
namespaceString命名空间（类型 `String`）。The namespace.
teamNameString团队名称（类型 `String`）。The team name.
taskIdString任务标识（类型 `String`）。The task id.
resultString结果（类型 `String`）。The result.
返回Returns Mono<TeamTask>
返回Mono。Returns mono.
源码Source io/agentscope/harness/agent/team/TeamClient.java:59

failTask

public Mono<TeamTask> failTask(String namespace, String teamName, String taskId, String reason)

执行 failTask 方法。

Marks a non-terminal task failed.

参数Parameters
名称Name类型Type说明Description
namespaceString命名空间（类型 `String`）。The namespace.
teamNameString团队名称（类型 `String`）。The team name.
taskIdString任务标识（类型 `String`）。The task id.
reasonString原因（类型 `String`）。The reason.
返回Returns Mono<TeamTask>
返回Mono。Returns mono.
源码Source io/agentscope/harness/agent/team/TeamClient.java:62

unclaimTask

public Mono<TeamTask> unclaimTask(String namespace, String teamName, String taskId, long expectedVersion)

执行 unclaimTask 方法。

Unclaims an in-progress task back to pending.

参数Parameters
名称Name类型Type说明Description
namespaceString命名空间（类型 `String`）。The namespace.
teamNameString团队名称（类型 `String`）。The team name.
taskIdString任务标识（类型 `String`）。The task id.
expectedVersionlongexpected 版本（类型 `long`）。The expected version.
返回Returns Mono<TeamTask>
返回Mono。Returns mono.
源码Source io/agentscope/harness/agent/team/TeamClient.java:65–66

listClaimableTasks

public Mono<List<TeamTask>> listClaimableTasks(String namespace, String teamName, String forMember)

列出 listClaimableTasks。

Returns unblocked pending tasks the caller can start: unassigned open-board tasks, plus (when forMember is non-blank) pending tasks already assigned to that member.

参数Parameters
名称Name类型Type说明Description
namespaceString命名空间（类型 `String`）。The namespace.
teamNameString团队名称（类型 `String`）。The team name.
forMemberString用于成员（类型 `String`）。The for member.
返回Returns Mono<List<TeamTask>>
返回Mono>。Returns mono.
源码Source io/agentscope/harness/agent/team/TeamClient.java:72

listClaimableTasks

default public Mono<List<TeamTask>> listClaimableTasks(String namespace, String teamName)
default

列出 listClaimableTasks。

Open-board claimable tasks only (forMember blank).

参数Parameters
名称Name类型Type说明Description
namespaceString命名空间（类型 `String`）。The namespace.
teamNameString团队名称（类型 `String`）。The team name.
返回Returns Mono<List<TeamTask>>
返回Mono>。Returns mono.
源码Source io/agentscope/harness/agent/team/TeamClient.java:75–77

sendMessage

public Mono<TeamMessage> sendMessage(String namespace, String teamName, String from, String to, String content)

发送消息。

Point-to-point team mailbox message.

参数Parameters
名称Name类型Type说明Description
namespaceString命名空间（类型 `String`）。The namespace.
teamNameString团队名称（类型 `String`）。The team name.
fromString来自（类型 `String`）。The from.
toString到（类型 `String`）。The to.
contentString内容（类型 `String`）。The content.
返回Returns Mono<TeamMessage>
返回Mono。Returns mono.
源码Source io/agentscope/harness/agent/team/TeamClient.java:80–81

broadcastMessage

public Mono<List<TeamMessage>> broadcastMessage(String namespace, String teamName, String from, String content)

执行 broadcastMessage 方法。

Broadcast mailbox message to all other members (to empty on CP).

参数Parameters
名称Name类型Type说明Description
namespaceString命名空间（类型 `String`）。The namespace.
teamNameString团队名称（类型 `String`）。The team name.
fromString来自（类型 `String`）。The from.
contentString内容（类型 `String`）。The content.
返回Returns Mono<List<TeamMessage>>
返回Mono>。Returns mono.
源码Source io/agentscope/harness/agent/team/TeamClient.java:84–85

listMessages

public Mono<List<TeamMessage>> listMessages(String namespace, String teamName, int limit)

列出消息。

Lists recent team messages.

参数Parameters
名称Name类型Type说明Description
namespaceString命名空间（类型 `String`）。The namespace.
teamNameString团队名称（类型 `String`）。The team name.
limitint数量上限（类型 `int`）。The limit.
返回Returns Mono<List<TeamMessage>>
返回Mono>。Returns mono.
源码Source io/agentscope/harness/agent/team/TeamClient.java:88

listMembers

public Mono<List<TeamMemberInfo>> listMembers(String namespace, String teamName)

列出成员。

Lists team members.

参数Parameters
名称Name类型Type说明Description
namespaceString命名空间（类型 `String`）。The namespace.
teamNameString团队名称（类型 `String`）。The team name.
返回Returns Mono<List<TeamMemberInfo>>
返回Mono>。Returns mono.
源码Source io/agentscope/harness/agent/team/TeamClient.java:91

spawnMember

public Mono<Void> spawnMember(String namespace, String teamName, String name, String agentRef, String prompt)

执行 spawnMember 方法。

Dynamically spawn a teammate (lead).

参数Parameters
名称Name类型Type说明Description
namespaceString命名空间（类型 `String`）。The namespace.
teamNameString团队名称（类型 `String`）。The team name.
nameString名称（类型 `String`）。The name.
agentRefString智能体引用（类型 `String`）。The agent ref.
promptString提示词（类型 `String`）。The prompt.
返回Returns Mono<Void>
返回Mono。Returns mono.
源码Source io/agentscope/harness/agent/team/TeamClient.java:94–95

shutdownMember

public Mono<Void> shutdownMember(String namespace, String teamName, String memberName)

执行 shutdownMember 方法。

Shutdown / remove a teammate (lead).

参数Parameters
名称Name类型Type说明Description
namespaceString命名空间（类型 `String`）。The namespace.
teamNameString团队名称（类型 `String`）。The team name.
memberNameString成员名称（类型 `String`）。The member name.
返回Returns Mono<Void>
返回Mono。Returns mono.
源码Source io/agentscope/harness/agent/team/TeamClient.java:98

submitPlan

public Mono<Void> submitPlan(String namespace, String teamName, String memberName, String planText)

执行提交计划相关操作。

Worker submits a plan for lead approval.

参数Parameters
名称Name类型Type说明Description
namespaceString命名空间（类型 `String`）。The namespace.
teamNameString团队名称（类型 `String`）。The team name.
memberNameString成员名称（类型 `String`）。The member name.
planTextString计划文本（类型 `String`）。The plan text.
返回Returns Mono<Void>
返回Mono。Returns mono.
源码Source io/agentscope/harness/agent/team/TeamClient.java:101

approvePlan

public Mono<Void> approvePlan(String namespace, String teamName, String memberName)

批准计划。

Lead approves a member plan.

参数Parameters
名称Name类型Type说明Description
namespaceString命名空间（类型 `String`）。The namespace.
teamNameString团队名称（类型 `String`）。The team name.
memberNameString成员名称（类型 `String`）。The member name.
返回Returns Mono<Void>
返回Mono。Returns mono.
源码Source io/agentscope/harness/agent/team/TeamClient.java:104

rejectPlan

public Mono<Void> rejectPlan(String namespace, String teamName, String memberName)

拒绝计划。

Lead rejects a member plan.

参数Parameters
名称Name类型Type说明Description
namespaceString命名空间（类型 `String`）。The namespace.
teamNameString团队名称（类型 `String`）。The team name.
memberNameString成员名称（类型 `String`）。The member name.
返回Returns Mono<Void>
返回Mono。Returns mono.
源码Source io/agentscope/harness/agent/team/TeamClient.java:107

createTeam

public Mono<TeamInfo> createTeam(TeamCreateSpec spec)

创建团队。

Creates a store-backed team and seed members.

参数Parameters
名称Name类型Type说明Description
specTeamCreateSpec规格（类型 `TeamCreateSpec`）。The spec.
返回Returns Mono<TeamInfo>
返回Mono。Returns mono.
源码Source io/agentscope/harness/agent/team/TeamClient.java:110

completeTeam

public Mono<Void> completeTeam(String namespace, String teamName)

执行 completeTeam 方法。

Marks the team completed (retention TTL; not immediate delete).

参数Parameters
名称Name类型Type说明Description
namespaceString命名空间（类型 `String`）。The namespace.
teamNameString团队名称（类型 `String`）。The team name.
返回Returns Mono<Void>
返回Mono。Returns mono.
源码Source io/agentscope/harness/agent/team/TeamClient.java:113
基于官方固定版本源码静态生成Generated from pinned official sources · Python 2.0.11 · Java 2.0.4
签名与文档为静态抽取；如有疑问请以源码为准。Signatures and docs are extracted statically; verify against the source when in doubt.