专家团

专业模式和办公模式统一称为 专家团。主控负责分工、复核和汇总，成员 Agent 按各自职责完成主控委派的任务。

专家团在一条会话中由主控调用成员完成协作，成员不再委派其他成员。画布连线用于表达主控关系；成员间消息和共享任务板不属于这套编排流程。

创建和使用范围

私人专家团支持生成分享链接并导入，也可公开到用户分享市场。专家团当前不支持外部嵌入；外部嵌入适用于单个专家。

在画布中组队

1. 从专业模式侧栏进入独立的“专家团”页面，点击“新建专家团”；也可以在“场景专家”页面点击“组建专家团”，勾选成员后点击“组成专家团”。
2. 从左侧把 Agent 拖到画布，或点击卡片加号。成员必须是已启用的单个 Agent，数量为 2–32，不能重复或嵌套团队。
3. 在“团队设置”中填写专家团名称、简介和可选的协作示例，右侧可以预览。点击主控节点的“编辑”设置“主控工作安排”；“这个团队负责什么”用于介绍团队，主控工作安排用于指导执行。
4. 点击成员节点查看配置，或点击“编辑”修改团队内的角色与职责。取消编辑会丢弃本次表单修改。需要修改原 Agent 的模型、账号或能力时，从查看面板进入“编辑原 Agent 配置”。
5. 点击“保存编排”，或点击“保存并试运行”。已有的连接器授权自动复用；缺少授权时可在依赖面板直接连接账号。

画布使用点阵背景和动态连线，可以拖动节点调整显示位置，或点击“自动排列”恢复布局。保存编排后会保留节点位置。连接表示主控协调关系，不表示固定执行顺序或工作流依赖。实际是否并行、何时调用成员，由主控结合任务和可用能力决定。

通过节点上的移除按钮，或将成员拖到画布中的移除区域，可以把成员移出当前团队草稿；保存编排后生效，不会删除来源 Agent。窄屏仍使用画布，可收起成员列表、平移和缩放查看节点。

编辑页回填已保存的团队快照，并展示版本与未保存状态。保存时采用来源 Agent 的当前配置，并生成不可变团队快照。来源停用或删除后，私人团队的编辑器会提示移除不可用成员；并发编辑发生版本冲突时，保存会明确报错。

团队列表、新建和编辑页面统一归属于 /agent-teams。单个专家继续在“场景专家”页面管理；开始协作后使用现有对话页面。

开始协作

专家团使用独立开始页 /agent-teams/{agentId}，展示团队介绍、任务输入和成员分工。专业模式页面可进入编排，办公页面沿用办公模式的背景和输入区样式，仅提供使用入口。两种页面都复用现有任务创建和对话链路，不改变主控与成员的执行方式。

在“团队设置”或后台公共模板表单中，可添加最多 8 条协作示例，支持调整顺序和删除。示例为空时开始页隐藏该区域，不显示空白占位。示例与编排一起保存；公共模板安装和升级同步其示例。

点击示例只填写输入框，不会立即运行；已有文字时先确认替换，已上传附件保持不变。“使用设置”关闭后重新检查授权和模型设置，保留正在编辑的任务内容。授权缺失、检查失败或团队停用时不能发送任务，页面显示具体状态。

团队列表与头像

专业模式侧栏的“场景专家”和“专家团”分别查询单个专家与团队；模式标识为“专家模式”，“传统模式”保持不变。团队列表使用独立的 GET /api/v1/agent-teams 接口，只返回展示摘要，不携带完整编排或逐一查询成员。办公选择器、定时任务和 API 访问中的团队选项使用相同接口，需要配置时再读取详情。

创建团队或保存编排时，后端按成员顺序取前 9 位头像，生成微信群式排列的自包含 SVG 并存入对象存储。未设置头像的成员显示名称首字。成员单独更换头像后，下一次保存团队编排时更新组合图。公共模板安装、升级沿用对应模板的 SVG。

模型选择

团队的主控与成员沿用现有账号可用模型配置，支持账号自定义模型。

