智能体运行时（Agent Runtime，下文简称“运行时”或“Runtime”）是 AgentKit 为 Agent 提供一个安全隔离且框架与模型无关的托管式运行时环境，支持基于业务流量自动扩缩容关联实例，支持内置 IAM Role 控制智能体运行时访问云资源的权限。

什么是运行时

运行时是智能体真正“跑起来”的地方。创建运行时后，AgentKit 会基于您提供的代码或镜像、运行时配置、模型配置、安全访问规则和关联组件信息，生成一个可托管、可发布、可观测的智能体运行环境。对用户而言，运行时既是智能体的部署载体，也是调用入口、版本管理单元和运维管理单元。

从定位上看，运行时位于“开发完成”和“线上服务”之间：上承智能体代码、模型与工具能力，下接实例、网络、日志、权限与发布体系。开发者不需要自行搭建底层计算、网络和安全基础设施，只需关注智能体逻辑和业务配置，平台会负责实例拉起、弹性调度、访问控制和版本发布。

核心能力

Serverless 全托管执行：无需手动维护计算、网络、存储、安全策略，平台完成底层资源编排，自动生成统一接入调用域名。

自动化弹性伸缩：平台将根据请求并发、计算负载自动完成实例扩缩容；支持配置最小常驻实例消除冷启动，无请求时自动销毁空闲实例，节约成本。

框架/模型无关：原生深度适配 VeADK；仅简单装饰器改造，即可托管 LangGraph、ADK 等主流 Python Agent 框架；不绑定特定大模型，兼容各类模型服务。

完备的访问控制：提供完整身份管理系统，支持为智能体运行时按需配置灵活的入站与出站访问规则。

全链路可观测：支持运行时、会话、Trace三个维度采集监控指标、日志、调用链路，可观测 Agent 性能、工具调用、模型输出、错误异常，快速定位故障点。。

与 AgentKit 网关生态打通：运行时内部 Agent 代码通过 MCP Client 对接 AgentKit Gateway，直接消费网关纳管的全部 MCP 工具能力，形成完整 Agent 解决方案。

与自建 K8s / 虚拟机部署 Agent 对比

维度	Agent Runtime	自建 K8s / 虚拟机部署 Agent
底层运维	平台全托管，无需维护集群、机器、重启策略	自行维护集群、监控、故障自愈
弹性能力	开箱即用自动扩缩容，空闲实例自动释放	需要自行配置 HPA、扩缩容规则
安全权限	内置 IAM 角色、出入站网络访问策略	自行实现 RBAC、网络策略、密钥管理
可观测	运行时 / 会话 / Trace 三级观测开箱即用	需要自行埋点、搭建日志、链路追踪系统
Agent 框架适配	少量代码改造即可托管主流 Agent 框架	无封装，全部适配逻辑自行开发
生态集成	原生对接 AgentKit Gateway MCP 工具生态	需要自行对接 MCP Client、鉴权逻辑

与各组件的关系

序号	组件	与 Runtime 的关系
①	AgentKit Gateway	Runtime 调用外部 MCP 工具的唯一出口：Runtime 内的 MCP Client 连 Gateway，由网关完成入站鉴权、协议转换、路由、出站凭据注入；仅承载 MCP 工具，不承载沙箱模板。
②	A2A 空间	Runtime 需注册到 A2A 空间后才具备跨 Agent 互调能力；由 A2A 底层网关承载协议，负责 Agent 寻址、鉴权、请求路由；一个 Runtime 只能注册一个 A2A 空间。
③	知识库	Runtime 在表单绑定后自动注入连接配置，Agent 通过知识库 SDK 直连做 RAG 检索；知识数据独立管理，网络模式必须与 Runtime 一致。
④	记忆库	Runtime 表单绑定后注入连接配置，Agent 通过 SDK 跨会话读写长期记忆；数据独立存储、不驻留 Runtime 实例；网络模式必须与 Runtime 一致。
⑤	安全围栏	绑定到 Runtime 后，通过 Agent 侧集成的围栏 SDK 对输入、工具调用、输出做提示词注入 / 内容 / 敏感识别 / 算力防护；Agent 必须集成 SDK 才生效。
⑥	可观测服务	Runtime 埋点模块自动上报日志 / 指标 / Trace 到 APMPlus 与 TLS，无需业务代码埋点；关闭后业务仍可执行，仅失去排查与在线评测能力。
⑦	火山方舟（模型服务）	Runtime 表单可选模型 → 平台注入 endpoint 与鉴权；Agent SDK 直接调用模型 API；Runtime 与模型解耦，亦可对接外部非方舟模型。
⑧	IAM 角色	绑定到 Runtime 后，IAM 颁发临时凭证由 Runtime 权限模块承接并注入沙箱，火山 SDK 与沙箱内进程自动使用；不绑 → 无法访问火山云资源。
⑨	外部业务后端	Runtime 不直接调用；必须经 Gateway 代理（承接凭据托管与审计）；禁止 Runtime 沙箱直连业务后端。
⑩	沙箱模板 Sandbox	属工具（Tool）子类，是 microVM 隔离运行环境；Agent 通过 Sandbox SDK + sessionId 创建实例，首次调用创建、会话期间复用（默认 30 分钟，最长 24h）；入站认证由 Identity 完成（API Key），与 Gateway 的 MCP 链路并列，不共用调用链。

