AgentCore 快速入门

流程总览

协作管控面开通是异步流程。如需减少等待，可以在完成步骤一后先提交步骤四的开通申请，再回到步骤二、步骤三继续配置，最后在创建 Team 前确认接入点已就绪。

准备工作

• 已注册阿里云账号并完成实名认证。

• 已完成AgentCore及相关产品开通。

  • 使用 AgentCore 需要开通其他阿里云云产品作为依赖，这些产品按各自的计费规则独立计费。详情见AgentCore 产品概述。

• 已完成账号授权。

  • 授权方案需要区分主账号和子账号， 主账号可以根据控制台授权指引完成操作，子账号则需要管理员调整RAM权限，详情见通过 RAM 授权子账号使用 AgentCore 控制台。

• 已创建 Workspace：点击页面左上角下拉列表框，在弹出的菜单中点击创建 Workspace，配置 Workspace 名称，按需选择是否绑定 VPC，在存储配置区域选择存储模式，点击创建。

创建完成后，确认已进入目标 Workspace，且 Workspace 状态为运行中。后续的模型连接、Agent、用户和 Team 都归属于该 Workspace。

• 已取得模型供应商的 API Key。以阿里云百炼为例，在百炼控制台的 API Key 管理页面创建并保存 API Key。

请勿自行修改或删除 Workspace 存储配置中自动创建的 Bucket 文件，也不建议调整 Bucket 配置，以免影响 Workspace 及相关功能正常运行。

步骤一：创建并调试模型连接

Agent 运行依赖模型配置。模型连接用于与各模型供应商建立连接，统一维护其凭证与模型列表；同一供应商可按业务或环境拆分多条连接，分别使用、管理与观测。一个连接下可以接入多个模型。

1. 登录 AgentCore 控制台，进入目标 Workspace。

2. 在左侧导航栏的资产管理分组下，点击模型连接。页面标题为模型管理，顶部有模型列表与模型连接两个标签页，标签后的数字为该页签下的对象数量。

3. 在模型连接标签页，点击右上角添加模型，进入添加模型连接页面。

4. 在基本信息区域配置以下参数。

   参数	说明
   模型供应商	必填。选择预制模型供应商（如阿里云百炼）或自定义模型供应商。使用阿里云 Coding Plan 时，需切换为自定义模型供应商并选择 Open AI 兼容，再填写对应的模型服务配置。
   模型连接名称	必填。输入模型连接的名称。
   API 端点	必填。输入符合 OpenAI 规范的 API 端点地址。
   访问凭证	必填。选择手动输入 API Key 并输入密钥，密钥将加密存储。可点击添加凭证添加多个凭证实现轮转；使用阿里云百炼时，可点击获取百炼 API Key 跳转到百炼控制台创建。
   描述	（可选）模型连接的用途说明，最长 255 个字符。

5. 在模型配置区域勾选需要接入的模型，本流程以 qwen3.8-flash 为例。列表展示供应商目录下可用的大语言模型，每行给出模型名称、上下文长度与能力标签（如工具调用、多工具调用、流式工具调用、视觉、视频、推理），可通过搜索框按模型名称筛选，表头显示已选择的模型数量。

6. 点击右上角确定，完成模型连接创建。

7. 验证连接可用：回到模型连接标签页，将鼠标移到目标连接卡片上，点击调试，输入测试内容并发送。返回正常状态与模型回复，说明连接与凭证配置正确。

结果确认：模型连接标签页出现该连接卡片，状态为可用，卡片上展示供应商、创建时间、API 端点、已接入的模型与描述；模型列表标签页中可以看到这些模型。连接卡片悬停时提供详情、调试、删除三个操作。

API Key 属于访问凭证，请妥善保存，不要粘贴到 Agent 对话、共享文档或代码仓库中。

步骤二：创建两个 Agent

本流程创建两个 Agent：一个作为 Team 的 Leader，负责组织分工与汇总结果；一个作为 Worker，负责执行具体工作。两个 Agent 均以托管 Harness 方式创建。

以自定义代码 / 镜像方式创建的 Agent 暂不支持加入 Team。若后续需要组建 Team，请使用托管 Harness 方式创建。

1. 在左侧导航栏，点击 Agent。

2. 点击创建 Agent。

3. 选择创建方式：托管 Harness。

