Agent Runtime 弹性部署(beta)

一、能力概述

·稳定入口：同一弹性部署 ID 的数据面域名保持稳定，后端沙箱实例可以动态变化。

·弹性伸缩：通过最小实例数、最大实例数和单实例请求并发上限控制容量。

·空闲生命周期：沙箱实例空闲达到阈值后，可以选择 STOP 释放实例，或选择 PAUSE 保留状态并在后续请求到来时恢复。

·会话亲和：可按 Header 中的 Affinity ID 优先复用、严格复用或独占一个沙箱实例；默认不启用。

如果你的应用需要长期在线、通过固定地址提供服务，并希望平台根据访问量自动调整运行实例，可以使用弹性部署。例如：

·运行自建的 Agent 应用，根据用户请求量自动增加或减少运行实例。

·运行供 Agent 调用的 MCP Server，让多个 Agent 通过统一地址稳定访问。

·运行 Web API、自动化服务等其他在线应用，并在空闲时自动弹性缩减资源。

示例	说明
httpbin/simple	创建沙箱工具和弹性部署（Deployment）资源，通过本地 proxy 与生产域名访问 httpbin，并清理资源。
httpbin/scaling	从按需启动切换到常驻容量，理解三个伸缩参数及完整替换更新。
httpbin/lifecycle	依次观察空闲实例的 STOP 与 PAUSE 行为。
httpbin/affinity	比较共享的 BEST_EFFORT 与专属的 EXCLUSIVE 会话亲和。
mcp-server/simple	部署示例 MCP Server，使用原生 Python SDK，并观察 0 → N → 0 与缩容到零后的新会话。
deepseek-harness/all-in-one	部署 all-in-one DeepSeek Harness，通过 TokenHub 完成编码任务，并验证独占会话的暂停与恢复。
deepseek-harness/brain-hands	运行多副本无状态 DSH Brain，以 MySQL 保存状态，并访问持久的 E2B/envd Hands workspace。

如需通过完整示例理解各项能力与示例代码，请参见 Deployment Cookbook。

概念	说明
弹性部署	用户管理的在线服务资源，保存伸缩、空闲生命周期、会话亲和和标签配置。
沙箱工具	弹性部署运行的环境定义。创建弹性部署时必须绑定当前账号可见且 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 等待完成。

注意：警告：

注意：修改伸缩、生命周期或亲和配置时，传入的对象会完整替换原对象；应同时提供该对象的全部字段。