调用链路

运行时构建方式

AgentKit支持多种方式将 Agent 托管至运行时，您可以参照以下场景进行选型：

使用控制台

使用 AgentKit CLI 工具

使用 VeADK

存量 Agent 迁移

使用 TRAE 集成

定位：零或低代码方式完成创建、配置、部署与在线验证，适合快速试用和方案演示。

适用场景

首次体验 AgentKit Runtime，希望用最短路径完成部署

偏控制台操作，不希望先搭建本地开发环境

需要快速验证模型、工具或知识库组合后的运行效果

适合 PoC、演示、培训或产品方案验证

不太适合：需要复杂工程结构、自定义构建过程、严格的版本治理与自动化发布流程的长期项目（建议转向 AgentKit CLI）

文档链接：快速入门：1分钟快速部署智能体

使用流程

Agent 制作并部署到运行时：根据所选构建方式，在对应入口完成 Agent 能力定义（提示词、工具、知识库及业务代码），生成可部署产物后发布到 AgentKit Runtime，并配置运行参数（环境变量、资源规格、路由域名/鉴权等）。首次部署建议使用测试或灰度环境，便于验证和回滚。

调用 / 测试 Agent：通过控制台在线测试功能或在本地使用curl命令指定域名发起 POST 请求调用 Agent。

观测排查：通过运行时全局指标、会话记录、Trace 调用链路和实例日志，定位性能瓶颈、工具调用异常、业务代码报错及资源问题。

评测：Runtime 负责执行 Agent 产生会话输出；基于运行时会话样本输出，对接 AgentKit 评测能力，批量输入测试集，评测 Agent 回答准确率、工具调用正确率，迭代优化 Agent 镜像代码。

常见理解误区

常见误解	正确理解	说明
Runtime 包含 Agent 业务逻辑。	Runtime 是托管运行环境，业务逻辑由部署到 Runtime 中的 Agent 代码实现。	Runtime 负责运行和托管，不负责替开发者生成业务逻辑。
Runtime 持久化存储会话、记忆和知识库数据。	会话、记忆和知识库数据由对应独立组件管理。	Runtime 可关联这些组件，但不替代组件的数据管理能力。
只有 VeADK Agent 可以部署到 Runtime。	Runtime 与 VeADK 深度集成，也支持托管其他主流 Python Agent 框架开发的 Agent。	具体框架支持范围以产品文档和控制台能力为准。
最小实例数在无流量时不计费。	最小实例数代表常驻保活资源，无请求流量时也会计费。	如果业务对冷启动不敏感，可结合成本目标调整最小实例数。
绑定安全围栏服务后会自动防护所有链路。	启用后还需要在 Agent 中集成安全围栏服务，否则防护策略不生效。	防护范围取决于业务代码的集成位置和产品能力配置。
Runtime 具备大模型推理能力。	Runtime 不承载模型推理算力，推理能力由火山方舟或其他模型服务提供。	Agent 代码需要通过模型 SDK、API 或环境变量配置调用模型。
注册 A2A 空间后会自动完成多 Agent 编排。	A2A 空间提供 Agent 寻址和通信基础，编排逻辑仍需业务代码或主 Agent 实现。	任务拆解、调用策略和结果汇总不由 A2A 空间自动生成。
沙箱工具是 Runtime 的内置附属能力。	沙箱工具是可被 Agent 调用的工具能力，Runtime 可按需关联。	Agent 代码仍需按文档集成沙箱工具，关联本身不代表自动调用。
IAM 角色可以替代第三方 API 鉴权。	IAM 角色用于访问火山引擎云资源，不适用于第三方服务鉴权。	访问第三方服务仍需使用对应服务要求的 API Key、OAuth Client 或其他凭据。
修改 IAM 角色权限后会立即在 Runtime 生效。	Runtime 配置类变更通常需要发布后才会生效。	修改权限后应回到 Runtime 详情页执行发布。