4. 配置基本信息。

   参数	说明
   Harness	必填。下拉选择托管 Harness，选项带能力说明，例如 Qwen Paw（通用 AI 助手，擅长知识问答、文档处理与定时报表）。
   Agent 模板	选择是否使用模板配置 Agent，默认为不使用模板（自行配置）。不使用模板时，仅需填写系统提示词，无需准备 SOUL.md / AGENTS.md。
   Agent 名称	必填。输入 Agent 名称。
   模型连接	必填。选择步骤一创建的模型连接，下拉显示「连接名称（供应商）」。可点击右侧的加号直接新建模型连接。
   模型	必填。选择该连接下已接入的模型，本流程以 qwen3.8-flash 为例。
   思考强度	下拉选择模型的思考强度，默认为 default。
   Token 配额	通过启用 Token 配额开关开启。开启后输入配额上限并选择计量周期（天 / 周 / 月）。
   描述	（可选）Agent 的用途说明，最长 255 个字符。

5. 在文件配置中输入 Agent 的系统提示词，描述该 Agent 的角色、职责和工作方式。

   • Leader 的系统提示词需说明业务职责、成员与分工、需求与任务的对应关系、分工思路和交付要求。

   • Worker 的系统提示词只需定义业务处理能力，无需重复团队调度、状态反馈和结果提交等内置协作规则。

   • 系统提示词支持提示词变量：点击系统提示词右上角的提示词变量（N）打开弹窗，点击新增变量填写变量名、描述和默认值，在正文中以 {variable_name} 形式引用。变量名须以英文字母或下划线开头，仅包含字母、数字和下划线。

6. 本流程不配置 Skill，也不绑定其他资产。创建页以页签形式提供 Skill、SubAgent、工具、知识库、记忆、凭证六类资产，可在跑通本流程后按需扩展。

7. 配置资源配置。

   参数	说明
   规格	必填。选择实例所需的 CPU 和内存。
   实例最大 Session 数	必填。设置单个实例承载的 Session 数量上限，取值范围 1–20。
   Session TTL（秒）	必填。设置平台 Session 的存活时间参数，取值范围 60–86400；这不是模型单次生成的超时时间。
   最小实例数	必填。取值范围 0–100。
   最大实例数	必填。取值范围 0–100。

8. 配置网络配置。

   参数	说明
   允许默认网卡访问公网	Agent 需要访问公网模型服务或其他公网接口时，按需开启。
   允许访问 VPC	Agent 需要访问 Workspace 的 VPC 资源时，按需开启。开启后使用当前 Workspace 的 VPC 配置。Workspace 未绑定 VPC 时，页面提示先绑定 VPC。

9. 点击立即创建。

10. 重复步骤 1–9，用同样的方法创建第二个 Agent，作为 Team 中的 Worker。

结果确认：Agent 列表中两个 Agent 的状态均为正常。点击详情可查看 Agent 信息，点击编辑配置可修改配置。

步骤三：创建一个用户

用户是协作客户端中的登录身份，与阿里云账号不同。Team 的团队 Admin 和团队成员都必须是已创建的用户。

1. 在左侧导航栏的身份与权限分组下，点击用户管理。

2. 点击创建用户。

3. 配置以下参数。

   参数	说明
   用户名	输入用户名称，用于标识和区分不同用户。
   显示名称	对外显示的用户名称。
   邮箱	用户的邮箱。
   认证方式	仅支持本地账号。
   密码设置	可选择自动生成密码或自定义密码。自定义时按页面要求设置：8–32 个字符，同时包含小写字母、大写字母、数字和特殊字符，且不能包含用户名。

4. 点击立即创建。

结果确认：用户管理列表中出现该用户，认证方式为本地账号，状态为活跃。

请自行设置并妥善保存登录密码，无需在对话中告知 Agent。

步骤四：开通协作管控面

Team 协作依赖协作管控面实例。未开通时，Team 协作页面会显示协作功能暂未开通。

1. 在左侧导航栏的 AGENT 协作 分组下，点击 Team 协作。

2. 页面显示协作功能暂未开通时，点击立即开通，在开通协作确认框中点击开通。

3. 配置协作服务的网络接入方式。

   参数	说明
   公网访问	通过开关开启 / 关闭。开启后，协作客户端可通过公网地址访问。
   VPC 接入	通过开关开启 / 关闭。开启后，协作客户端可通过 VPC 内网地址访问；开启后需选择 VPC 和交换机，请至少选择两个不同可用区的交换机，以保证协作服务的高可用。

   公网访问和 VPC 接入至少开启一项。若 Workspace 未绑定有效 VPC，则必须开启公网访问。

4. 点击开通。系统跳转到购买页，按页面提示创建协作管控面实例。协作管控面实例按对应产品定价收费。

