文档中心

AgentKit

智能体运行时

运行时实例概述

运行时实例（以下简称“实例”）是 AgentKit 智能体运行时的实际承载单元，用于在隔离的计算与网络环境中执行智能体任务，并提供日志、指标、事件等可观测能力。

什么是实例

实例是 AgentKit 为智能体应用分配的独立运行环境。可以把实例理解为应用的“运行单元”：应用的代码、配置、依赖和运行时版本会在实例中生效，外部请求进入后也会由实例负责处理。

在实例管理页面中，您可以查看运行中的实例数量，以及 CPU、内存和公网出流量等资源概览；实例被平台回收并释放运行环境后，将不再通过该实例继续处理请求。

工作原理

实例是智能体应用的运行单元。系统会根据应用配置拉起实例，实例在控制台可见时状态即为启动中，初始化完成后进入就绪并开始对外提供服务。

实例的拉起方式包括按需拉起与最小实例保底：有业务访问时会自动拉起实例承接请求；如果配置了最小实例个数（大于 0），即使没有流量也会维持至少该数量的实例常驻。请求进入实例后，会按应用逻辑执行推理与工具调用，并记录日志、资源用量与网络流量，便于排查与观测成本。

核心能力

能力	说明	典型场景
运行承载	为智能体应用提供独立运行环境，使应用能够持续处理请求。	部署应用后，对外提供智能体问答、任务处理或工具调用服务。
状态查看	展示实例名称、运行状态、运行时版本和创建时间，帮助用户快速判断实例是否可用。	确认应用是否已启动，或定位某个实例的创建时间与版本信息。
资源观测	展示运行中实例数、CPU 累计用量、内存累计用量和公网出流量。	评估应用运行规模、资源消耗趋势和网络流量使用情况。
日志排查	支持查看实例日志，帮助用户定位启动失败、请求异常或业务逻辑错误。	应用响应异常、工具调用失败或实例状态异常时进行问题排查。
Webshell 调试	支持通过 Webshell 进入实例运行环境，查看运行现场或执行必要的调试操作。	需要确认文件、依赖、环境变量或运行进程状态时进行在线排查。
实例回收	支持实例自动回收，并通过最小实例个数配置控制实例的保活与终止。	业务空闲后实例自动消亡；需要持续保活时配置最小实例个数，需要回收时将最小实例个数调整为 0。

实例生命周期

实例生命周期从应用部署开始。平台生成运行环境后，实例在控制台可见时状态即为启动中，并在初始化完成后进入就绪，开始承接请求。运行期间，实例会持续产生以下三类可观测数据，供监控与排障使用：

实例终止的两种情形

实例的终止方式取决于最小实例个数的配置：

最小实例个数：平台常驻的最少实例数量，用于在业务空闲期保留即时响应能力。

最小实例个数	空闲时的行为	主动回收方式	适用场景与权衡
0	业务处于空闲状态后，平台自动回收实例。	无需操作，等待自动回收即可。	资源成本更低，但下次请求需要冷启动、首个请求延迟更长；适合流量波动大、对首个请求延迟不敏感的场景。
大于 0	始终保留该数量的常驻实例，不随空闲自动回收。	需先将该值手动调整为 0；已有实例将逐步终止并回收。注意将最小实例个数调整为 0 可能会影响应用的持续可用性。执行该操作前，建议先确认当前是否仍有线上访问需求，并保留必要的日志与排障信息，避免回收后难以复现问题。	常驻实例保证即时响应，冷启动更少；相应地资源成本更高，适合流量稳定或对冷启动延迟敏感的线上业务。

实例状态说明

实例状态用于描述实例从启动、运行到停止过程中的当前阶段。用户可以通过状态判断实例是否已经可以处理请求，或是否需要查看日志进一步排查问题。

状态	含义	建议操作
启动中	实例在控制台可见，平台正在准备运行环境并初始化应用。	等待实例启动完成。若长时间停留在该状态，建议查看日志排查初始化过程。
就绪	实例初始化成功，已具备承接请求的能力。	可以正常访问应用，并通过资源概览持续观察 CPU、内存和公网出流量。
失败	实例初始化失败，通常表示应用启动、依赖加载或运行环境准备过程中出现异常。	查看实例日志，定位失败原因后重新部署或调整应用配置。
终止中	实例正在停止并释放运行环境。	等待终止完成。该阶段实例可能无法继续稳定处理请求，不建议继续承接线上流量。
未知	平台暂时无法获取实例状态，可能由状态同步异常或实例信息读取失败导致。	稍后刷新页面或查看日志；若持续未知，建议联系技术支持进一步排查。

使用建议