阿里云 AgentCore 深度调研：企业级 Agent 构建与治理平台的能力与边界

文章目录

• 前言
• 一、快速了解AgentCore
• 1.1、产品介绍
• 1.2、产品沿革与前身
• 1.3、产品价值主张
• 1.4、产品架构图
• 1.5、产品能力总览（核心能力）
• 1.6、基本概念
• 1.7、Agent 类型
• 1.8、典型场景
• 1.9、安全合规层面
• 二、核心功能深度解析
• 2.1、Agent 管理
• 2.1.1、创建方式
• 2.1.2、托管 Harness（QwenPaw / Qoder）
• 2.1.3、高代码 Agent 部署
• 2.1.4、本地纳管 Agent
• 2.1.5、Agent 模板
• 2.2、模型管理（模型连接）
• 2.3、Skill 管理
• 2.4、MCP 工具管理
• 2.5、知识库连接
• 2.6、凭证管理
• 2.7、Agent Team 能力专题（用途 / 解决问题 / 支持程度）
• 2.7.1、它是什么、解决什么问题
• 2.7.2、组织架构与角色
• 2.7.3、三种协作模式（官方产品负责人归纳）
• 2.7.4、开通与接入
• 2.7.5、TeamHarness 协作机制
• 2.7.6、任务系统
• 2.7.7、定时任务
• 2.7.8、多团队协作
• 2.7.9、能力矩阵与当前支持程度
• 2.7.10、当前限制与待完善
• 2.8、IM 渠道接入
• 2.9、账号集成（统一登录）
• 2.10、用户与权限
• 2.11、连接器
• 2.12、可观测与治理
• 2.13、底层运行框架与技术底座
• 三、开发参考（SDK）
• 3.1、SDK 概述
• 3.2、语言与框架支持
• 3.3、协议对比
• 四、支持地域、依赖产品与计费
• 4.1、支持地域
• 4.2、依赖产品
• 4.3、计费说明
• 五、快捷使用
• 5.1、快速开通阿里云AgentCore
• 1）开通AgentCore
• 2）授权服务关联角色
• 3）开通三款云产品服务依赖
• 5.2、快速创建第一个Agent
• 1）创建workspace
• 2）创建Agent
• 六、本地 Agent 接入机制（opencode / codex 等）
• 6.1、结论速览
• 6.2、核心机制：LoongSuite Pilot 本地代理（这就是"服务模式"）
• 6.3、本地 Agent 的四种接入路径
• 6.4、把 opencode / codex 接进来具体怎么做
• 6.5、与"服务模式"相关的关键要点
• 6.6、远程遥控本地 Coding Agent（Remote Control）
• 6.7、LoongSuite Pilot 安装与操作（命令速查）
• 6.8、官方文档与来源
• 七、AgentTeams 迁移至 AgentCore
• 八、产品负责人视角：AgentCore 全景解读
• 8.1、行业趋势与定位
• 8.2、构建、运行与集成
• 8.3、协作模式
• 8.4、上下文工程与资产
• 8.5、观测、评估与治理
• 九、调研小结
• 9.1、产品定位总结
• 9.2、核心优势
• 9.3、关注点/待成熟
• 9.4、官方文档索引
• 参考资料

首图 prompt 占位：企业级 AI 智能体平台科技感封面，深蓝渐变背景，发光神经网络与云端符号，多个机器人智能体围绕中心治理枢纽，中文主标题「阿里云 AgentCore 深度调研」与副标题「企业级 Agent 构建与治理平台的能力与边界」，商务科技风、扁平化、蓝青色、横版 16:9，适合技术博客与微信公众号封面。

前言

在公司内部，我曾自己动手实践过、做过一个一站式的 Agent 平台。也正是这段经历，让我对阿里云 AgentCore 这类"企业级 Agent 构建与治理平台"的能力边界与范围格外感兴趣——它到底解决了哪些问题、支持到什么程度、边界又在哪里。

同时，我目前正在从底层模型协议层开始做起，打造一整套 Agent 基础设施，核心开源项目为 AgentForge（https://github.com/agentforge-tech/AgentForge ），目标是打磨出一套"Agent 开箱即用"的完整基础设施。

因此，本篇调研既带着"平台建设者"的视角，也会带着"从协议层往上搭"的问题意识，逐层拆解 AgentCore 的能力、边界与当前支持程度，作为横向对照与自我验证。

---

一、快速了解AgentCore

1.1、产品介绍

• 产品网址：https://www.aliyun.com/product/agentcore
• 控制台地址：https://agentcore.console.aliyun.com/
• 帮助中心：https://help.aliyun.com/zh/agentcore/

介绍：企业智能体的统一构建和治理平台。以构建与运行、协作与治理、观测与评估三大能力，覆盖智能体全生命周期；通过多模式构建入口、统一身份鉴权与 Team 协作编排，将自研、开源 Harness、商业 SaaS Agent 多来源统管于一个平台，让智能体建得快、管得住、协作好。

一句话总结定位：阿里云的企业级 Agent 全生命周期"构建 + 治理"平台（注意区分同名产品 AWS Bedrock AgentCore，本篇调研对象为阿里云 AgentCore，其前身来自多智能体治理协作平台 AgentTeams）。

官方产品 Banner（来源：阿里云官网 https://www.aliyun.com/product/agentcore）

1.2、产品沿革与前身

阿里云 AgentCore 并非从零起步，而是承接了阿里云云原生 Agent Native Cloud 产品矩阵的演进。

时间 / 产品	定位	说明
AgentTeams（多智能体治理与协作平台）	AgentCore 的主要前身	2026-07-01 公测发布，提供实例管理、Worker 管理、模型管理、团队协作、MCP 服务、监控仪表盘、Worker 模板；支持杭州 / 北京 / 新加坡
AgentLoop（智能体观测优化平台）	观测能力被 AgentCore 吸收	与 AgentTeams 同期发布；AgentCore 创建 Workspace 时会自动绑定 AgentLoop
AgentRun（智能体 AgentRun）	同属云原生 Agent 产品矩阵	智能体运行 / 开发相关，与 AgentCore、AgentTeams 并列

演进关系说明：

• AgentTeams 的核心概念在 AgentCore 中完成升级与更名：实例 → Workspace、Worker → Agent、Worker 模板 → Agent 模板；
• 观测与评估能力由 AgentLoop 沉淀，在 AgentCore 中体现为全链路 Trace、接入云监控 CMS 2.0、AgentLoop 自动绑定；
• AgentCore 相对 AgentTeams 的最大扩展是补齐"构建"能力：新增托管 Harness（QwenPaw / Qoder）、高代码 Agent 部署、本地纳管 Agent、Skill 版本管理、知识库连接、SDK 等，从"多智能体治理协作平台"升级为"构建 + 治理"全生命周期平台；
• 官方提供 AgentTeams → AgentCore 交互式迁移服务，可将 AT 实例的控制面资源迁移到新的 AC Workspace（详见第六章）。

相关官方资料：

• AgentCore 公测发布（产品动态）：https://www.aliyun.com/product/news/29444
• AgentTeams 产品页：https://www.aliyun.com/product/agentteams
• AgentTeams 帮助中心：https://help.aliyun.com/zh/agentteams/
• AgentTeams 产品概述：https://help.aliyun.com/zh/agentteams/magic-console-product-overview
• AgentRun 帮助中心：https://help.aliyun.com/zh/agentrun/

1.3、产品价值主张

价值点	说明
统一接入与管理	托管、纳管、注册三种接入方式，多来源 Agent 一站式统管
统一身份与权限	人类用户与 Agent 统一认证鉴权，入站、出站双向管控
多 Agent 与多人协作	Agent 组队、人机协同，任务智能拆分、故障自动接管，协作全程可视可控
安全与开放并行	凭据隔离、沙箱防护、数据安全多层兜底；IM、API、客户端多渠道开放接入

1.4、产品架构图

1.5、产品能力总览（核心能力）

核心能力包含：

1）统一构建与接入 2）弹性可靠的运行底座 3）多智能体与多人协作 4）治理与可观测

官方产品能力图（来源：阿里云官网 https://www.aliyun.com/product/agentcore）

① 统一构建与接入

② 弹性可靠的运行底座

③ 多智能体与多人协作

④ 治理与可观测

官方帮助中心归纳的八大核心功能模块：

