说明：
当前功能属于 Beta 阶段，建议仅用于测试与 PoC。公有云可用地域：上海、香港。
弹性部署（Deployment）是 Agent Runtime 面向在线服务场景提供的长期托管资源。它绑定一个自定义沙箱工具作为运行的环境定义，通过稳定的数据面入口接收请求，并按配置创建、复用、暂停或释放沙箱实例。
能力概述
稳定入口：同一弹性部署 ID 的数据面域名保持稳定，后端沙箱实例可以动态变化。
弹性伸缩：通过最小实例数、最大实例数和单实例请求并发上限控制容量。
空闲生命周期：沙箱实例空闲达到阈值后，可以选择
STOP 释放实例，或选择 PAUSE 保留状态并在后续请求到来时恢复。会话亲和：可按 Header 中的 Affinity ID 优先复用、严格复用或独占一个沙箱实例；默认不启用。
适用场景
如果您的应用需要长期在线、通过固定地址提供服务，并希望平台根据访问量自动调整运行实例，可以使用弹性部署。例如：
运行自建的 Agent 应用，根据用户请求量自动增加或减少运行实例。
运行供 Agent 调用的 MCP Server，让多个 Agent 通过统一地址稳定访问。
运行 Web API、自动化服务等其他在线应用，并在空闲时自动弹性缩减资源。
快速入门示例
示例 | 说明 |
创建沙箱工具和弹性部署（Deployment）资源，通过本地 proxy 与生产域名访问 httpbin，并清理资源。 | |
从按需启动切换到常驻容量，理解三个伸缩参数及完整替换更新。 | |
依次观察空闲实例的 STOP 与 PAUSE 行为。 | |
比较共享的 BEST_EFFORT 与专属的 EXCLUSIVE 会话亲和。 | |
部署示例 MCP Server，使用原生 Python SDK，并观察 0 → N → 0 与缩容到零后的新会话。 | |
部署 all-in-one DeepSeek Harness，通过 TokenHub 完成编码任务，并验证独占会话的暂停与恢复。 | |
运行多副本无状态 DSH Brain，以 MySQL 保存状态，并访问持久的 E2B/envd Hands workspace。 |
工作方式
核心概念
概念 | 说明 |
弹性部署 | 用户管理的在线服务资源，保存伸缩、空闲生命周期、会话亲和和标签配置。 |
沙箱工具 | 弹性部署运行的环境定义。创建弹性部署时必须绑定当前账号可见且 Persistent=true 的沙箱工具；创建后不能更换。 |
沙箱实例 | 承载实际请求的运行实例。实例由平台按需启动或恢复，并根据伸缩和生命周期配置回收。 |
请求路径
1. 客户端获取弹性部署的短期 Token。
2. 客户端访问端口对应的数据面域名，并在
X-Access-Token Header 中携带 Token。3. 弹性部署根据可用容量和亲和配置选择已有沙箱实例，或按需启动、恢复新的沙箱实例。
4. 响应通过同一稳定入口返回客户端。
HTTP 端口的数据面域名格式如下：
https://{port}-{deployment-id}.{region}.agents.{data-plane-domain}
例如，弹性部署 ID 为
dpl-amfzcemg、地域为 ap-shanghai，访问端口为 8080，且使用默认数据面域名 tencentags.com 时，访问地址为：https://8080-dpl-amfzcemg.ap-shanghai.agents.tencentags.com
本地开发也可以使用
agr deployment proxy 把远端 HTTP 端口映射到 127.0.0.1；该代理用于调试，不应作为生产流量入口。配置说明
配置 | 说明 |
伸缩配置 | 通过最小实例数、最大实例数和单实例请求并发上限控制容量。 |
空闲生命周期 | 实例空闲达到阈值后执行 STOP 释放实例，或执行 PAUSE 保留状态并在后续请求到来时恢复。 |
会话亲和 | 按 Header 中的 Affinity ID 优先复用、严格复用或独占一个沙箱实例；默认不启用。 |
资源标签 | 创建和修改时可配置 Tencent Cloud Tag。 |
生命周期
状态说明
状态 | 说明 |
ACTIVE | 弹性部署入口可以接收请求。该状态不表示已经存在运行中的沙箱实例。 |
DELETING | 正在异步删除，不能再修改配置。 |
DELETE_FAILED | 上一次异步删除失败。查询 StatusReason 排查原因，修复后可再次删除。 |
说明：
创建请求成功后弹性部署会进入
ACTIVE。即使 MinInstanceCount 大于 0，创建接口也不会等待沙箱实例完成预热；后台会继续把活跃容量收敛到目标下限，因此首次请求仍可能包含实例启动或恢复延迟。使用限制
弹性部署 ID 是不透明标识，只能完整保存和传递，不要解析其前缀或长度。
弹性部署名称在同一账号、同地域内必须唯一，并符合 DNS-1123 subdomain 命名规则。
已处于
DELETING 或 DELETE_FAILED 的同名资源仍占用名称。弹性部署删除是异步操作。生产自动化应查询最终状态，或使用
agr deployment delete --wait 等待完成。警告：
修改伸缩、生命周期或亲和配置时，传入的对象会完整替换原对象；应同时提供该对象的全部字段。