• 编辑页顶部“使用设置”或主控编辑面板中的主编排模型只控制主控的分工、复核与汇总，单独保存，不包含在顶部的“保存编排”中。
• 未指定主编排模型时，跟随账号在该模式的默认模型。
• 新建团队对话可以选择模型；会话空闲时可以切换，正在运行时不能切换。
• 定时任务和团队 API 密钥可以指定各自模型；未指定时跟随团队设置。
• 私人团队成员在每次运行前读取各自 Agent 在当前模式的模型设置，转换为实际模型名称，作为该成员当次运行的实际模型。切换主编排模型不会覆盖成员模型。
• 公共模板没有预设模型字段。成员对应的专家已由当前用户安装时，使用该 Agent 的模型；其余成员使用当前用户的模式默认模型。不会读取模板作者的模型账号或凭证。

已保存的模型失效或用户失去使用权限时，执行前按现有模型权限规则解析为当前用户的模式默认模型。用户通过接口主动提交无权限的模型选择仍会被拒绝。历史运行的团队详情展示当次实际解析的主编排与成员模型。

普通 Agent 的既有模型绑定规则不变。

连接器授权

公共团队只声明所需连接器，不包含模板作者的个人凭证。安装和使用时优先复用已保存的有效选择，否则使用当前用户的默认账号或唯一可用账号；多个账号无法确定时选择一次并保存。同一连接器的缺失项合并显示，已就绪的账号无需重复选择。

缺少授权时，依赖面板复用连接器页面的 OAuth 弹窗或凭证表单。授权完成后重新检查依赖；取消或失败不会提交团队配置。没有可用连接器定义时仍需管理员处理。

私人团队成员使用来源 Agent 为同一连接器配置的账号。修改来源 Agent 的账号选择后，后续运行自动读取；如删除了团队仍需要的连接器，先更新来源 Agent 或重新保存团队编排。增删成员能力需要重新保存编排，不会自动改变已保存的能力边界。

来源 Agent 被删除后，已保存的成员快照与仍有效的账号绑定继续可用；成员模型使用当前账号默认值。再次编辑编排时需要移除不可用来源。

已开始的运行固定使用创建时解析的账号和模型，更新设置不会中途改变其执行身份。

定时任务

创建任务时，在“执行方式”中选择自由模式、单个 Agent 或团队。团队成员、角色、技能和连接器配置通过团队快照查看；模型、时间、提示词、通知和任务联动继续使用现有设置。

团队任务保存后固定成员和能力快照，成员模型及同一连接器的账号在每次触发前解析。以后编辑团队，不会自动替换已有定时任务的编排。需要更新时，在任务编辑页勾选“保存时采用当前专家团配置”。对于复用会话的任务，该操作会创建新会话，原会话和历史运行保留，避免把两个版本的团队上下文混在一起。

列表、详情和执行历史可以展开团队快照。历史记录展示该次运行的成员和模型配置，而非团队当前设置。

API 访问

从团队卡片进入 API 访问，或在新建会话级 API 密钥时选择团队。密钥固定绑定当前账号的团队；创建后不能更换执行目标，需要更换时创建新密钥。

• 新会话采用团队当时的配置，续聊使用会话保存的团队快照。
• API 密钥的显式模型配置优先于团队个人设置。
• 技能和连接器来自团队，不再通过密钥表单复制一份独立配置。
• 消息、Chat Completions、流式响应、后台任务、幂等请求、停止与产物查询复用已有接口。
• 同一团队的不同密钥仍受既有 API 会话归属限制，不能交叉续聊其他密钥创建的会话。
• 团队停用、删除或依赖不可用时会返回错误，不会退回自由模式。

请求中的 model 字符串仍遵守现有 API 契约；选择 Poco 实际模型配置应在密钥或团队设置中完成。不要在请求里传入团队快照、成员配置或连接器密钥。

分享和复用

从专家团卡片的分享操作生成链接，选择有效期，也可公开到用户分享市场。接收者登录后预览成员、主控要求和能力，再导入自己的账号。分享内容包含团队配置快照和连接器依赖声明，不包含作者的账户凭据；导入时绑定接收者自己的连接账户。

来源更新后，导入的资源可提示“有更新”，由接收者确认更新。更新资源不会改写已经保存的会话或定时任务快照。详细规则见 分享与继续探索。

第一次组队建议

先用少量成员验证角色是否清晰：让每个成员交付独立证据或文件，主控负责消除冲突并统一验收。不要只增加人数而不给出职责边界。

专家团最佳实践 提供行业研究、业务指标复盘和软件交付三种完整案例，包含多个成员的分工、主控指令和验收要求。