# 多任务并行 Agent Team（多智能体团队）是码道Agent Space的多智能体协作引擎。采用"Leader智能编排 + Teammate自主执行"的架构，将复杂开发任务拆解为可并行推进的子任务，由多个专业Agent像真实开发团队一样分工协作，自主完成从需求分析到代码交付的整条工作流。整个过程由事件驱动、全程可视，无需人工干预。 表1Agent Team与子智能体的对比 | 对比维度 | 子智能体 | Agent Team | |:---|:---|:---| | 上下文管理 | 每次调用独立上下文，任务完成即销毁 | 每位成员拥有持续化独立上下文，跨任务积累知识 | | 通信机制 | 仅能向主智能体单向报告结果 | 成员间双向自由通信，支持实时协作与共识收敛 | | 任务协调 | 主智能体统一分配、统一回收 | 共享任务池 + 自主认领，Team Leader仅做宏观编排 | | 团队组建 | 固定角色，任务前预置 | 动态组建，Team Leader根据需求按需增减成员 | | 故障恢复 | 子智能体失败需主智能体重新调度 | Team Leader自动监控，故障成员自动恢复替换 | | 适用场景 | 单一目标、关注最终输出的短时任务 | 多角色协作、需要持续互动的复杂工作流 | #### 核心能力 - **多角色协同**：多个专业Agent各司其职，模拟人类开发者的分工合作。 - **全流程覆盖**：自动衔接需求分析与代码交付，打造端到端的完整工作流。 - **智能协作**：打破单点智能局限，通过团队配合提升开发效率与代码质量。 #### Agent Team团队架构 一个Agent Team，通常由如下组件组成。 表2Agent Team团队架构组件说明 | 组件名称 | 定义与作用 | |:---|:---| | 多智能体团队（Agent Team） | 由多个专业化Agent组成的协作型工作单元，具备任务分解、协同执行能力。 | | 团队领导（Team Leader） | 核心调度者，负责任务规划、资源分配、进度监控及成员协调，可动态创建子智能体。 | | 团队成员（Teammate） | 执行具体任务的专职Agent，成员间可相互通信。 | | 角色（Role） | 定义Agent的专业职能标签（如分析师、开发者），同一个Role可以同时生成多个Teammate分身。 | | 场景（Scene） | 预定义的任务上下文环境，包含目标、约束条件、输入输出格式等，用于引导团队行为。 | | 子智能体（Subagent） | 由Team Leader临时创建的专项任务执行者。 | | 任务列表（Task List） | Team Leader维护的全局待办清单，按优先级/依赖关系排序，驱动整个团队工作流。 | | 待办事项（To-Do） | 单个Agent内部的任务追踪项，用于记录当前处理状态。 | #### 使用Agent Team生成代码 1. 切换到AgentTeam模式。 1. 参考[开启Space模式](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0006.html#codeartsagent_ug_0006__section183281754460)操作，进入码道Agent Space。 2. 单击"代码开发"，切换到代码开发页签。 3. 在聊天界面的输入框下方选择"AgentTeam"，切换到**AgentTeam**模式。右侧显示当前选用的模型，您可在下拉框中切换不同大语言模型。 2. **输入需求** **。** 在对话框输入您想要完成的任务，单击发送图标 ![](https://support.huaweicloud.com/usermanual-codeartsagent/zh-cn_image_0000002723873271.png)或使用"Enter"快捷键发送。 ``` 做一个记录睡眠质量的小程序，请先分析国内市场上现有产品并总结出优缺点，然后开发一个有功能特色的小程序 ``` 3. **创建任务并分派Teammate。** 团队领导（Team Leader）接收到任务指令后，会将这个总目标分解成多个更小、更具体的子任务。并根据子任务的性质，动态地创建和分配对应的团队成员（Teammate），同时生成一个Task List（任务列表）。任务列表中包含并行或串行的子任务。 图1拆解并分配任务 ![](https://support.huaweicloud.com/usermanual-codeartsagent/zh-cn_image_0000002747289163.png "点击放大") - 切换到可视化模式：单击会话窗口顶部菜单栏中的 ![](https://support.huaweicloud.com/usermanual-codeartsagent/zh-cn_image_0000002694233870.png)，即可从对话模式切换到可视化模式。此模式直观展示了任务分派的上下游关系，您可以清晰地识别任务的依赖结构，了解各节点之间的数据流向和执行顺序。当需要关注特定子Agent的工作进展时，只需将鼠标悬停在节点上，即可通过悬浮弹窗快速查看其实时工作状态。单击弹窗中的跳转到对话图标 ![](https://support.huaweicloud.com/usermanual-codeartsagent/zh-cn_image_0000002694393758.png)，即可快速定位至子任务的执行会话窗口。 - 查看任务概览：单击会话窗口顶部菜单栏中的 ![](https://support.huaweicloud.com/usermanual-codeartsagent/zh-cn_image_0000002724033215.png)，在"任务概览"中可查看本次任务耗时、已完成任务数、子Agent个数等信息。 - 查看任务列表：单击会话窗口顶部菜单栏中的 ![](https://support.huaweicloud.com/usermanual-codeartsagent/zh-cn_image_0000002694233886.png)，在"任务列表"中可查看本次会话任务的Task List（任务列表）。 ![](https://support.huaweicloud.com/usermanual-codeartsagent/public_sys-resources/note_3.0-zh-cn.png) ![](https://support.huaweicloud.com/usermanual-codeartsagent/zh-cn_image_0000002694393770.png) 表示任务已完成，![](https://support.huaweicloud.com/usermanual-codeartsagent/zh-cn_image_0000002723873299.png) 表示任务进行中，![](https://support.huaweicloud.com/usermanual-codeartsagent/zh-cn_image_0000002724033227.png "点击放大") 表示任务未启动。 - 查看任务交付件：单击会话窗口顶部菜单栏中的 ![](https://support.huaweicloud.com/usermanual-codeartsagent/zh-cn_image_0000002694233892.png)，在"任务产物"中可查看本次会话任务最终的输出件。单击生成的文件，在"文档"或"编辑器"中可查看文件的具体内容。 ![](https://support.huaweicloud.com/usermanual-codeartsagent/public_sys-resources/note_3.0-zh-cn.png) 任务执行完成后，需要您先完成输出文件的接收确认，对应文件才会在此处显示。 - 查看上下文信息：单击会话窗口顶部菜单栏中的 ![](https://support.huaweicloud.com/usermanual-codeartsagent/zh-cn_image_0000002694393776.png)，在"上下文信息"中可查看本次会话任务所调用的技能及MCP工具详情。 - 查看上下文使用量：单击会话窗口顶部菜单栏中的 ![](https://support.huaweicloud.com/usermanual-codeartsagent/zh-cn_image_0000002723873301.png)，在"上下文使用率"中可实时查看本轮会话的上下文使用率（即已使用的Token占比），帮助您直观掌握当前上下文用量，避免因超出限制影响会话的连贯性。 4. **团队成员协同执行** 。Team Leader将Task List中的每个子任务分发给对应的团队成员时，会为每个Teammate动态地组建其身份/角色，并生成一个专门的提示词（Prompt），以确保它能准确理解并执行该特定任务。团队成员收到自己的任务后，会进一步将其拆解为自己需要完成的具体待办事项（To-Do）。每个Teammate根据其To-Do的需求，调用相应的工具，来增强自身能力，完成复杂操作。 如果需要查看子任务执行情况，请单击相关任务项，即可自动跳转至对应子任务页面。 图2查看子任务执行进度 ![](https://support.huaweicloud.com/usermanual-codeartsagent/zh-cn_image_0000002747216849.png "点击放大") 5. **查看并确认结果。** 每个子任务完成后，执行结果会反馈至Team Leader。由Team Leader统一收集产出，经过验证后，整合生成最终的项目总结报告。 图3子任务反馈执行结果至Team Leader ![](https://support.huaweicloud.com/usermanual-codeartsagent/zh-cn_image_0000002717777752.png "点击放大") - 在编辑器查看与处理生成文件：在"编辑器"中，检视生成的文件内容。单击某段内容上的"保留"（快捷键Ctrl+Y）接受生成内容，单击"撤消"（快捷键Ctrl+N）拒绝生成内容。在文件最下方单击"保留"（快捷键Ctrl+Enter）或"撤消"（快捷键Ctrl+Delete），即可一键接受或拒绝生成的文件。您也可以直接基于现有内容进行修改。 ![](https://support.huaweicloud.com/usermanual-codeartsagent/public_sys-resources/note_3.0-zh-cn.png) 如果没有正常显示编辑器，请在顶部菜单栏的右上方，单击**切换工具可见性** 图标 ![](https://support.huaweicloud.com/usermanual-codeartsagent/zh-cn_image_0000002723873303.png)，打开工具。在打开工具中，单击"编辑器"即可。 - 在文件暂存区查看与处理生成文件：将鼠标移至文件所在行，单击右侧 ![](https://support.huaweicloud.com/usermanual-codeartsagent/zh-cn_image_0000002724033231.png)接受文件，单击 ![](https://support.huaweicloud.com/usermanual-codeartsagent/zh-cn_image_0000002694233896.png)拒绝文件。如果存在多个文件可以直接单击"全部接受"，接受全部文件，或者单击"全部拒绝"，拒绝全部文件。 #### 创建团队模板 在码道Agent Space中，使用/save-team命令可将已完成任务中的角色（Roles）与场景（Scene）封装为可复用模板。后续创建新任务时，直接调用该模板即可，无需重新规划。 1. 参考[使用Agent Team生成代码]操作，完成任务的执行。 2. 单击对话输入框中的 ![](https://support.huaweicloud.com/usermanual-codeartsagent/zh-cn_image_0000002694393780.png)，选择"快捷指令"，在弹出的菜单中选择"/save-team"命令。 3. 输入待创建团队的名称（如new-dev-team），单击发送图标 ![](https://support.huaweicloud.com/usermanual-codeartsagent/zh-cn_image_0000002723873305.png)。 /save-team命令语法格式为"/save-team 团队名称"，其中团队名称用户可自定义。如果需要更新已有的团队模板，请执行"/save-team 待更新的团队名称"。 4. 查看生成的角色和场景文档。 任务创建成功后，您可以在"编辑器 \> 资源管理器"中查看生成的文档： - 角色文档位于项目文件夹的".codeartsdoer/agent-team/roles"目录下。 - 场景文档位于项目文件夹的".codeartsdoer/agent-team/scene"目录下。 图4查看生成的角色和场景文件 ![](https://support.huaweicloud.com/usermanual-codeartsagent/zh-cn_image_0000002724033233.png "点击放大") 5. 基于生成的角色和场景文档，创建新任务。 在输入框中如下指令（需要指定[3]中创建的团队名称），单击发送图标 ![](https://support.huaweicloud.com/usermanual-codeartsagent/zh-cn_image_0000002694233898.png)。 ``` 使用new-dev-team创建一个儿童哄睡小程序 ``` 收到指令后，AI会基于模板中的角色与场景开始构建任务。 #### 获取Agent Team日志 在使用Agent Team进行代码开发时，若遇到执行异常或报错，请参照以下步骤获取日志以定位问题。**如下操作仅适用于Windows和macOS操作系统。** 获取方法：进入本地"%USERPROFILE%/.codeartsdoer/codearts-data/log"路径，打开如下文件，搜索agent-team关键字，即可查看到Agent Team相关日志。 图5查看Agent Team日志 ![](https://support.huaweicloud.com/usermanual-codeartsagent/zh-cn_image_0000002694393782.png "点击放大")