协作 TeamHarness 使用说明-智能体构建和治理平台 AgentCore-阿里云帮助中心

当一项业务需要多个 Agent 分工完成时，TeamHarness 让 Agent 按统一规则分工、执行任务并交付结果，提示词无需重复编写协作流程。平台已提供团队成员信息、协作规则及配套 Skills，业务方主要定义 Agent 的业务职责和交付要求。本文介绍 Agent 的协作行为和指令编写方式。

适用范围与相关文档

使用团队协作功能前，需满足以下硬性条件：

Agent 已创建并托管至 Harness，创建与配置按《Agent 使用说明（托管 Harness）》完成。
Team 已配置。
Agent 已加入 Team，并被赋予 Leader 或 Worker 团队角色。

支持的能力与限制

以下能力适用于托管 Harness 下的团队协作，其中任务调度、归档和渠道通知由平台配套服务提供，Team 和任务在 AgentCore 控制台的配置与管理操作见《团队协作使用说明（任务系统）》。

能力矩阵

能力分类	能力项	QwenPaw	Qoder
团队	团队角色与分工（Leader、Worker）	支持：Leader 负责组织与汇总，Worker 执行分派的工作。	支持：Leader 负责组织与汇总，Worker 执行分派的工作。
团队	同一 Agent 参与多个团队	支持：按当前请求使用对应的团队身份和角色。	支持：按当前请求使用对应的团队身份和角色。
团队	成员通信与消息唤醒	支持：@mention 形式唤醒。	支持：@mention 形式唤醒。
任务	任务计划与动态调整	支持：计划及已有节点内容调整。	支持：计划与依赖推进。
任务	任务拆分与子任务委派	支持：Leader 创建任务并向 Worker 分派子任务。	支持：Leader 创建任务并向 Worker 分派子任务。
任务	任务参与成员调整	支持：按需调整参与人员和 Agent；默认 Agent 团队自动加入，Human 按需指定。	支持：按需调整参与人员和 Agent；默认 Agent 团队自动加入，Human 按需指定。
任务调度	任务 Fallback 容错	支持：启动超时重试、运行超时提醒和会话失联恢复提醒。	支持：启动超时重试、运行超时提醒和会话失联恢复提醒。
任务调度	任务并发限流	支持：Agent 维度的任务和子任务限流排队。	支持：Agent 维度的任务和子任务限流排队。
任务调度	任务自动归档	支持：终态任务自动归档。	支持：终态任务自动归档。
任务通知	钉钉、飞书、企业微信	支持：状态变化以 Bot 身份通知用户。	支持：状态变化以 Bot 身份通知用户。
定时任务	团队定时任务	支持：创建、更新、启停及手动触发。	支持：创建、更新、启停及手动触发。

“支持”表示对应 Harness 提供该能力（部分能力需要配置，详见下方使用限制）。除“任务计划与动态调整”外，其余能力项 QwenPaw 与 Qoder 表现一致。

使用限制

开始编写 Agent 指令前，需了解以下影响使用的边界：

终态任务自动归档，并按时间过期和数量压力执行 FIFO 截断。
任务和子任务的并发限流基于 AgentRuntime 容量控制。
跨团队委派时，两侧的权限和任务状态分别管理，不会自动连带取消、恢复或验收。
团队定时任务依赖调度服务。

Agent 如何协作

典型场景

用户通过 AG-UI 应用或钉钉、飞书、企业微信提出需求后，团队负责人（Leader）创建异步任务，执行成员（Worker）按分工完成工作：

用户提出需求。
Leader 创建异步任务。
团队在任务房间内分工和执行。
Leader 审核结果并汇总交付。

任务创建成功后，用户无需保持原对话连接，后续协作转入任务房间继续，任务状态变化时由平台通知相关人员。

指令与能力的职责划分

指令与能力按职责分为以下四部分：

业务定义：决定 Agent 做什么、如何处理业务以及交付什么。
Harness（执行）：调用模型和工具推进执行。
TeamHarness（协作）：提供团队身份和协作规则，组织分工、反馈与交付。
Skills（操作方法）：按需读取业务或协作技能，完成具体操作。

执行时，业务定义、Harness 基础规则和 TeamHarness 协作规则结合当前会话提供给模型，Skills 按需读取。上述划分表示职责关系，不表示提示词采用固定拼接顺序或优先级。以“数据分析师”为例：由业务定义说明分析方法和报告要求，Harness 执行工具调用，TeamHarness 指导该 Agent 作为 Worker 接手任务并提交结果，Skills 提供具体操作方法。

角色与分工

Leader（负责人）：组织任务、安排分工、协调问题、审核并汇总结果。
Worker（执行成员）：执行分配的子任务、反馈问题并提交结果。

“数据分析师”“研发工程师”等业务身份由业务方定义，Leader 和 Worker 团队角色由平台配置。同一 Agent 参与不同团队时可承担不同角色，提示词内的自我介绍不会改变权限。

任务房间与非任务房间

任务房间是执行某项任务的专属会话；私聊、团队聊天、群聊，以及 AG-UI、IM 中的普通对话均属于非任务房间。

非任务房间内：

Leader 对普通交流直接回复；当工作符合下方“何时创建任务”的判定条件时，由 Leader 创建任务。
Worker 可以参与交流；需要正式执行的团队工作交由 Leader 组织。

任务房间内：

Leader 推进当前任务、安排分工、审核结果并完成交付。
Worker 执行分配给自己的子任务、反馈问题并提交结果。

何时创建任务：