功能	说明
Agent 管理	创建和管理 Agent，支持多种运行模式，满足不同业务场景的智能体配置需求
Agent 模板	创建可复用的 Agent 配置模板，快速批量部署同类型智能体，降低重复配置成本
模型连接	统一管理模型配置，支持在不同 Agent 间灵活切换模型
Skill 管理	创建、发布和管理 Skill，支持从 Skill 广场导入三方 Skill，为 Agent 扩展可复用的专业能力
工具管理	基于 MCP（Model Context Protocol）集成和管理外部工具，为 Agent 提供扩展工具调用能力
凭证管理	集中管理用户访问外部系统用到的 AK/SK 等敏感信息，避免密钥明文散落在各处配置中
Team 协作	创建团队、管理成员权限，支持多角色协作，满足企业级权限管控需求
账号集成	配置钉钉、微信、飞书等平台的账号集成，将 Agent 接入企业日常沟通渠道，实现对话式调用

1.6、基本概念

AgentCore 中的资源以 Workspace 为边界组织，Workspace 内独立维护模型配置、Agent、Team 和 MCP 工具。Agent 是执行 AI 任务的单元，运行时关联一个模型，并可绑定 Skill 与 MCP；多个 Agent 可组成 Team。

概念	定义
Workspace	资源隔离和管理的基本单元；独立维护模型、Agent、Team、MCP 工具等，互不干扰，可按项目/业务线隔离
Agent	AI 智能体的执行单元，在 Workspace 内创建，接收任务后调用模型完成推理并给出结果；能力由绑定的资产决定
Agent 模板	可复用的 Agent 配置模板，用于快速创建同类型 Agent，减少重复配置
Skill	Agent 调用的专业技能，支持 ZIP 上传 / Nacos CLI / 预置模板三种导入方式
MCP	Model Context Protocol；为 Agent 扩展标准化工具集成，HTTP TO MCP 与直接代理两类，均要求网络可达
模型连接	接入模型供应商的通道，连接侧配置供应商、API 端点、协议与访问凭证
模型	连接下可供 Agent 选择的推理模型，记录上下文长度、单次最大输出、流式输出，以及工具调用、视觉、音频等能力项
凭证	访问外部服务所需的密钥，以 Key-Value 形式集中保存，供模型连接与工具的认证配置引用
Team	多个 Agent 组成的组织形式，在 Agent 之上再加一层组织

AgentCore 能力可归为四组：Agent 构建、资产管理、Agent 协作、身份与权限。

1.7、Agent 类型

Agent 类型	说明
Harness Agent（托管）	由 AgentCore 提供运行框架，控制台配置即可创建运行，无需自行开发或部署。配置项包括名称、模型、所属 Team、SOUL.MD 与 AGENT.MD、Skill 绑定、MCP 绑定
高代码 Agent	以编写代码方式开发，容器镜像部署，适用于需要自定义业务逻辑、对运行过程有精细控制要求的场景；保留已有框架和 HTTP 服务
纳管 Agent	将已部署在客户本地的 Agent 纳管到 AgentCore 统一管理，无需改造即可参与团队编排与协作（仅作为 Team Worker）
注册 Agent（待上线）	将部署在 AgentCore 之外的 Agent 注册到平台，由平台统一调度

1.8、典型场景

数字员工 & 智能问数：

智能客服 & AI编程：

官方对四大场景的详细描述：

场景	说明
数字员工	面向企业内部事务的岗位型智能体，Harness 配置化创建即可上线，经 IM 渠道直连办公场景，依托记忆库与知识库承接入职办理、单据审核、工单值守等工作
智能客服	单一 Agent 承接对外咨询与业务办理，沙箱运行时按需弹性伸缩应对流量高峰，身份与权限体系约束数据访问范围，可观测与评估支撑全链路追溯与效果调优
智能问数	通过自然语言提出业务问题，Agent Team 拆解任务，多 Agent 经 MCP 接入数据源分别完成取数、建模与归因，输出决策结论
AI 编程助手	将企业多种存量编程 Agent 原样纳管，按需组队统一协作；全链路可观测、可干预；Token 消耗可归因、可管控、可审计

官方场景配图（来源：阿里云官网 https://www.aliyun.com/product/agentcore）

数字员工

智能问数

智能客服

AI 编程助手

1.9、安全合规层面

官方披露的四大安全能力：

• 凭证安全：架构级凭据隔离 + 管控面统一加密托管，Agent 无需接触明文；运行时结合 Anti-Log、内存加密及缓存自动清除技术，并集成 Agent Identity 实现最小化授权，降低凭据泄露风险。
• 全链路 Trace 追踪：覆盖调用链、工具链、决策链的完整追踪，可观测能力接入云监控 CMS 2.0，出问题可快速定位到具体 Agent 和步骤。
• 安全审计：记录每次凭据操作的 Agent 身份与操作人员信息，支持责任可追溯；全量审计日志支持按时间、人员、Agent 等多维度检索，满足企业合规要求。
• 访问控制：统一身份体系，为 Agent 分配独立身份，支持 inbound 与 outbound 双向鉴权及 RBAC 多角色配置，实现访问与操作的细粒度管控。

官方安全合规配图（来源：阿里云官网 https://www.aliyun.com/product/agentcore）

---

二、核心功能深度解析

以下内容基于阿里云官方帮助中心（https://help.aliyun.com/zh/agentcore/）逐篇整理，是本篇调研的核心部分。

2.1、Agent 管理

官方文档：管理 Agent https://help.aliyun.com/zh/agentcore/manage-agents ｜ 托管 Harness Agent 使用指南 https://help.aliyun.com/zh/agentcore/agent-instructions-managed-harness ｜ 高代码 Agent 部署 https://help.aliyun.com/zh/agentcore/high-code-agent-deployment-guide ｜ 本地纳管 Agent https://help.aliyun.com/zh/agentcore/guidelines-for-the-use-of-local-nanoagent ｜ 管理 Agent 模板 https://help.aliyun.com/zh/agentcore/manage-agent-templates

2.1.1、创建方式

点击"创建 Agent"后先选择创建方式：

创建方式	说明
托管 Harness	选定 Harness 后托管运行，可使用 Agent 模板
自定义代码 / 镜像	使用容器镜像部署，支持自定义逻辑（高代码 Agent）
快速创建	表单式低代码创建（即将上线）

托管 Harness 创建时需配置：

• 基本信息：Harness 选择、是否使用模板、Agent 名称、模型连接与模型、描述
• Token 配额：可开关，设置配额上限与计量周期（天/周/月）
• 文件配置：系统提示词（描述角色、职责、工作方式），分别写入 SOUL.MD 与 AGENT.MD
• Agent 资产配置（页签）：Skill、SubAgent、工具、知识库、凭证五类资产
• 资源配置：实例规格（CPU/内存）、实例最大 Session 数、Session TTL、自动扩缩容（最小/最大实例数）
• 网络配置：允许默认网卡访问公网、允许访问 VPC

2.1.2、托管 Harness（QwenPaw / Qoder）

Harness 是执行 Agent Loop 的引擎，负责调用模型、执行工具并根据结果决定下一步。AgentCore 提供两种托管 Harness：

能力项	QwenPaw	Qoder
模型选择与提供方支持	可通过平台配置切换模型及提供方；暂不支持调整模型参数	支持配置 Qoder 原生模型；不支持通用模型提供方或 BYOK，不支持调整模型参数
上下文管理与压缩	使用 QwenPaw 原生机制	使用 Qoder 原生机制
外部协议	AG-UI（SSE 流式返回）	同左
其余能力	两者一致（Shell 命令、文件读写、预装 Chromium、mcporter 调用 MCP、Subagent、Skill 加载、多模态、VPC、OSS）	同左

Session 管理要点：

• 实例是运行 Agent 的计算环境；一个 Agent 可运行多个实例，一个实例可承载多个 Session；同一实例中的 Session 共享 CPU/内存。
• 同一 Session 同时只能处理一个请求（排队），不同 Session 可并发。
• 自动扩缩容按 Session 数 ÷ 实例最大 Session 数 计算所需实例数，受最小/最大实例数限制；达到上限后新 Session 申请返回容量不足。
• Session TTL 决定请求结束后空闲 Session 的保留时长（如 600 秒 = 空闲 10 分钟回收）；存在请求处理或排队的 Session 不会因空闲超时回收。
• 原生 Session 会定期备份并在启动时恢复；异常中断时最近 5 秒内未备份内容可能丢失。
• 每个 Session 有独立工作目录，同一 Agent 的不同 Session 可通过 shared/ 目录共享文件。

配置生效方式：模型、提示词、Skill、Subagent、MCP、凭证支持热更新（无需重启）；实例规格、镜像、挂载点需重启后生效。

2.1.3、高代码 Agent 部署

将自研 Agent 应用以容器镜像部署到 AgentCore，保留已有开发框架和 HTTP 服务：