5. 等待开通完成。页面显示协作管控面创建中，预计耗时 3–5 分钟。开通在后台异步执行，期间可以继续完成步骤二和步骤三，请勿重复提交。

6. 回到 Team 协作 → 接入管理 → 连接点，确认协作客户端 (WEB) 与协作客户端 (API) 的状态均为运行中。

结果确认：连接点页面展示协作客户端 (WEB)（Web 控制台端点，提供可视化操作界面）和协作客户端 (API)（API 接入端点，提供程序化访问接口）的公网及私网地址，状态为运行中。

步骤五：创建 Team

1. 确认步骤四已完成，协作客户端 (WEB) 连接点处于运行中状态。

2. 在左侧导航栏的 AGENT 协作 分组下，点击 Team 协作，切换到团队管理。

3. 点击创建 Agent 团队。

4. 在 1. 基本信息区域配置以下参数，完成后点击下一步。

   参数	说明
   团队名称	Agent 团队的名称。
   团队 Admin	Agent 团队的管理员（人类用户），选择步骤三创建的用户。团队 Admin 可以维护团队信息、增删团队成员与团队 Agent、更换 Team Leader。
   团队成员	（可选）为 Agent 团队添加成员（人类用户）。
   描述	（可选）Agent 团队的用途说明。

5. 在 2. Team Leader 配置区域配置以下参数，完成后点击下一步。

   参数	说明
   Leader 来源	取值为选择已有 Agent 或新建 Leader Agent。
   Agent	选择作为 Leader 的 Agent，即步骤二中第一个创建的 Agent。选定的 Agent 负责任务拆解与分派，不会重复出现在团队成员中。

6. 在 3. 团队 Agent 配置区域，从可用 Agent中选择要加入 Team 的 Agent（即步骤二中第二个创建的 Agent），选定后展示在已加入 Agent中。Leader 不需要在这一步重复添加。

7. 点击立即创建。

结果确认：团队列表中该团队状态显示正常，Agent 数为 2，团队 Admin 与 Leader Agent 与配置一致。点击详情可查看团队信息，点击编辑可修改，点击删除可删除团队。

以下 Agent 无法加入团队，控制台会在对应 Agent 上给出提示，可点击查看详情了解原因：

• 以自定义代码 / 镜像方式创建的 Agent，暂不支持加入团队。

• 已作为其他团队 Leader 的 Agent。

• 已归属其他团队的 Agent，控制台会同时提示其所属团队名称。

若提示暂时无法确认 Agent 的团队归属，请刷新页面后重新选择。

步骤六：在团队会话中发送消息

1. 在左侧导航栏的 AGENT 协作 分组下，点击 Team 协作，进入接入管理的连接点。

2. 找到协作客户端 (WEB)，确认状态为运行中，点击打开，进入 AgentCore App。

3. 在登录入口点击 Continue with password，填写步骤三创建的用户名和密码，点击登录。

4. 首次登录出现授权请求时，核对应用对应当前 Workspace，确认 OpenID Connect 身份认证请求后点击允许，返回客户端。

5. 进入聊天，选择目标会话。

   会话	说明
   Team: <团队名称>	团队群聊。团队内所有 Agent 均在其中，适合围绕同一份成果组织多 Agent 讨论。
   Leader DM: <团队名称>	与 Leader 的私聊。适合先商量需求、明确目标，再由 Leader 组织执行。

6. 选择 Team: <团队名称> 群聊，发送一条消息确认两位 Agent 均在线：点击输入框下方的 @，从成员列表中依次选择两个 Agent，在输入框中写明要求（例如「请各自回复一句，确认当前在线」），点击发送。

结果确认：会话中先后出现两位 Agent 的回复，说明 Team 组建成功、两个 Agent 均可正常响应。若某位 Agent 长时间未回复，回到控制台确认该 Agent 状态为正常、模型连接状态为可用。

结束后清理资源

本次流程创建的 Team、Agent、协作管控面和 Workspace 会持续产生费用。不再使用时，按以下顺序回收：保存需要的成果文件 → 删除 Team → 删除两个 Agent → 关闭协作 → 删除模型与模型连接 → 删除用户 → 删除 Workspace。

关闭浏览器或退出聊天不等于完成清理，需回到控制台操作。

开通服务时一并开通的 CMS（云监控）、PrivateLink（私网连接）和 SchedulerX3 不会随 Workspace 删除而停止计费；如不再使用，需在各产品控制台单独处理。

后续步骤