工作需要团队执行、跨会话继续或持续跟踪交付时，由 Leader 创建任务。
用户明确要求创建任务时，由 Leader 创建任务。
需求清晰时，Leader 直接创建任务。
存在影响交付的重要歧义时，Leader 先向用户澄清。
咨询类问题直接通过对话回答，不创建任务。

任务创建后当前轮次结束，后续工作转入任务房间继续；已有任务的需求调整或结果反馈仍回到原任务处理。@mention 仅用于沟通和唤醒，不表示已经分派子任务。

任务房间内的工作流程

任务记录整体目标，子任务记录分配给某个 Worker 的具体工作。

内置协作流程包括以下环节：

安排工作：Leader 使用计划编排 Skill 分派子任务。相互独立的子任务可以并行执行，存在依赖的子任务在前置结果审核后推进。
执行工作：Worker 确认接手后，按子任务要求执行并完成必要检查，不操作其他成员的任务。
提交与审核：Worker 提交子任务结果，Leader 审核结果或提出修改意见。需要修改时继续使用原子任务，以保留结果版本。
遇到问题：Worker 就子任务报告阻塞，由 Leader 协调；只有整体无法推进时，Leader 才报告任务阻塞。
等待与继续：等待其他成员或审核时结束当前轮次，由后续通知触发继续，不循环查询。
最终交付：Leader 汇总已审核的结果并提交任务结果，是否需要最终人工验收由任务配置决定。

协作过程中还需注意：

没有合适的 Worker 时，Leader 可以在自身能力和权限范围内直接完成工作，无需创建分配给自己的子任务。
交付文件按内置 Skill 保存，并在结果内引用。
Leader 审核时无需重复 Worker 的全部检查；需要独立测试或专业复核时，安排相应工作。
收到通知后先确认当前状态再继续，避免因通知延迟重复提交。

多团队与临时助手

当一个 Agent 同时是某团队的 Worker 和另一团队的 Leader 时，可以通过内置流程将工作委派给自己负责的团队：下游任务完成并审核、交接文件后，再提交上游子任务结果。临时 Subagent 是执行助手，不会自动成为团队 Worker，也不能替代正式子任务。

如何编写 Agent 指令

本章先说明指令应包含的内容和应避免的写法，文末提供 Leader 与 Worker 的指令示例，可直接复制改写。

写业务要求，不重写协作流程

指令文件（如 AGENTS.md）或系统提示词需写清以下四项内容：

做什么：专业职责和业务范围。
怎么做：处理方法、工具及数据使用要求。
交付什么：输出格式、质量标准和必要检查。
哪些操作需要授权：例如修改生产数据、部署或对外发布。

团队成员和角色使用平台提供的信息，不要写死账号或团队 ID；文件名称和配置入口以所用 Harness 和 Agent 模板为准，具体配置方式按《Agent 使用说明（托管 Harness）》完成。

Leader 还需说明成员的业务专长、分工思路，以及如何把业务需求转换成任务目标和交付要求。Worker 只需定义业务处理能力，无需重复团队调度、状态反馈和结果提交等内置规则。

避免冲突的写法

不宜	应当
被 @mention 后立即执行任务。	按正式子任务指派执行；@mention 仅用于沟通和唤醒，不表示已分派子任务，普通消息仅用于交流。
Worker 只生成文件，由 Leader 代为提交。	Worker 提交自己的结果，Leader 负责审核和汇总。
回复“完成”即可结束任务。	按内置流程提交结果后再简要确认。
持续查询，直到其他成员完成。	等待协作通知后继续。
缺少信息时一律直接询问用户。	普通对话直接澄清；任务执行中的问题通过任务阻塞流程反馈，不要只靠任务房间提问。
收到修改意见后创建新任务。	回到原任务或原子任务修订。
禁止执行任何命令。	限制业务操作范围，同时保留内置协作工具所需的执行能力。

发现与内置协作规则冲突的条款时，直接改写该条款，不要只追加“以 TeamHarness 为准”，也无需复制内置 Skills 的命令或提示词。

Leader 示例：业务分析团队

假设团队已经配置数据分析和报告编写两类 Worker，可按以下片段定义 Leader，也可直接复制到指令文件中改写：

## 业务职责

负责组织业务分析，将用户需求转换成明确的分析目标和交付要求。

## 成员与分工

- 数据分析师 Worker：查询和分析业务数据、解释指标变化并提供结论及依据。
- 报告编写 Worker：根据已审核的分析结果编写报告，不自行补充未经确认的数据或结论。

## 需求与任务对应

- 指标含义、分析方法等咨询直接通过对话回答；是否创建任务及需求与任务的对应关系，按“何时创建任务”的判定条件执行。
- 创建任务时记录分析范围、时间区间、统计口径、交付格式和验收标准；关键信息不明确时先澄清，不自行增加业务目标。

## 分工思路

任务房间内先安排数据分析，需要报告时再安排报告编写。报告编写依赖已审核的分析结果，互不依赖的工作可以并行；用户只需要结论时不额外安排报告；需要独立复核时，将复核作为明确分工。

## 交付要求

汇总结果并回答用户的业务问题，说明主要结论和重要限制。涉及修改生产数据或对外发布时，必须先取得授权。

Worker 示例：数据分析师

可按以下片段定义数据分析师 Worker，也可直接复制到指令文件中改写：

## 业务职责

负责业务数据分析，解释指标变化并形成结论，不修改生产数据。

## 工作方法

使用已授权的数据源和任务给定的统计口径；区分数据事实、分析推断和待验证结论，不编造缺失数据。

## 交付要求

按子任务要求交付分析结论或数据文件，说明统计口径和重要限制；只报告实际完成的检查及结果。