• 镜像要求：linux/amd64、同时提供 /bin/bash 与 /bin/sh、镜像仓库需企业版 ACR（公开匿名拉取）、应用监听 0.0.0.0
• 需声明对话协议：Chat Completions（默认路径 /openai/v1/chat/completions）或 AGUI（默认路径 /ag-ui/agent）
• 配置项：启动命令、服务端口、执行角色、环境变量、运行资源、健康检查、网络与日志
• 通过控制台调试，并从"外部渠道配置 → 直接访问"获取 Endpoint 与 API Key 供业务调用
• 执行角色用于 Agent 访问云资源（RAM 授权），不是外部调用 Agent 的 API Key

2.1.4、本地纳管 Agent

将团队已有本地开发环境接入 AgentCore Team 统一协作：

• Agent 进程运行在自有电脑/服务器，由 LoongSuite Pilot 完成本地进程管理，作为 Team Worker 加入
• 支持运行时：Claude Code、Codex、OpenClaw、Qoder CLI
• 仅作为 Worker，不支持设为 Leader，每个纳管 Agent 仅可加入一个 Team
• 需开启 Team 协作才能创建纳管 Agent
• 启动命令包含连接凭据与云监控配置（敏感信息，不得外泄）
• 本地 Skill/MCP 默认不继承，需 --inherit-local-resources true 显式启用
• 常用命令：loongsuite-pilot status/info/start/restart/worker list/worker status/worker connect/disconnect/delete

2.1.5、Agent 模板

基于 AgentSpec 规范，提供可复用配置模板，一次定义多次创建：

• 支持导入 ZIP 压缩包模板
• 配置项：名称、文件（定义 SOUL.md 和 AGENTS.md）、Skill 绑定、SubAgent（最多 20 个）

2.2、模型管理（模型连接）

官方文档：管理模型 https://help.aliyun.com/zh/agentcore/model-management

Agent 运行依赖模型配置，模型管理支持接入多个 AI 模型供应商并统一管理：

• 模型连接：选择预制供应商（如阿里云百炼）或自定义供应商，配置 API 端点与访问凭证（当前仅支持手动输入 API Key）
• 模型能力项：工具调用、多工具调用、流式工具调用、视觉、音频、视频、文档、推理
• 调用参数：上下文长度、单次最大输出、流式输出
• 支持调试、删除；模型连接展示供应商、API 端点、已接入模型（卡片/列表视图）
• SDK 调用模型只需指定"模型连接名称 + 模型名称"，连接与密钥由平台托管，无需硬编码

2.3、Skill 管理

官方文档：管理 Skill https://help.aliyun.com/zh/agentcore/manage-skill ｜ Skill 版本管理概述 https://help.aliyun.com/zh/agentcore/overview-of-skill-version-management

Skill 是 Agent 调用的专业技能（发送通知、查询数据、触发工作流等），内容以 SKILL.md 定义，name / description 对应控制台显示：

• 导入/创建方式：上传 ZIP 技能包、Nacos CLI 导入本地文件夹、通过 Markdown 定义（可设可见性）、从 Skill 广场导入三方 Skill
• 内容审核：新建版本状态为草稿，发布前需通过安全检测（基于独立的 AI 安全护栏产品）
• 发布与版本管理：草稿 → 已发布；支持创建版本、编辑草稿、版本标签、启用/禁用、可见性（公开/私有）、下载到本地
• 启用后最新已发布版本对外提供服务；禁用后所有版本停止服务

Skill 版本管理模型：

概念	是否可变	说明/适用场景
工作区版本（HEAD）	可持续修改	开发、调试、快速迭代
正式版本	创建后不可修改	稳定使用、回滚、审计（语义化版本如 1.0.0）
版本别名	指向可修改	latest（系统保留，自动跟随最新正式版）；自定义别名（如 production，暂未开放）

推荐流程：工作区开发 → 正式版本发布 → 别名逐步推广（测试别名 → 生产别名 → 出问题回滚）。

2.4、MCP 工具管理

官方文档：管理 MCP 工具 https://help.aliyun.com/zh/agentcore/managing-the-mcp-server

通过为 Workspace 配置 MCP Server，为 Agent 扩展标准化工具集成能力：

• 工具类型：MCP（连接远程 MCP 服务或 HTTP 转 MCP）、虚拟 MCP（重组已有 MCP，即将上线）
• 创建方式：连接 MCP 服务（对接已有远程服务）、HTTP 转 MCP（将 HTTP 接口转 MCP 工具）
• MCP Transport：SSE 或 Streamable HTTP
• 认证配置：启用认证、认证方式（如 API Key）、凭证来源（自定义 HTTP header）、Header 名称、API Key 值
• 要求目标地址网络可达；支持查看/编辑/删除

2.5、知识库连接

官方文档：连接表格存储 OTS 知识库 https://help.aliyun.com/zh/agentcore/connect-table-store-ots-knowledge-base-in-agentcore ｜ 连接百炼知识库 https://help.aliyun.com/zh/agentcore/connect-the-refined-knowledge-base-in-the-agentcore

AgentCore 仅只读检索外部知识库，不复制文档、不负责知识库创建与维护：

知识库类型	说明
表格存储 OTS 知识库	连接 Tablestore 的 AgentStorage 知识库；通过 FC 执行角色 + 临时 STS 凭证访问，需 ots:Retrieve 权限
百炼知识库	连接已有阿里云百炼知识库（当前仅支持华北2北京）；需 sfm:Retrieve 权限并加入目标业务空间

• 底层通过 MCP 提供检索能力：search_ots_knowledgebase / search_bailian_knowledgebase
• 支持单次检索配置覆盖（searchType：DENSE_VECTOR / FULL_TEXT、numberOfResults、重排序 RRF/WEIGHT/MODEL、filter 元数据过滤）
• 返回：文本切片 content、相关性得分 score、文档标识、元数据 metadata 等
• 连接创建后不能直接修改，需删除重建；工具管理入口可见底层 MCP 实现

2.6、凭证管理

官方文档：管理凭证 https://help.aliyun.com/zh/agentcore/manage-credentials

• 凭证用于保存访问外部服务的认证信息，以 Key-Value 形式（环境变量名如 GITHUB_ACCESS_TOKEN）集中保存
• Value 创建后默认隐藏，供模型连接与工具的认证配置引用/绑定
• 最佳实践：不明文暴露、最小权限、定期轮换、泄露即吊销
• 集中托管缩小凭证暴露面，无需在多处重复填写或硬编码

2.7、Agent Team 能力专题（用途 / 解决问题 / 支持程度）

官方文档：设置 Team 协作 https://help.aliyun.com/zh/agentcore/set-up-team-collaboration ｜ 协作 TeamHarness 使用说明 https://help.aliyun.com/zh/agentcore/team-collaboration-instructions-collaboration-teamharness ｜ 使用 Team 任务 https://help.aliyun.com/zh/agentcore/using-team-tasks ｜ 使用 Team 设置定时任务 https://help.aliyun.com/zh/agentcore/use-team-web-to-set-tasks

2.7.1、它是什么、解决什么问题

问题引入：单个 Agent 面对复杂业务时，往往"一个脑袋不够用"——任务太长、步骤太多、需要不同专业能力，还要求过程可见、结果可验收。Agent Team 就是为了解决这些问题。

用途与解决的问题：

问题	Agent Team 的解法
复杂任务难以一次完成	Leader 把任务拆解为子任务，分派给多个 Worker 并行/按依赖执行
需要不同专业能力	按角色组队（分析师/研发/审查…），各司其职
长程任务容易跑偏、黑盒	任务房间 + 数字会议室：过程透明可见，人可随时 @ 干预
故障/失联导致中断	Fallback 容错：启动超时重试、运行超时提醒、会话失联恢复
上下文互相污染	主子/成员间做上下文隔离，必要时共享
结果无人把关	评审人验收：结果卡片 + 验收/提出修改意见
人机协同诉求	人与 Agent 对等协作，人在回路

典型用途：数字员工、智能问数（多 Agent 取数/建模/归因）、智能客服、AI 编程（按需组队）、跨部门任务编排。

2.7.2、组织架构与角色

角色	说明
团队 Admin（人类用户）	维护团队信息、增删成员与 Agent、更换 Leader
Leader Agent	承接任务、拆解、分派、审核、汇总；不重复出现在成员列表
Worker Agent	执行被分派的子任务、反馈问题、提交结果
团队成员（人类，可选）	参与协作与验收

重点：人与智能体在 Team 中处于对等位置——人可以像和一个 Agent 聊天一样随时干预团队执行；同一个 Agent 归属不同团队时可承担不同角色（如在 A 队做 Worker、在 B 队做 Leader）。

2.7.3、三种协作模式（官方产品负责人归纳）

