文档中心

AgentKit

请输入

故障处理

智能体运行时故障处理

本文介绍 AgentKit 智能体运行时（Runtime）在部署、发布和鉴权过程中出现异常时的排查方法。

发布卡住或资源锁定

问题现象

发布过程卡住，并提示“指定的操作被拒绝，因为您的资源已被其他操作锁定”。

可能原因

可能函数实例资源不足，导致相关资源被其他操作占用并处于锁定状态，当前发布操作无法继续执行。

解决方法

检查当前账号下是否有智能体运行时实例仍处于启动中。

等待相关实例状态稳定后，重新执行发布。

如果存在长时间处于启动中状态的异常实例，请确认终止实例不会影响业务后，终止异常实例并重新发布。

注意

终止实例可能中断正在处理的请求。无法确认影响范围时，请勿直接终止生产实例。

运行时启动失败或状态显示“不可用”

问题现象

Runtime 启动失败、创建后显示不可用。删除并重新创建智能体后，问题仍然存在。

解决方法

注意

请勿优先删除并重新创建 Runtime。删除操作可能影响访问地址、配置和关联资源。确需删除时，请先备份必要配置并确认影响范围。

在智能体运行时列表中找到状态不可用的智能体，将鼠标悬停在状态上，单击“查看日志”按钮，在日志中定位运行时配置、启动命令或依赖项等问题。

如果日志出现 IndexError: list index out of range，请查看错误日志中的 Traceback（错误堆栈信息），定位报错文件和代码行。定位报错文件、代码行和函数调用位置，并检查该位置访问的列表是否为空或下标超出范围。

修正配置或代码后，重新创建 Runtime。

如果多次重试仍失败，请记录智能体 ID、创建时间和日志信息，联系火山引擎技术支持人员处理。

VeADK LongTermMemory 初始化失败

问题现象

AgentKit 运行时初始化 VeADK 长期记忆组件时校验报错，程序启动阶段即失败。

可能原因

当前 LongTermMemory 使用 Mem0 作为记忆后端，但初始化时未获取到 Mem0 所需的 API Key。

解决方法

在左侧导航栏，选择“记忆库”。

单击目标记忆库名称，进入详情页面。

单击“集成示例”页签，获取该记忆库的 DATABASE_MEM0_API_KEY 值。

将 DATABASE_MEM0_API_KEY 值传入运行时的环境变量并重新初始化运行时。

DATABASE_MEM0_API_KEY=xxx #记忆库入站身份认证的 API Key。

若问题仍未解决，请记录报错信息，联系火山引擎技术支持人员处理。

Runtime 鉴权失败

问题现象

在线测试提示“当前 Runtime 鉴权失败，暂时无法发送消息”或“权限不足”。

可能原因

当前操作账号缺少 AgentKitFullAccess 访问权限。

解决方法

确认发生错误的账号是否为 IAM 用户。

登录访问控制，检查该 IAM 用户是否已配置 AgentKitFullAccess 策略权限。

说明

AgentKitFullAccess 策略权限可用于排查该问题，但不能据此确认它是最小必需权限。生产环境授权前，请按照组织的最小权限原则完成审批。

如果缺少该策略权限，请联系具备权限的管理员完成授权。

授权完成后直接重新测试，无需重新发布 Runtime。

若问题仍未解决，请记录智能体 ID，联系火山引擎技术支持人员处理。

最近更新时间：2026.10.14 14:26:02

这个页面对您有帮助吗？

有用

无用