AS AgentScopeAPI 手册 / API Reference

TeamTool

public final class TeamTool
源码Source io/agentscope/harness/agent/tool/TeamTool.java:38–709

团队工具,封装可被智能体调用的能力。位于 io.agentscope.harness.agent.tool 包。核心成员包括 team、listTasks、listClaimableTasks、createTask、assignTask、claimTask。

Unified AgentTeams tool. Actions are gated by TeamContext#availableActions() (lead gets create/assign/spawn/shutdown/approve/complete; workers get list/claim/message).

构造器摘要Constructor Summary

构造器Constructor说明Description
public TeamTool(TeamClient client, TeamContext context)
初始化 `TeamTool` 实例。
Creates a new instance.

方法摘要Method Summary

方法Method说明Description
public String team(String action, String taskId, String subject, String description, String owner, Long expectedVersion, String result, String toMember, String content, Integer limit, String memberName, String agentRef, String prompt, String planText)
执行团队相关操作。
Performs the team operation.
public String listTasks()
列出任务。
Lists the tasks.
public String listClaimableTasks()
列出 `listClaimableTasks`。
Lists the claimable tasks.
public String createTask(String subject, String description, String owner)
创建任务。
Creates the task.
public String assignTask(String taskId, String owner, Long expectedVersion)
执行 `assignTask` 方法。
Performs the assign task operation.
public String claimTask(String taskId, Long expectedVersion)
执行 `claimTask` 方法。
Performs the claim task operation.
public String unclaimTask(String taskId, Long expectedVersion)
执行 `unclaimTask` 方法。
Performs the unclaim task operation.
public String failTask(String taskId, String reason)
执行 `failTask` 方法。
Performs the fail task operation.
public String completeTask(String taskId, String result)
执行 `completeTask` 方法。
Performs the complete task operation.
public String sendMessage(String toMember, String content)
发送消息。
Sends the message.
public String broadcastMessage(String content)
设置该参数。
Performs the broadcast message operation.
public String listMessages(Integer limit)
列出消息。
Lists the messages.
public String listMembers()
列出成员。
Lists the members.
public String spawnMember(String memberName, String agentRef, String prompt)
执行 `spawnMember` 方法。
Performs the spawn member operation.
public String shutdownMember(String memberName)
设置该参数。
Performs the shutdown member operation.
public String submitPlan(String planText, String memberName)
执行提交计划相关操作。
Performs the submit plan operation.
public String approvePlan(String memberName)
批准计划。
Performs the approve plan operation.
public String rejectPlan(String memberName)
拒绝计划。
Performs the reject plan operation.
public String completeTeam()
返回 `completeTeam` 结果。
Returns the complete team.

构造器详情Constructor Detail

TeamTool

public TeamTool(TeamClient client, TeamContext context)

初始化 TeamTool 实例。

Creates a new instance.

参数Parameters
名称Name类型Type说明Description
clientTeamClient客户端(类型 `TeamClient`)。The client.
contextTeamContext上下文(类型 `TeamContext`)。The context.
源码Source io/agentscope/harness/agent/tool/TeamTool.java:45–48

方法详情Method Detail

team

public String team(String action, String taskId, String subject, String description, String owner, Long expectedVersion, String result, String toMember, String content, Integer limit, String memberName, String agentRef, String prompt, String planText)

执行团队相关操作。

Performs the team operation.

参数Parameters
名称Name类型Type说明Description
actionString动作(类型 `String`)。The action.
taskIdString任务标识(类型 `String`)。The task id.
subjectString主题(类型 `String`)。The subject.
descriptionString描述(类型 `String`)。The description.
ownerString所有者(类型 `String`)。The owner.
expectedVersionLongexpected 版本(类型 `Long`)。The expected version.
resultString结果(类型 `String`)。The result.
toMemberString到成员(类型 `String`)。The to member.
contentString内容(类型 `String`)。The content.
limitInteger数量上限(类型 `Integer`)。The limit.
memberNameString成员名称(类型 `String`)。The member name.
agentRefString智能体引用(类型 `String`)。The agent ref.
promptString提示词(类型 `String`)。The prompt.
planTextString计划文本(类型 `String`)。The plan text.
返回Returns String
返回字符串结果。Returns a string.
源码Source io/agentscope/harness/agent/tool/TeamTool.java:50–221

listTasks

public String listTasks()

列出任务。

Lists the tasks.

返回Returns String
返回字符串结果。Returns a string.
源码Source io/agentscope/harness/agent/tool/TeamTool.java:225–242

listClaimableTasks

public String listClaimableTasks()

列出 listClaimableTasks。

Lists the claimable tasks.

返回Returns String
返回字符串结果。Returns a string.
源码Source io/agentscope/harness/agent/tool/TeamTool.java:244–266

createTask

public String createTask(String subject, String description, String owner)

创建任务。

Creates the task.

参数Parameters
名称Name类型Type说明Description
subjectString主题(类型 `String`)。The subject.
descriptionString描述(类型 `String`)。The description.
ownerString所有者(类型 `String`)。The owner.
返回Returns String
返回字符串结果。Returns a string.
源码Source io/agentscope/harness/agent/tool/TeamTool.java:268–298

assignTask

public String assignTask(String taskId, String owner, Long expectedVersion)

执行 assignTask 方法。

Performs the assign task operation.