模式	典型场景	机制
即时并发型	多方向调研	Harness 内置 Sub-Agent 并行执行，共享主智能体上下文/权限，结果汇总
按需编队	调研→写作→审查	预置 Agent 模板按序拉起，子 Agent 生命周期与任务关联
长期数字员工	研发"产品经理"角色	能力服务化固定化，长期运行、长期观测进化，主子智能体协同

重点（数字会议室）：针对长程多智能体任务的偏差与可见性诉求，所有智能体交互与产出以聊天形式透明呈现，人可随时 @ 干预——这是企业内部落地复杂任务的最佳实践模式。

2.7.4、开通与接入

• 需购买协作管控面实例（付费，按产品定价）
• 网络：公网访问 / VPC 接入（至少开启一项，未绑 VPC 则必须公网）
• 连接点：协作客户端（WEB，可视化界面）与协作客户端（API，程序化访问），均提供公网/私网 URL
• 通信基于 Matrix（登录时需配置 Homeserver URL）

2.7.5、TeamHarness 协作机制

• 职责划分：业务定义（做什么/交付什么）+ Harness（执行）+ TeamHarness（协作规则）+ Skills（操作方法）
• 任务房间：执行任务的专属会话；私聊/群聊/普通对话为非任务房间
• 内置协作流程：安排工作 → 执行工作 → 提交与审核 → 遇到问题（阻塞）→ 等待与继续 → 最终交付
• 支持：@mention 唤醒、任务计划动态调整、子任务委派、Fallback 容错、并发限流、终态任务自动归档

注意：@mention 仅用于沟通和唤醒，不代表已经分派子任务；子任务分派由 Leader 通过计划编排 Skill 正式创建。

2.7.6、任务系统

• 任务看板：待确认 / 已创建 / 执行中 / 已完成 / 已取消五列
• 创建入口：对话创建（与 Leader 私聊/@）、手动创建（填标题内容+团队）、AI 创建
• 任务房间：查看执行消息、子任务依赖图、事件、文件、成员、详情
• 验收：结果卡片预览/下载，评审人验收或提出修改意见；可配置回复路径（Channel/房间/对象）
• 状态：待处理/执行中/阻塞/已暂停/待验收/已完成/失败/已取消
• 操作：暂停、恢复、重试、取消、归档、取消归档、删除（不撤销已完成的外部操作）
• 权限：创建者/人类参与者/评审人/其他用户分级授权

2.7.7、定时任务

基于阿里云 SchedulerX，让 Agent 按预设时间/频率自动执行：

• 应用：周期性报告、定期巡检、定时提醒
• 在协作客户端（AgentTeams）创建管理：任务标题、目标团队、指派 Agent、优先级（紧急/高/中/低）、执行周期、任务内容
• 管理：启停、编辑、手动执行、执行记录、删除

2.7.8、多团队协作

• 上级团队统筹整体目标，拆分给下级专业团队；协调 Agent 可同时是"上级 Worker + 下级 Leader"
• 注意：上下级任务状态相互独立——暂停/取消/恢复上级任务，不会自动连带下级；跨团队权限与任务状态分别管理
• 子任务依赖图仅反映当前任务内的拆分，不是所有下级团队的完整总览

2.7.9、能力矩阵与当前支持程度

同一 Agent 参与多个团队：支持（按当前请求使用对应团队身份与角色）。

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

加入团队的前置条件：

条件	说明
协议	Agent 需配置 AG-UI 或 OpenAI（Chat Completions） 协议，否则不能加入
创建方式	以自定义代码/镜像创建的 Agent 暂不支持加入团队
唯一归属	已作为其他团队 Leader、或已归属其他团队的 Agent 不能再加入别的团队
纳管 Agent	仅可作为 Worker，不能设为 Leader，且每个仅加入一个 Team
开通	必须先开通 Team 协作（购买协作管控面实例）

2.7.10、当前限制与待完善

• 终态任务自动归档，并按时间过期与数量压力执行 FIFO 截断；
• 任务/子任务并发限流基于 AgentRuntime 容量控制；
• 跨团队委派时两侧权限与任务状态分别管理，不会自动连带取消、恢复或验收；
• 一个 Agent 只能归属一个团队/作为唯一 Leader（灵活性受限）；
• 自定义代码/镜像创建的 Agent 暂不支持加入团队（需先具备 AG-UI/Chat Completions 协议）；
• 纳管 Agent 仅 Worker、单团队；
• 协作管控面为付费项；定时任务依赖调度服务；
• 长程任务上下文过长时，Harness 会压缩历史，可能不保留全部原始对话。

2.8、IM 渠道接入

官方文档：将 Agent 接入 IM 渠道 https://help.aliyun.com/zh/agentcore/integrate-the-agent-into-the-im-channel

将托管 Agent 接入钉钉 / 飞书 / 企业微信机器人：

IM 平台	创建入口	凭证
钉钉	钉钉开放平台（推荐一键创建）	Client ID、Client Secret
飞书	飞书开放平台·一键创建智能体应用	App ID、App Secret
企业微信	企业微信管理后台（API 模式/长连接）	Bot ID、Secret

• 每个 Agent 在每个 IM 平台最多一个机器人渠道，可分别配置三个渠道
• 需开通卡片读写权限，可选 IP 白名单（官方提供 6 个 IP）
• 配置项：启用渠道、ServiceEndpoint、渠道凭证、显示思考过程（默认关）、显示工具调用（默认关）
• 渠道状态：未配置 / 已开启 / 已停用 / 创建中/更新中/删除中 / 配置失败 / 删除失败
• 仅托管 Agent 展示"外部渠道配置"入口；注册/纳管 Agent 不支持

2.9、账号集成（统一登录）

官方文档：配置钉钉账号集成 https://help.aliyun.com/zh/agentcore/agentcore-configure-dingtalk-account-integration ｜ 配置飞书账号集成 https://help.aliyun.com/zh/agentcore/configure-dingtalk-account-integration

集成	能力
钉钉账号集成	钉钉扫码登录 AgentCore + 通讯录增量同步（用户增加/更改/离职）
飞书账号集成	飞书扫码登录 + 通讯录同步（可同步邮箱/手机号）

• 当前每类集成最多支持 100 个用户（超出即失败）
• 通过 OAuth 回调地址 + 权限开通 + 事件订阅实现；组织架构变化可自动同步

2.10、用户与权限

官方文档：管理用户 https://help.aliyun.com/zh/agentcore/manage-users

• 用户管理：创建/编辑/删除用户（用户名、显示名称、邮箱、认证方式、密码）
• 认证方式：当前仅支持本地账号
• 身份体系：为 Agent 分配独立身份，人类用户与 Agent 统一认证鉴权
• 双向鉴权：inbound（入站）+ outbound（出站）；支持 RBAC 多角色配置

2.11、连接器

官方文档：管理连接器 https://help.aliyun.com/zh/agentcore/manage-connectors

连接器用于将其它 Agent 平台集成到 AgentCore，集成后由 AgentCore 统一托管：

• 当前支持集成 Qoder CLI（托管 Qoder 类型 Agent）
• 配置项：站点（中国站/国际站）、组织 ID、API 密钥（换取 Qoder SAT，加密存储于 Workspace Vault）、服务账号
• 支持连通性校验

2.12、可观测与治理

官方文档：查看概览 https://help.aliyun.com/zh/agentcore/view-overview

概览（Workspace 维度）：

维度	指标
运行健康	Agent 总数、状态分布（运行中/异常/停止）、资源摘要（模型/工具/Skill/凭证数量）
用量统计	时间范围、调用次数、Token 用量、调用趋势、Token 用量趋势
协作摘要	Team 数、今日会话数
产品近期活动	最近 3 条活动（创建 Agent、部署广场 Skill、开通协作空间等）

• 创建 Workspace 时自动绑定 AgentLoop（可查看相关信息）
• 可观测接入 云监控 CMS 2.0：全链路 Trace（调用链/工具链/决策链）、基础监控、运行日志
• 支持按实例 ID / Session ID 定位，运行数据用于分析与排查

2.13、底层运行框架与技术底座

官方文档：托管 Harness Agent 使用指南 https://help.aliyun.com/zh/agentcore/agent-instructions-managed-harness ｜ 官方访谈《产品负责人解读产品全景》 https://mp.weixin.qq.com/s/rMbgCJNDtJlGufuLD53uVg

问：AgentCore 底层用什么框架实现？

先说结论：官网没有用一句话公布"AgentCore 平台自身由某个框架实现"；但官方文档与官方发布披露了清晰的分层技术底座——运行框架（Harness）层可查，平台组件层可由官方资料旁证。

