AgentTeams框架上手教程

AgentTeams目前最常被提及的是阿里云的多智能体治理与协作平台它能让你在云端或本地快速搭建 AI Worker 团队并通过 Matrix 协议实现透明的多智能体协作与人机联动。先搞清楚 AgentTeams 在做什么AgentTeams 不是一个单纯的多 Agent 脚本框架而是把 Agent 当作企业级工作负载来治理的平台。它的骨架是三层结构Manager Agent全局监管、任务拆解Team Leader Agent具体团队的调度和任务分配Worker Agent底层执行任务协作通道基于Matrix 协议所有 Agent 与人的交流都在 Room 里全透明发生人可以随时介入凭证方面通过Higress AI 网关做零信任隔离——Worker 只拿到的消费者令牌真实的 API Key、GitHub PAT 等由网关统一保管。底层支持三种 Worker 运行时混合编排OpenClawNode.js——通用型适合任务编排和工具调用QwenPawPython——轻量适合浏览器自动化等快任务Hermes——自主编码 Agent带终端沙箱云端上手7 步跑通第一个 AI Worker以下流程来自阿里云官方文档全程在 AgentTeams 控制台操作。步骤 1授权服务关联角色登录 AgentTeams 控制台首次访问会提示授权服务关联角色点击立即授权。AgentTeams 通过此角色访问相关云资源。步骤 2创建实例点击创建实例填写实例名称选择地域、专有网络、交换机、网络访问类型然后立即创建→立即开通等待初始化完成。步骤 3配置模型进入实例详情 → 左侧模型管理 → 添加模型填写模型名称并选择模型供应商默认快速起步可用阿里云百川/Qwen也支持任意 OpenAI 兼容端点。步骤 4创建用户进入用户管理 → 创建用户填写用户名、显示名称、邮箱选择认证方式。步骤 5创建 Worker 团队进入Worker 团队 → 创建 Worker 团队基本信息团队名称、Admin、成员、描述Team Leader 配置选自定义创建填 Leader 名称、选择模型编写SOUL.md角色设定和AGENT.md行为规约绑定技能和 MCP Server步骤 6创建 Worker进入Worker 管理 → 创建 Worker → 自定义创建填 Worker 名称、选择模型、选择所属团队编写该 Worker 的SOUL.md和AGENT.md配置技能绑定、MCP Server 绑定步骤 7验证 Worker 团队进入概览在实例详情区域开启公网访问开关等待配置生效即可向 Worker 发消息验证。本地 Worker把 Agent 跑在你自己的机器上如果你希望 Worker 进程运行在自有服务器或本地AgentTeams 提供了本地 Worker模式由LoongSuite Pilot​ 在本地启动和守护 Worker 进程配置仍在控制台统一管理。前提实例已开通本地 Worker 能力本地机器能访问云端服务公网或同 VPCLoongSuite Pilot ≥ 1.1.13控制台生成的启动命令会自动安装/升级本地装有对应运行时 CLIClaude Code / OpenClaw / Qoder CLI / Codex 等创建方式有两种本地模板创建复用已有 Worker 模板模板内容由模板侧维护不建议在详情页直接改本地自定义从零配置⚠️ 控制台生成的启动命令包含连接凭证和云监控 license key属于敏感信息切勿提交到代码仓库、Issue、日志系统或公共群聊。核心概念速记概念作用Matrix Room​Agent 与人的协作空间所有消息可见、可干预SOUL.md​定义 Agent 的角色身份与个性AGENT.md​定义 Agent 的行为规约与工作流MCP Server​给 Agent 挂载外部工具能力Skill​可复用的能力包平台统一纳管Higress 网关​统一持有真实密钥向 Worker 颁发消费者令牌第一个协作任务怎么跑参考开源版 AgentTeams 的快速起步一个最小可跑的协作闭环是这样的装好 Manager 并登录 IM基于 Docker 一键启动或使用阿里云托管实例创建 Worker Alice在与 Manager 的私聊里发送Create a new Worker named alice for frontend developmentManager 会返回具体的启动命令和配置值在 Alice 的 Room 里派活发一句Alice, please create a simple README.md for a hello-world project...你会看到Manager 接收并转发任务MinIO 中出现shared/tasks/{task-id}/meta.json和spec.mdAlice 开始工作并写入result.mdRoom 里通知完成meta.json 状态变为 completed中途干预Alice 干活时你可以补一句Additional requirement: ...她会把新需求合并进当前任务加 Bob 协作再建一个 Worker Bob比如后端开发然后派活I need Alice and Bob to collaborate...两者通过 MinIO 共享文件协调整个过程中心跳机制会定期触发 Manager 向各 Worker 询问进度所有对话在 Room 里对人可见。学习路径建议先跑通单 Worker按上面 7 步在云端建一个实例 一个 Worker验证模型配置和消息通路再试本地 Worker装 LoongSuite Pilot把 Worker 落到本地理解控制台与本地运行时的分工然后做多 Worker 协作建 2-3 个职责不同的 Worker用共享文件做任务交接最后上 Team Leader引入 TL Agent 做任务拆解形成 Manager → TL → Worker 的三层完整架构渠道扩展根据需要把 Worker 接入钉钉机器人等渠道让用户从熟悉的地方触达 Agent