使用 Team 任务

基本概念

准备工作

• 已能登录 AgentCore App，并访问目标团队。

• 团队已配置 Leader，需要协作时已加入相应 Worker。

• 执行 Agent 已具备完成任务所需的模型、工具和访问权限。Agent 的配置方式参见使用托管 Harness。

• 验收操作需要评审人身份。本示例采用手动创建，默认将当前登录用户设为评审人，满足验收身份要求；各身份的操作权限详见权限说明。

• 如需将结果投递到指定会话，Channel、房间、对象标识由管理员提供，配置方式见配置回复路径。

步骤一：创建任务

1. 打开任务看板，单击新任务，选择手动创建；其他创建入口见创建任务。

2. 选择执行团队，填写任务标题和内容：

   • 标题：短句，例如“项目启动会议方案”。

   • 内容：包含目标与交付要求，例如，为产品、研发和测试制定一份 60 分钟的项目启动会议方案，提交 Markdown 格式的议程和各角色会前准备清单。

3. 单击创建任务。创建后，看板已创建分组中出现任务卡片，并进入任务房间跟进执行。

步骤二：跟进执行

1. 从看板已创建或执行中分组找到任务并打开详情。

2. 打开任务聊天查看 Leader 的执行消息；需要补充信息时，向当前任务发送消息并 @ 对应 Agent。

3. 任务已拆分时，在任务信息面板查看子任务及其依赖关系；详情页各区域的说明见查看任务详情。

4. 查看事件了解任务的关键变化。

步骤三：查看结果并验收

1. 任务进入待验收后，从任务聊天打开结果卡片。

2. 阅读结果说明，预览或下载提交的文件。

3. 检查议程总时长、内容完整性和准备清单是否满足要求。

4. 满足要求时，执行卡片上的验收操作；需要修改时，填写具体修改意见并发送，操作详见验收或提出修改意见。

   验收通过后，任务变为已完成。提出修改意见后，团队继续处理，并重新提交结果供检查。

对话创建

向 Leader 描述需求，并明确提出创建任务。既可以直接私聊 Leader，也可以到团队聊天 @ Leader，说明要完成的工作、期望结果和验收要求。Leader 根据需求创建任务；信息不足时，可以继续通过对话补充。

例如：“请创建一个任务，制定一份 60 分钟的项目启动会议方案，包含会议议程和各角色的会前准备清单，最终提交 Markdown 文件。”

任务创建后，后续执行转入对应的任务房间推进。根据 Leader 回复中的任务信息，或从任务看板打开任务，进入任务房间跟进进度、补充信息和查看结果。是否已经创建成功，以任务记录为准；新创建、尚未开始执行的任务可以从看板已创建分组确认。

手动创建

1. 打开任务看板，单击新任务，选择手动创建。

2. 填写任务标题和内容，选择执行团队，并按需设置优先级。

3. 单击创建任务。创建后，所选团队的 Leader 进入对应任务房间组织执行。

   手动创建默认将当前登录用户设为评审人。需要在指定会话接收结果时，可以配置回复路径。

新任务窗口也提供AI 创建入口，实质是手动创建窗口内转入对话创建的入口：选择 Leader 并描述需求后，App 会进入与该 Leader 的对话，由其继续完成任务创建。可以自行填写任务信息，也可以通过这个入口交给 Leader 整理。

配置回复路径

仅当需要把结果投递到指定会话时，才展开手动创建窗口的添加回复路径；不清楚字段如何填写时，可联系管理员协助。

Matrix 是 AgentCore App 内聊天使用的通信服务。房间和对象需要使用系统分配的完整标识，而不是会话名称或用户昵称；这些配置值可由管理员提供，普通使用无需了解标识格式。结果投递的渠道与接收方式见接收结果回调。

使用任务看板

任务看板按工作状态组织任务。

待确认是看板分组名称，不是单一任务状态。查看卡片上的状态标签，可以区分是等待验收，还是需要处理阻塞或失败。

搜索和筛选

• 使用搜索任务输入关键词查找任务。

• 通过团队下拉框缩小查看范围。

• 勾选只看我创建的，查看由当前账号创建的任务。

• 切换活跃任务和归档任务，查找不同归档状态的任务。

• 需要重新获取列表时，单击刷新按钮。

查看任务详情

打开任务后，页面包含任务聊天和任务信息面板两个区域。任务聊天展示执行消息、协作讨论、结果卡片，以及与 Agent 的交流；任务信息面板包含以下子区域：

详情中的指派人表示被指派执行该任务的 Agent。Task ID 可用于向管理员反馈问题。

任务沟通

需要补充背景、说明限制或询问进度时，向当前任务聊天发送消息。希望某位 Agent 处理时，@ 该 Agent；整体计划和交付问题优先与 Leader 沟通。

尽量把同一任务的补充信息保留到任务聊天，便于团队围绕同一份要求推进。修改交付要求时，应说明具体变化以及原要求是否仍然有效。