① 运行框架层：Harness = QwenPaw / Qoder

官方定义："Harness 是执行 Agent Loop 的引擎，负责调用模型、执行工具，并根据结果决定下一步"。托管 Agent 即运行在 Harness 上：

Harness	来源	技术特征
QwenPaw	阿里 AgentScope（Qwen 开源生态）团队开源（前身 CoPaw）	Apache 2.0；Python 3.10–3.13；Web 控制台 React + Vite；桌面端 Tauri；MCP（OAuth 2.1）+ AgentScope 插件市场；模型无关
Qoder	阿里云智能体编程平台 Qoder（另开源有 Better Harness）	使用 Qoder 原生模型与上下文压缩机制；不支持通用模型提供方 / BYOK

注意：高代码 Agent 不绑定任何框架——用户可用 LangChain、LangGraph、AgentScope 等任意框架；AgentCore 只提供官方 SDK 降低使用平台资产的门槛。

② SDK 框架适配层（官方支持清单）

LangChain、LangGraph、AgentScope 2.x、Google ADK、PydanticAI、CrewAI（含各自的记忆适配入口）。

③ 平台组件与协议（官方资料旁证）

层 / 能力	技术底座	来源
可观测（Trace）	OpenTelemetry（LoongSuite Pilot / GenAI 语义规范），上报云监控 CMS 2.0	LoongSuite + CMS 文档
协作通信	Matrix（Homeserver URL，AgentCore App 内聊天通信服务）	使用 Team 设置定时任务文档
Skill 版本管理	内置 Nacos（多版本管理、变更留痕）	官方访谈
鉴权 / 限流 / 成本	内置 AI 网关（入、出双向管控，quota 限流/降级/阻断）	官方访谈
运行底座	容器沙箱（会话级隔离）+ 企业版 ACR + VPC/OSS	高代码部署文档
交互协议	AG-UI、OpenAI Chat Completions、MCP、SSE；规划 A2A	官方文档 / 访谈
依赖云产品	CMS、PrivateLink、SchedulerX3；知识库检索经 FC 执行角色 + 临时 STS	产品概述 / 知识库文档

重点：对用户而言"底层框架是可替换的"——托管走 Harness，高代码不限框架，纳管复用本地运行时（LoongSuite Pilot）；平台自身主要负责身份、网关、观测、协作、资产等治理面的统一。

相关来源：QwenPaw 介绍 https://developer.aliyun.com/article/1713682 ｜ QwenPaw GitHub https://github.com/agentscope-ai/QwenPaw ｜ LoongSuite Pilot https://github.com/alibaba/loongsuite-pilot

---

三、开发参考（SDK）

3.1、SDK 概述

官方文档：AgentCore SDK 概述 https://help.aliyun.com/zh/agentcore/agentcore-sdk-overview

alibabacloud-agentcore-sdk 用于开发 Agent 应用（注意：与调用平台管理 API 的 OpenAPI SDK 不是同一个包）。SDK 让业务代码按名称调用托管资源，把资源接入已有 Agent 框架，并通过协议对外提供服务。

能力	说明
模型	按模型连接名称调用云端模型，支持普通调用/流式输出；也可接入自有模型服务
MCP	获取工具列表、调用工具、接入 Agent 框架；支持平台托管与自有服务
Skill	加载平台已发布 Skill，或加载随应用分发的 Skill 文件
记忆	写入、检索、查询、更新、删除记忆（MemoryStore），通过框架适配器接入执行流程
凭证	按名称获取托管凭证，或为 MCP 显式绑定 MCP Header 凭证
框架适配	转换模型、工具和执行事件
对外协议	使用 AgentCoreServer 提供 AG-UI、OpenAI Chat Completions 或自定义协议服务

3.2、语言与框架支持

官方文档：AgentCore Python SDK 使用指南 https://help.aliyun.com/zh/agentcore/agentcore-python-sdk-user-guide ｜ AgentCore Node.js SDK 使用指南 https://help.aliyun.com/zh/agentcore/agentcore-node-js-sdk-user-guide ｜ 使用 Python SDK 快速创建高代码 Agent https://help.aliyun.com/zh/agentcore/create-a-high-code-agent-using-the-python-sdk

语言	运行环境	安装包
Python	Python 3.10+（部分框架更高）	pip install alibabacloud-agentcore-sdk==0.1.1
JavaScript / TypeScript	Node.js 20.3+	npm: alibabacloud-agentcore-sdk
Java	见 Java SDK 指南	—

• 扩展依赖：[mcp,server,credentials,langchain]
• 框架集成：LangChain、LangGraph、AgentScope 2.x、Google ADK、PydanticAI、CrewAI
• 记忆适配入口：agentcore.integrations.memory.langchain / langgraph / agentscope / google_adk / pydantic_ai / crewai

3.3、协议对比

内容	AG-UI	OpenAI Chat Completions
适用场景	展示 Agent 多步执行过程、工具调用与结果	接入使用 Chat Completions 格式的客户端
工具结果	输出独立的工具结果事件	不提供独立的工具结果响应事件
流式	SSE，空闲 15 秒发送心跳注释	流式以 [DONE] 结束

• AG-UI 调用请求体关键字段：threadId、runId、messages、state、tools、context、forwardedProps
• 事件：RUN_STARTED、TEXT_MESSAGE_CONTENT、RUN_FINISHED（success）、RUN_ERROR
• AgentCoreServer 只负责协议接入，不持久化对话历史；会话状态需应用/框架维护
• 托管模型客户端不提供 Embedding 调用；自定义模型客户端 embedding() 仅适用支持向量生成的服务

---

四、支持地域、依赖产品与计费

4.1、支持地域

官方文档：AgentCore 产品概述（含支持地域与依赖产品）https://help.aliyun.com/zh/agentcore/agentcore-product-overview

地域名称	地域 ID
华东 1（杭州）	cn-hangzhou
华东 2（上海）	cn-shanghai
华南 1（深圳）	cn-shenzhen
华北 2（北京）	cn-beijing
新加坡	ap-southeast-1

4.2、依赖产品

产品	用途	开通方式
CMS（云监控）	写入 Tracing 数据	跳转云监控控制台开通
PrivateLink（私网连接）	提供私网访问能力	点击后自动开通
SchedulerX3	提供分布式任务调度能力	跳转售卖页购买

4.3、计费说明

官方文档：AgentCore 计费说明 https://help.aliyun.com/zh/agentcore/agentcore-billing-instructions

采用按量计费，公网流量由 CDT 统一计费和出账。

月费组成：

月费 = 算力 CU 费用 + 网关 CU 费用 + 存储 CU 费用 + 协作专享管控面费用（可选） + 公网流量费用

计费项	计费维度	参考单价（上海）
算力 CU	vCPU 与内存用量换算	0.0000694 元/CU
网关 CU	请求调用次数换算	0.0000015 元/CU（约 0.015 元/万次）
存储 CU	GB/小时换算	0.00025 元/CU
协作专享管控面	实例/小时	3 元/小时（可选）
公网流量	GB（CDT 计费出账）	0.8 元/GB

换算规则：

• 算力 CU：1 vCPU × 1 秒 = 1 CU；1 GB 内存 × 1 秒 = 0.5 CU（1 vCPU + 2GB 运行 1 小时 ≈ 0.4997 元）
• 网关 CU：短连接 1 次请求 = 1 CU；长连接（流式/MCP 长连接/Agent 长会话）每保持 30 秒折算 1 次
• 存储 CU：1 GB × 1 小时 = 1 CU（10GB 保存 1 个月约 1.8 元）

注：表中单价为上海地域参考价，各地域以官网价格页、控制台和账单为准。开通 AgentCore 时一并开通的其他阿里云产品按各自规则独立计费。

---

五、快捷使用

访问地址：https://agentcore.console.aliyun.com/workspaces/none/overview

5.1、快速开通阿里云AgentCore

1）开通AgentCore

确认创建：

开通成功：

2）授权服务关联角色

3）开通三款云产品服务依赖

云监控如下：

Schedulex3：任务调度系统（打通）

5.2、快速创建第一个Agent

1）创建workspace

进入Agent工作台：

2）创建Agent

---

六、本地 Agent 接入机制（opencode / codex 等）

本节回答"AgentCore 如何对接本地的 opencode、codex 这类命令行 Coding Agent，是否支持，底层是什么服务模式"。 官方文档：本地纳管 Agent 使用指南 https://help.aliyun.com/zh/agentcore/local-agent-management-guide ｜ LoongSuite Pilot 开源仓库 https://github.com/alibaba/loongsuite-pilot

6.1、结论速览

