DashScope Managed Agents API 商业化：新工作空间级 Agent 运行时对路由架构意味着什么

阿里云百炼平台宣布，Managed Agents API 的商业计费将从 **2026 年 8 月 17 日 09:00（北京时间）**开始。对于将工作负载路由到 DashScope 的团队，这同时改变了两件事：网关必须支持的 endpoint 架构，以及平台托管 Agent 会话的成本模型。

发生了什么

阿里云百炼（Model Studio）于 2026 年 6 月底上线了生产可用的 Managed Agents API，覆盖四种资源类型的完整 CRUD：Agent、Session、Skill 和 File。该 API 运行在专属子路径下，与推理 endpoint 完全独立：

https://{workspace_id}.{region}.maas.aliyuncs.com/api/v1/agentstudio

这与现有的 OpenAI 兼容 endpoint（/compatible-mode/v1）和 Anthropic 兼容 endpoint（/apps/anthropic）相互独立。它采用与 DashScope 推理服务相同的工作空间级 base URL 模式，但现在扩展到了有状态的 Agent 会话。

支持的资源操作：

• Agent：创建、读取、列出、删除
• Session：创建、获取、列出、更新、删除、归档；发送事件；订阅 SSE 事件流
• Skill：创建、列出、版本管理、下载版本化 Skill 包
• File：上传（multipart/form-data）、查询、列出、删除

鉴权为工作空间级：一个 API Key 通过 Authorization: Bearer <key> 覆盖其所属工作空间的全部资源。目前仅支持华北 2（北京）地域。

SDK 版本要求：Python SDK dashscope >= 1.26.2 和 Java SDK dashscope-sdk-java >= 2.22.24 为必要条件。低于这些版本的 SDK 不包含 Managed Agents 模块，必须在 8 月 17 日前升级。

对 AI 工程团队的影响

8 月 17 日商业化日期是第一个强制截止点。在免费预览期间测试过 Managed Agents 的团队需要在此日期前决定是否继续使用托管运行时——以及成本如何——或者切换到其他方案。

从结构上看，工作空间级 Agent 运行时改变了 DashScope 在多 provider 路由架构中的定位：

DashScope 现在暴露三个独立的 endpoint 命名空间。 将 DashScope 视为单一 base URL 的网关将遗漏推理（OpenAI 兼容）、推理（Anthropic 兼容）和 Agent 运行时（agentstudio）之间的分割。每个命名空间有不同的 token 鉴权范围、重试语义和计费模型。

会话生命周期由平台管理，不是无状态请求。 与原始推理调用不同，Managed Agent 会话在阿里基础设施上携带状态。如果网关不理解会话所有权，透明重试或跨地域故障转移将失败或破坏状态。来自 GET /sessions/{session_id}/events 的 SSE 流在连接中断时无法简单重试。

Skill 引入了并行版本维度。 Skill API 允许团队上传 Agent 调用的版本化包。这创建了独立于模型版本固定的部署产物——你需要在路由配置中同时跟踪模型 ID 和 Skill 版本。

DashScope Managed Agents API Routing 的运维视角

在 8 月 17 日前，路由团队必须做出的运维决策：

工作空间隔离与共享 Key 的选择：工作空间内的所有资源共享一个计费账户。在 DashScope 上运行多团队或多客户工作负载的团队需要独立的工作空间——以及独立的 base URL——才能实现按团队的成本归因。在计费开始后再做改造需要迁移会话。现在就设置好。

网关中的 SSE 透传：会话通过 SSE 流式传输事件。在超时时断开 SSE 连接的路由代理（对于 30s 或 60s 限制的 HTTP/1.1 代理很常见）将丢失进行中的 Agent 事件。为 /api/v1/agentstudio 路径添加专用的 SSE 透传规则，与推理路径区分开来。

7 月 20 日网关维护窗口：DashScope 发布了一个单独的网关基础设施变更通告，生效时间为 2026 年 7 月 20 日 23:00（北京时间）——距今两天。通告内容简短，但任何网关基础设施变更都值得关注。在该窗口之前，请查看官方 DashScope 发行说明。通过 DashScope 路由的团队应提前准备好 fallback provider，以防变更产生意外影响。

单地域单点故障：目前仅支持华北 2（北京），这意味着 Managed Agent 会话无法复制或故障转移到新加坡或法兰克福。如果你的 SLA 需要多地域弹性，目前无法通过 DashScope Managed Agents 实现。在 8 月 17 日前，将此因素纳入托管 Agent 会话的自建或外采决策。

TheRouter 用户需要关注的事项

• 现在审查你的 SDK 版本。 如果你的代码库固定了 dashscope < 1.26.2（Python）或 dashscope-sdk-java < 2.22.24（Java），则缺少 Managed Agents 模块。在商业计费开始前更新。
• 将 /api/v1/agentstudio 添加到你的网关路径路由规则中。 此子路径不在 OpenAI 兼容或 Anthropic 兼容路由规则集中。遗漏它意味着 Agent API 调用将路由到错误的处理器或因 404 失败。
• 提前按成本中心创建工作空间。 工作空间分离是 DashScope Managed Agents 成本归因的唯一粒度。在 8 月 17 日前完成此操作，可避免在计费上线后匆忙迁移会话。
• 关注 7 月 20 日网关变更。 即使是尚未使用 Managed Agents 的团队，也应在 7 月 20 日晚（北京时间）监控其 DashScope 推理错误率。

从更宏观的视角来看，DashScope Managed Agents 是 Anthropic Managed Agents 和 Google Gemini Enterprise Agent Platform 的阿里云对应产品——三大主要平台现在都在推理之上提供了托管会话和 Skill 运行时。路由运维人员的差异化问题是：哪个平台的 Agent 运行时能为你的工作负载提供所需的工作空间隔离、地域覆盖和 SSE 可靠性？

官方 API 参考请查阅中文文档：help.aliyun.com/zh/model-studio/managed-agents-api-overview。Managed Agents API 的英文文档目前尚未发布。