例如：

@Leader 请将会议方案中的风险讨论增加到 15 分钟，总时长仍保持 60 分钟。
请相应调整其他环节，并在最终说明中列出调整内容。

查看子任务和依赖关系

Leader 拆分工作后，可以通过子任务依赖图查看各项工作的状态和执行顺序。子任务显示为未开始不一定异常；存在前置依赖时，需等前置工作满足条件后才会开始。

拆分、指派和推进由团队组织。可以通过聊天提出要求，并通过依赖图和事件记录了解进度。

理解任务状态

有聊天回复、文件出现或某个子任务完成，都不等于整体任务完成。整体进度以任务状态和正式提交的结果为准。

查看结果和文件

正式提交的结果通过结果卡片展示，包含结果说明和关联文件。卡片内可预览支持的文件，也可以下载到本地检查；也可以通过任务信息面板的文件查找相关文件。

文件列表中可能同时存在过程文件和结果文件。验收时，优先检查当前结果卡片关联的文件，避免把早期版本当作最终结果。

验收或提出修改意见

检查结果后，可以选择接受结果，或提出修改要求。操作权限见权限说明。

需要修改时，请通过结果卡片填写具体意见，例如：

议程总时长符合要求，但会前准备清单缺少测试角色的材料要求。
请补充测试范围、环境和风险清单，并重新提交完整文件。

发送修改意见后，任务返回执行流程。团队修改并重新提交后，再检查新结果。

对于需要验收的任务，通过聊天表达认可不能替代卡片上的正式验收操作；外部渠道评审人代为处理验收的方式见权限说明。

接收结果回调

任务完成及状态变化的消息会投递回发起任务的来源会话，包括 App 内聊天（Matrix）以及钉钉、飞书等即时通信工具（IM）。原会话即可接收通知，跟进任务进度并查看结果。未配置回复路径时，直接通过任务聊天查看和验收结果；需要投递到指定会话时，配置方式见配置回复路径。

任务操作

任务卡片或详情页会根据当前状态显示可用操作。执行前请阅读确认提示。

各项操作需同时满足身份权限和任务状态条件，具体见权限说明。存在未处理的待验收子任务时，应先处理相关结果。

权限说明

任务的查看、管理和验收权限分别判断。下表面向 App 用户；同一用户可以同时具有多个身份，操作还需满足上表中的任务状态条件。

• 验收身份独立：仅有查看或管理权限，不代表能验收结果。通过外部 IM 指定的评审人，可在对应会话给出明确意见，由执行 Agent 代为处理验收，并确认任务状态已经更新；这不会自动授予 App 内的任务访问或管理权限。

• 团队与任务成员不同：属于某个团队不代表能访问该团队的所有任务；以当前任务的可见范围为准。

• 上下级任务分别授权：参与上级任务不会自动获得下级任务的访问或操作权限，需要分别加入相应任务。

• 页面按钮不是授权依据：是否允许操作以当前账号权限和任务状态的校验结果为准。访客不能执行写操作。

适用场景

当一项工作需要多个专业团队配合时，可以由上级团队统一协调多个下级团队。例如，产品发布准备需要产品团队整理发布内容、研发团队提供变更说明、测试团队提交验证结论，再由上级团队汇总发布材料。

协作方式

上级团队承接整体目标，拆分需要各专业团队完成的工作。承担协调职责的 Agent 既可以作为上级团队的 Worker，也可以同时作为下级团队的 Leader，组织对应团队完成工作。

同一个 Agent 归属不同团队时可以承担不同角色。多团队协作需要提前配置相应团队和成员关系。

如何发起和跟进

1. 选择负责整体协调的上级团队，创建任务。

2. 说明整体目标、交付要求和各专业方向需要覆盖的内容。

3. 由上级团队组织分工；具体工作可以直接完成，也可以通过下级团队协作完成。

4. 从上级任务跟进整体进度、提出补充要求并查看最终结果。

5. 需要了解某个下级团队的细节时，在具备访问权限的前提下查看对应任务。

   示例需求：

请统筹本次产品发布准备，组织完成发布内容、技术变更说明和测试结论，
最终提交一份统一的发布检查清单。
请注明每项工作的结论、相关文件和仍未解决的问题。

结果与操作边界

下级团队的结果由承担协调职责的 Agent 交回上级，上级团队再按整体要求整理和提交最终结果。某个下级任务完成，不代表整体任务已经完成，应检查上级任务提交的结果。

上下级任务具有各自的执行状态。暂停、取消或恢复上级任务时，不应假定下级团队任务会自动执行相同操作；应由上级团队确认各项工作的实际状态。跨团队访问规则见权限说明。

下级工作发生阻塞或失败时，可以通过上级任务要求 Leader 说明影响和后续安排。页面的子任务依赖图用于查看当前任务内的拆分关系，不作为所有下级团队任务的完整总览。