本地 Agent	AgentCore 纳管为 Team Worker	LoongSuite Pilot 可观测接入	说明
Codex	✅ 支持	✅ 支持（Hook）	官方纳管运行时，要求 Codex ≥ 0.103
Claude Code	✅ 支持	✅ 支持（Hook）	官方纳管运行时，要求 ≥ 2.1.141
OpenClaw	✅ 支持	✅ 支持（Plugin 注入）	官方纳管运行时（Linux/macOS ≥ 2026.5.12，Windows ≥ 2026.6.11）
Qoder CLI	✅ 支持	✅ 支持（Hook / 会话轮询）	官方纳管运行时，要求 ≥ 1.0.33
OpenCode	⚠️ 官方纳管运行时列表暂未包含	✅ 支持（Plugin 注入）	Pilot 可观测可接入，但未列入 AgentCore"纳管 Agent"运行时，需走变通方案
Cursor / Cursor CLI	⚠️ 未列入纳管运行时	✅ 支持（Hook）	同上

关键区分："能不能观测"与"能不能被 AgentCore 纳管为 Team Worker"是两件事。LoongSuite Pilot 支持的 Agent 范围 ＞ AgentCore"纳管 Agent"官方运行时范围。

6.2、核心机制：LoongSuite Pilot 本地代理（这就是"服务模式"）

AgentCore 对接本地 Agent 的核心，并不是"云端去拉本地代码"，而是在开发者本机安装一个本地代理服务（LoongSuite Pilot），由它把本地 Agent 接入云上控制面。可概括为"本地采集/代管服务 + 出站长连接 + 控制面纳管"模式：

1. 本地服务：loongsuite-pilot 以服务形式常驻本机（status / start / restart），同一台机器只需安装一次。
2. 自动发现：Pilot 从本地路径 / 命令自动发现已安装的 Agent（opencode、codex、claude、cursor、qoder 等）。
3. 注入采集：按 Agent 类型安装对应 hook 或插件（Claude Code / Codex / Cursor 用 Hook，OpenCode / OpenClaw / MiMo Code 用 Plugin 注入），并读取本地日志 / 会话 / 数据文件。
4. 统一 Schema：把不同 Agent 的原生活动归一为统一的 GenAI 事件 schema（Entry / Step / LLM / Tool 等语义单元）。
5. 多目标上报：导出到 JSONL、阿里云 SLS、HTTP、OTLP；在 AgentCore 场景下 Trace 上报到账号下的云监控 2.0（CMS）工作空间。
6. worker 连接：loongsuite-pilot worker connect ... 用控制台生成的 bootstrap token 出站连接，把本地 Agent 纳管为 AgentCore Team Worker。
7. 本地运维与隐私：服务状态 / 重启 / 回滚、内置本地 dashboard；支持按 Agent 的内容采集策略与密钥脱敏。

控制面流程（两步启动命令，缺一不可）：

• 第一步：安装并配置 LoongSuite Pilot；
• 第二步：连接并纳管 Agent。
• 启动命令含连接凭据与云监控配置，属敏感信息，不得持久化或转发。

6.3、本地 Agent 的四种接入路径

路径	适用	机制	说明
本地纳管 Agent	已有本地 CLI（Codex / Claude Code / OpenClaw / Qoder CLI）	LoongSuite Pilot 出站连接，作为 Team Worker	最贴近"本地 opencode/codex"诉求；仅 Worker，不能当 Leader，每个仅加入一个 Team
高代码 Agent	自建 / 可包装为 HTTP 服务	容器镜像 + AgentCore SDK（AgentCoreServer）暴露 AG-UI / Chat Completions	opencode 有 server 模式，理论上可用此路径包装部署
连接器（Connector）	第三方 Agent 平台	当前支持集成 Qoder CLI	集成后由 AgentCore 统一托管
注册 Agent（待上线）	平台外 Agent	注册到平台由平台统一调度	尚未开放

6.4、把 opencode / codex 接进来具体怎么做

Codex（官方支持，推荐路径）

1. 本机安装 Codex（≥ 0.103），确认 codex --version 可用；
2. 控制台创建"纳管 Agent"，配置模型来源（平台模型 / 本地模型）、所属 Team、Skill / MCP；
3. 生成启动命令 → 本机依次执行（安装配置 Pilot + 连接纳管），选择操作系统（Linux/macOS/Windows）与运行时 Codex；
4. 验证：loongsuite-pilot status、loongsuite-pilot worker list/status，控制台连接状态显示"已连接"；
5. 在 Team 中 @ 该 Agent 派发任务，Trace 自动上报 CMS 2.0。

OpenCode（当前建议）

• 仅需观测 / 审计 / 成本：直接安装 LoongSuite Pilot（opencode 走 Plugin 注入），即可接入 AgentLoop / CMS 做 Trace、Token 消耗与审计，无需 AgentCore 纳管。
• 想纳管为 Team Worker：因 AgentCore 官方纳管运行时暂未包含 OpenCode，需关注后续版本支持，或走变通——用 OpenCode 的 server 模式包装为 HTTP 服务，作为高代码 Agent 部署（声明 AG-UI 或 OpenAI Chat Completions 协议）。

6.5、与"服务模式"相关的关键要点

• 出站连接：Pilot 从本机出站访问 AgentCore（公网或 VPC 内网），控制面无需入站访问本机；网络选择同时影响连接与数据上报。
• 凭据隔离：连接使用一次性 bootstrap token（明文仅页面展示一次），疑似泄露需立即重新签发。
• 纳管非托管：Agent 进程仍运行在本机，平台负责调度 / 协作 / 观测；本地生成的文件不会自动上传 Team，需显式以附件交付。
• 资源范围：默认可用"平台 Skill / MCP + 项目目录内 Skill"；本地个人 Skill / MCP 默认不继承，需 --inherit-local-resources true 显式开启。
• 运行限制：纳管 Agent 仅 Team Worker、单团队、需先开通 Team 协作；并发默认 2（可 1–8）。

6.6、远程遥控本地 Coding Agent（Remote Control）

场景引入：下班路上/出差在外，想让家里或公司的机器上的 Codex、Claude Code 继续跑一个重构任务；或者长程任务跑到一半想看看进度、纠个偏——人不在电脑前，能不能遥控本地 Agent？ AgentCore 的"本地纳管 Agent + Team 协作"正是为这个诉求设计的。

① 遥控原理：控制面在云、执行体在本机

你的手机/浏览器/IM
      │ 下发任务 / @ 干预
      ▼
AgentCore 控制面（Team / 任务房间 / AgentCore App）
      │ 出站长连接（bootstrap token）
      ▼
本机 LoongSuite Pilot ──► 本地 Coding Agent（Codex / Claude Code …）在本机执行
      │ 执行过程 Trace 回流
      ▼
云监控 2.0（CMS）—— 远程可见执行每一步

重点：这是"云端控、本地跑"的模式——指令与观测走云，代码与文件始终留在本机（数据不出域），既不牺牲隐私，又能远程操作。

② 四种远程遥控入口

入口	形态	适合场景
AgentCore App	Web/客户端（Matrix 通信）	随时查看会话、@ 智能体干预，人在回路
协作客户端 WEB / API	Team 工作区（AgentTeams 客户端）	看板/任务房间跟进、看子任务依赖图
IM 渠道（钉钉/飞书/企业微信）	手机 @ 机器人	通勤/出差时用手机派活、催进度
定时任务	SchedulerX 调度	无人值守（日报、定时巡检）

③ 远程怎么"遥控"

1. 派活：在 Team 群聊或任务会话中 @ 目标 Agent 发送任务；也可开 Agent 直接会话。任务描述要写明目标、允许改的目录、交付物与验收标准。
2. 看过程：Trace 上报 CMS 2.0，远程可看模型调用、工具调用、知识库召回每一步。
3. 干预：长程任务以"数字会议室/聊天"形式透明呈现，可随时 @ 智能体纠偏（聚焦点、禁止项）。
4. 控制命令：/stop（终止当前执行）、/clear（终止并清空会话上下文）——控制命令需单独发送并 @ 该 Agent。
5. 任务级操作：暂停 / 恢复 / 重试 / 取消 / 归档（不撤销已完成的外部操作）。

注意：本地 Agent 生成的文件不会自动上传 Team；远程交付需在任务里明确"以附件形式提交"，否则文件只留在运行机器上。

④ 与 opencode 自身远程能力的区别

• opencode 自带 client/server 架构（opencode server 进程 + 客户端），本身也能用移动端/远程客户端驱动本地 Agent；
• AgentCore 的价值是把它纳入统一治理：跨 Agent（Codex/Claude Code/…）统一身份、统一观测、统一审计与 Team 协作。若只需单人远程，opencode server 够用；若要企业级多人多智能体协同与审计，走 AgentCore 纳管更合适。