参数Parameters
名称Name类型Type说明Description
taskIdString任务标识(类型 `String`)。The task id.
ownerString所有者(类型 `String`)。The owner.
expectedVersionLongexpected 版本(类型 `Long`)。The expected version.
返回Returns String
返回字符串结果。Returns a string.
源码Source io/agentscope/harness/agent/tool/TeamTool.java:300–329

claimTask

public String claimTask(String taskId, Long expectedVersion)

执行 claimTask 方法。

Performs the claim task operation.

参数Parameters
名称Name类型Type说明Description
taskIdString任务标识(类型 `String`)。The task id.
expectedVersionLongexpected 版本(类型 `Long`)。The expected version.
返回Returns String
返回字符串结果。Returns a string.
源码Source io/agentscope/harness/agent/tool/TeamTool.java:331–359

unclaimTask

public String unclaimTask(String taskId, Long expectedVersion)

执行 unclaimTask 方法。

Performs the unclaim task operation.

参数Parameters
名称Name类型Type说明Description
taskIdString任务标识(类型 `String`)。The task id.
expectedVersionLongexpected 版本(类型 `Long`)。The expected version.
返回Returns String
返回字符串结果。Returns a string.
源码Source io/agentscope/harness/agent/tool/TeamTool.java:361–384

failTask

public String failTask(String taskId, String reason)

执行 failTask 方法。

Performs the fail task operation.

参数Parameters
名称Name类型Type说明Description
taskIdString任务标识(类型 `String`)。The task id.
reasonString原因(类型 `String`)。The reason.
返回Returns String
返回字符串结果。Returns a string.
源码Source io/agentscope/harness/agent/tool/TeamTool.java:386–409

completeTask

public String completeTask(String taskId, String result)

执行 completeTask 方法。

Performs the complete task operation.

参数Parameters
名称Name类型Type说明Description
taskIdString任务标识(类型 `String`)。The task id.
resultString结果(类型 `String`)。The result.
返回Returns String
返回字符串结果。Returns a string.
源码Source io/agentscope/harness/agent/tool/TeamTool.java:411–435

sendMessage

public String sendMessage(String toMember, String content)

发送消息。

Sends the message.

参数Parameters
名称Name类型Type说明Description
toMemberString到成员(类型 `String`)。The to member.
contentString内容(类型 `String`)。The content.
返回Returns String
返回字符串结果。Returns a string.
源码Source io/agentscope/harness/agent/tool/TeamTool.java:437–456

broadcastMessage

public String broadcastMessage(String content)

设置该参数。

Performs the broadcast message operation.

参数Parameters
名称Name类型Type说明Description
contentString内容(类型 `String`)。The content.
返回Returns String
返回字符串结果。Returns a string.
源码Source io/agentscope/harness/agent/tool/TeamTool.java:458–476

listMessages

public String listMessages(Integer limit)

列出消息。

Lists the messages.

参数Parameters
名称Name类型Type说明Description
limitInteger数量上限(类型 `Integer`)。The limit.
返回Returns String
返回字符串结果。Returns a string.
源码Source io/agentscope/harness/agent/tool/TeamTool.java:478–497

listMembers

public String listMembers()

列出成员。

Lists the members.

返回Returns String
返回字符串结果。Returns a string.
源码Source io/agentscope/harness/agent/tool/TeamTool.java:499–516

spawnMember

public String spawnMember(String memberName, String agentRef, String prompt)

执行 spawnMember 方法。

Performs the spawn member operation.

参数Parameters
名称Name类型Type说明Description
memberNameString成员名称(类型 `String`)。The member name.
agentRefString智能体引用(类型 `String`)。The agent ref.
promptString提示词(类型 `String`)。The prompt.
返回Returns String
返回字符串结果。Returns a string.
源码Source io/agentscope/harness/agent/tool/TeamTool.java:518–539

shutdownMember

public String shutdownMember(String memberName)

设置该参数。

Performs the shutdown member operation.

参数Parameters
名称Name类型Type说明Description
memberNameString成员名称(类型 `String`)。The member name.
返回Returns String
返回字符串结果。Returns a string.
源码Source io/agentscope/harness/agent/tool/TeamTool.java:541–559

submitPlan

public String submitPlan(String planText, String memberName)

执行提交计划相关操作。

Performs the submit plan operation.

参数Parameters
名称Name类型Type说明Description
planTextString计划文本(类型 `String`)。The plan text.
memberNameString成员名称(类型 `String`)。The member name.
返回Returns String
返回字符串结果。Returns a string.
源码Source io/agentscope/harness/agent/tool/TeamTool.java:561–581

approvePlan

public String approvePlan(String memberName)

批准计划。

Performs the approve plan operation.

参数Parameters
名称Name类型Type说明Description
memberNameString成员名称(类型 `String`)。The member name.
返回Returns String
返回字符串结果。Returns a string.
源码Source io/agentscope/harness/agent/tool/TeamTool.java:583–602

rejectPlan

public String rejectPlan(String memberName)

拒绝计划。

Performs the reject plan operation.

参数Parameters
名称Name类型Type说明Description
memberNameString成员名称(类型 `String`)。The member name.
返回Returns String
返回字符串结果。Returns a string.
源码Source io/agentscope/harness/agent/tool/TeamTool.java:604–623

completeTeam

public String completeTeam()

返回 completeTeam 结果。

Returns the complete team.

返回Returns String
返回字符串结果。Returns a string.
源码Source io/agentscope/harness/agent/tool/TeamTool.java:625–642
基于官方固定版本源码静态生成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.