重点：远程遥控的前提是本机 Pilot 处于 running 且心跳正常；机器休眠/断网会导致失联。可用 loongsuite-pilot status / worker status 自查。

6.7、LoongSuite Pilot 安装与操作（命令速查）

官方仓库：https://github.com/alibaba/loongsuite-pilot ｜ 安装文档：https://github.com/alibaba/loongsuite-pilot/blob/main/docs/installation.md

先分清两种场景：

场景	是否需要手动安装 Pilot
仅做可观测（把本地 Agent 的 Trace/Token/审计接入 AgentLoop、CMS、SLS）	需要，按下文手动安装
AgentCore 纳管 Agent（作为 Team Worker）	不需要——控制台生成的启动命令会自动安装或升级 Pilot（见 6.2）

① 前置条件

• Node.js：需能加载 node:sqlite（22.13+ / 23.4+；18/20 及 22.0–22.12/23.0–23.3 不够）。支持的平台安装器会自带 Node 22.22，无需预装。
• npm；curl 或 wget；Windows 需 PowerShell 5.1+。

② 安装

Linux / macOS：

curl -fsSL https://loongcollector-community-edition.oss-cn-shanghai.aliyuncs.com/loongsuite-pilot/installer.sh \
  -o /tmp/loongsuite-pilot-installer.sh && bash /tmp/loongsuite-pilot-installer.sh install

Windows（PowerShell）：

$installer = "$env:TEMP\loongsuite-pilot-installer.ps1"
Invoke-WebRequest `
  -Uri "https://loongcollector-community-edition.oss-cn-shanghai.aliyuncs.com/loongsuite-pilot/installer.ps1" `
  -OutFile $installer
powershell.exe -NoProfile -ExecutionPolicy Bypass -File $installer install

带常用选项（Linux/macOS，指定要监控的 Agent、SLS 上报与脱敏）：

curl -fsSL https://loongcollector-community-edition.oss-cn-shanghai.aliyuncs.com/loongsuite-pilot/installer.sh \
  -o /tmp/loongsuite-pilot-installer.sh && bash /tmp/loongsuite-pilot-installer.sh install \
  --agents "claude-code,cursor,codex,opencode" \
  --userId "your-user-id" \
  --sls-endpoint "https://cn-hangzhou.log.aliyuncs.com" \
  --sls-project "my-project" \
  --sls-logstore "my-logstore" \
  --mask-mode all

注意：安装器会自动发现本机已装 Agent，并让你选择要监控的对象，然后部署 hook/插件、写入配置、启动后台服务。常用选项还有 --all-agents、--multimodal-mode、--dashboard-port、--cms-license-key 等；Linux/macOS 用 --kebab-case，Windows 用 -PascalCase（如 --version → -Version）。

③ 验证

loongsuite-pilot status   # 服务状态
loongsuite-pilot info     # 版本与配置
ls ~/.loongsuite-pilot/logs/output   # 默认已开启本地 JSONL 输出

④ 服务管理与运维

loongsuite-pilot start        # 启动
loongsuite-pilot stop         # 停止
loongsuite-pilot restart      # 重启
loongsuite-pilot status       # 状态
loongsuite-pilot info         # 版本/配置
loongsuite-pilot token-usage  # Token 用量
loongsuite-pilot rollback     # 回滚

本地 Dashboard（随采集器启停，无需单独命令）：浏览器打开 http://127.0.0.1:8765/（端口可在安装时用 --dashboard-port 修改）。macOS 会自动运行菜单栏 App（loongsuite-pilot menubar start/stop），可选安装 Dock 快捷方式：loongsuite-pilot dashboard shortcut install。

⑤ 卸载

# Linux/macOS：保留本地数据
bash /tmp/loongsuite-pilot-installer.sh uninstall
# Linux/macOS：同时删除本地数据目录
bash /tmp/loongsuite-pilot-installer.sh uninstall --purge
# Windows 追加 -Purge 即删除数据

重点：卸载会清理写入各 Agent 配置的集成（Claude Code/Codex/Cursor/Qoder/Qwen 的 hook，OpenCode 的插件规范等）。

⑥ 从源码构建（开发者）

git clone https://github.com/alibaba/loongsuite-pilot.git
cd loongsuite-pilot
npm install && npm run build
node scripts/postinstall.js
node dist/index.js   # 前台启动

⑦ 配置与输出去向

• 配置加载顺序：环境变量 → ~/.loongsuite-pilot/config.json → 内置默认值。
• 输出后端：JSONL（默认本地）、SLS（WebTracking/AK/API Key）、HTTP（POST 到自定义端点）、OTLP Trace（导出为 OpenTelemetry Trace，供 CMS/AgentLoop 使用）。

6.8、官方文档与来源

• 本地纳管 Agent 使用指南：https://help.aliyun.com/zh/agentcore/local-agent-management-guide
• 高代码 Agent 部署与使用指南：https://help.aliyun.com/zh/agentcore/high-code-agent-deployment-guide
• 连接器（Qoder CLI）：https://help.aliyun.com/zh/agentcore/manage-connectors
• LoongSuite Pilot 开源仓库：https://github.com/alibaba/loongsuite-pilot
• 阿里云 CMS 接入 AI 编程助手：https://help.aliyun.com/zh/cms/cloudmonitor-2-0/ai-application-access-ai-coding-agent/

---

七、AgentTeams 迁移至 AgentCore

官方文档：AgentTeams 迁移至 AgentCore https://help.aliyun.com/zh/agentcore/agentteams-has-been-migrated-to-agentcore

AgentCore 的前身/关联产品为多智能体治理与协作平台 AgentTeams（AT），官方提供交互式迁移服务，将 AT 实例的控制面资源迁移至新的 AgentCore（AC）Workspace。

可迁移资源：Workspace 网络配置、协作能力、本地 User、模型供应商/模型、凭证元数据、MCP、Skill、Agent 模板、纳管 Agent、Team 配置。

不在迁移范围：OSS 中运行时数据（配置/记忆/临时产物/任务产物）、钉钉飞书同步配置、外部访问配置、历史任务/会话/调用/用量数据、业务连通性与验收。

迁移要点：

• 使用阿里云主账号 + 阿里云 CLI（≥3.3.0）+ 插件 aliyun-cli-agentteams / aliyun-cli-agentcore
• 通过迁移 Skill（alibabacloud-agentteams-manage / alibabacloud-agentcore-manage / migrate-agentteams-agentcore）执行
• 支持标准模式（逐项确认）与危险模式（分阶段批量确认）；写入失败会暂停、不自动回滚
• 迁移后需：Credential 重新绑定真实 value、重置 Local User 密码、重新配置 IdP/IM Channel、External Agent 重新接入、切换 Endpoint 调用方
• 新 Workspace 生成新 Endpoint，需完成调用方切换与业务验收

---

八、产品负责人视角：AgentCore 全景解读

来源：微信公众号《阿里云 AgentCore 产品负责人解读产品全景》（作者：李国强）｜ 链接：https://mp.weixin.qq.com/s/rMbgCJNDtJlGufuLD53uVg 官方产品负责人访谈提炼，用于理解产品的设计理念与演进方向。

8.1、行业趋势与定位

• 趋势：从"建得多"转向"要结果"；形态收敛为**开源 Harness（简单）、高代码（复杂）、工作流（高确定性/合规）**三类。
• 场景：① 职能岗位智能化（桌面助手/数字员工/研发，指标=人效）；② 业务场景智能化（客服/物流/营销，指标=业务结果）。
• 四大关键点：协作、沉淀、进化、安全与成本——构建门槛已降低，规模化拿结果才是难点。

8.2、构建、运行与集成

• 构建：高代码（任意框架、不绑定，附官方 SDK）+ 无代码托管 Harness（QwenPaw/Qoder CLI）+ 纳管（平台外/桌面端）；规划快速创建与注册。
• 运行：全托管——隔离沙箱、极致弹性、版本管理、灰度发布。
• 集成：标准 AG-UI / A2A 协议 + IM/钉钉打通。

8.3、协作模式

模式	典型	机制
即时并发型	多方向调研	Harness 内置 Sub-Agent 并行，共享上下文/权限后汇总
按需编队	调研→写作→审查	预置模板按序拉起，子 Agent 生命周期与任务关联
长期数字员工	研发"产品经理"角色	能力服务化固定化，长期观测进化，主子协同

Team 模式：多人 + 多智能体对等协作，Leader 拆解分派、Worker 执行。

重点（数字会议室）：所有智能体交互与产出以聊天形式透明呈现，人可随时 @ 干预，解决长程任务的偏差与可见性问题。

8.4、上下文工程与资产

• 上下文：集成百炼/OTS 知识库、OTS/PolarDB 记忆 + 自带记忆；方向是记忆与知识融合、混合检索、多智能体下权限隔离与共享。
• 四类资产：Skill（渐成核心业务逻辑载体，需市场/版本/安全扫描/权限/调优）、MCP（存量转 MCP + 权限控制）、模型（多供应商统一管理 + 路由/降级/流控/限额）、Agent 模板（一键克隆）。
• Skill 生命周期：开发 → 多版本管理（内置 Nacos）→ 安全扫描（静态 + 依赖漏洞 + 提示词注入审查）→ 分发权限 → 评估调优。
• Catalog 三层：个人层（仅自己）→ 企业层（共享，含审批/扫描/权限/元数据/SLA）→ 外部市场层。

8.5、观测、评估与治理

• 数据飞轮：采集（模型/工具/知识库全链路）→ 分析（效率=轮次/工具；成本=Token）→ 评估 → 优化 → 再上线；集成 AgentLoop，默认集成 OpenClaw/Hermes/Dify/AgentScope 等。
• 评估器三类：LLM-as-a-Judge（语义）、Code-as-a-Judge（确定性规则）、Agent-as-a-Judge（强业务，与专家一致性 90%+，可用自然语言创建）。
• 身份与安全："入"（用户能否调 Agent，集成企业 IDP）+ "出"（Agent 能否调 MCP/外部系统，内置 AI 网关），全程 Tracing 可审计；每个 Agent 有唯一身份（Agent Identity）。
• 成本：看清 → 告警 → 控制（AI 网关按用户/Agent 设 quota，超限限流/降级/阻断）。

官方服务钉群：185130001370

---

九、调研小结

9.1、产品定位总结

阿里云 AgentCore 是面向企业级的 Agent 构建与治理平台，核心差异化在于三点：

1. 多来源统一纳管：自研（高代码）、开源 Harness（QwenPaw/Qoder）、本地纳管（Claude Code/Codex/OpenClaw/Qoder CLI）、商业 SaaS Agent，统一在一个 Workspace 治理。
2. 全生命周期治理：从构建、运行、协作、到身份权限、可观测、评估调优，形成闭环（"建得快、管得住、协作好"）。
3. 企业级安全合规：凭据隔离与加密托管、双向鉴权 + RBAC、全量审计日志、全链路 Trace，契合国内企业合规诉求（钉钉/飞书/企业微信原生集成）。

9.2、核心优势

• 阿里云生态深度整合（百炼模型/知识库、Tablestore、CMS、SchedulerX、FC 等）
• 托管 Harness 降低门槛（零编码创建）+ 高代码/纳管满足存量整合
• 多智能体 Team 协作 + 任务系统 + 定时任务，面向"数字员工/智能问数"等复杂业务
• IM 渠道与账号集成，开箱即用地融入企业办公流

9.3、关注点/待成熟

• 部分能力标注"待上线/即将上线"：注册 Agent、快速创建（低代码）、虚拟 MCP、Skill 自定义别名
• 账号集成每类最多 100 用户，规模受限
• 知识库仅支持 OTS 与百炼，且为只读检索
• 高代码镜像仅支持企业版 ACR 且需公开匿名拉取（需注意敏感数据隔离）
• 计费项较多（算力/网关/存储/协作管控面/流量），需按量估算成本

9.4、官方文档索引

产品与总览

文档	链接
产品页（官网）	https://www.aliyun.com/product/agentcore
帮助中心首页	https://help.aliyun.com/zh/agentcore/
产品概述	https://help.aliyun.com/zh/agentcore/agentcore-product-overview
基本概念	https://help.aliyun.com/zh/agentcore/agentcore-basic-concepts
操作指南	https://help.aliyun.com/zh/agentcore/operating-guide/
计费说明	https://help.aliyun.com/zh/agentcore/agentcore-billing-instructions

核心功能

模块	链接
管理 Workspace	https://help.aliyun.com/zh/agentcore/manage-workspace
管理 Agent	https://help.aliyun.com/zh/agentcore/manage-agents
托管 Harness Agent 使用指南	https://help.aliyun.com/zh/agentcore/agent-instructions-managed-harness
高代码 Agent 部署与使用指南	https://help.aliyun.com/zh/agentcore/high-code-agent-deployment-guide
本地纳管 Agent 使用指南	https://help.aliyun.com/zh/agentcore/guidelines-for-the-use-of-local-nanoagent
管理 Agent 模板	https://help.aliyun.com/zh/agentcore/manage-agent-templates
管理模型	https://help.aliyun.com/zh/agentcore/model-management
管理 Skill	https://help.aliyun.com/zh/agentcore/manage-skill
Skill 版本管理概述	https://help.aliyun.com/zh/agentcore/overview-of-skill-version-management
管理 MCP 工具	https://help.aliyun.com/zh/agentcore/managing-the-mcp-server
连接表格存储 OTS 知识库	https://help.aliyun.com/zh/agentcore/connect-table-store-ots-knowledge-base-in-agentcore
连接百炼知识库	https://help.aliyun.com/zh/agentcore/connect-the-refined-knowledge-base-in-the-agentcore
管理凭证	https://help.aliyun.com/zh/agentcore/manage-credentials
管理连接器	https://help.aliyun.com/zh/agentcore/manage-connectors
查看概览	https://help.aliyun.com/zh/agentcore/view-overview

协作与集成

模块	链接
设置 Team 协作	https://help.aliyun.com/zh/agentcore/set-up-team-collaboration
协作 TeamHarness 使用说明	https://help.aliyun.com/zh/agentcore/team-collaboration-instructions-collaboration-teamharness
使用 Team 任务	https://help.aliyun.com/zh/agentcore/using-team-tasks
使用 Team 设置定时任务	https://help.aliyun.com/zh/agentcore/use-team-web-to-set-tasks
将 Agent 接入 IM 渠道	https://help.aliyun.com/zh/agentcore/integrate-the-agent-into-the-im-channel
配置钉钉账号集成	https://help.aliyun.com/zh/agentcore/agentcore-configure-dingtalk-account-integration
配置飞书账号集成	https://help.aliyun.com/zh/agentcore/configure-dingtalk-account-integration
管理用户	https://help.aliyun.com/zh/agentcore/manage-users

开发参考

模块	链接
SDK 概述	https://help.aliyun.com/zh/agentcore/agentcore-sdk-overview
Python SDK 使用指南	https://help.aliyun.com/zh/agentcore/agentcore-python-sdk-user-guide
Node.js SDK 使用指南	https://help.aliyun.com/zh/agentcore/agentcore-node-js-sdk-user-guide
使用 Python SDK 快速创建高代码 Agent	https://help.aliyun.com/zh/agentcore/create-a-high-code-agent-using-the-python-sdk

前身与迁移

文档	链接
AgentTeams 迁移至 AgentCore	https://help.aliyun.com/zh/agentcore/agentteams-has-been-migrated-to-agentcore
AgentCore 公测发布（产品动态）	https://www.aliyun.com/product/news/29444
AgentTeams 产品页	https://www.aliyun.com/product/agentteams
AgentTeams 帮助中心	https://help.aliyun.com/zh/agentteams/
AgentTeams 产品概述	https://help.aliyun.com/zh/agentteams/magic-console-product-overview
AgentRun 帮助中心	https://help.aliyun.com/zh/agentrun/

---

参考资料

[1]. 智能体构建与治理平台 AgentCore（官网产品页）

[2]. 智能体构建和治理平台 AgentCore（帮助中心首页）

[3]. AgentCore 产品概述

[4]. AgentCore 基本概念

[5]. AgentCore 计费说明

[6]. 本地纳管 Agent 使用指南

[7]. 高代码 Agent 部署与使用指南

[8]. 阿里云 AgentCore 产品负责人解读产品全景（微信公众号·李国强）

[9]. LoongSuite Pilot（GitHub 开源仓库）

[10]. AgentTeams 多智能体治理与协作平台（帮助中心）

[11]. AgentCore 公测发布（阿里云产品动态）

[12]. AI Coding Agent 接入 AgentLoop（阿里云云监控 CMS）

[13]. QwenPaw：数据归你、记忆进化的开源个人智能体（阿里云开发者社区）

[14]. QwenPaw 开源仓库（AgentScope 团队）

[15]. LoongSuite Pilot 安装文档（Installation Guide）

[16]. AgentForge（作者自研 Agent 基础设施开源项目）

---

整理者：长路　创建时间：2026.10.8　更新时间：2026.10.11