用途:该技能用于分析智能体任务执行记录,识别在任务真正开始前就失败的“零迭代失败”,并将其与普通执行失败区分开,指导后续排查方向。
适用条件:当执行记录满足迭代次数为0、未调用任何工具、未创建任何文件或产物、对话日志极少(只有用户指令)等特征时,判定为零迭代失败。文档给出的识别清单包括:迭代数为0、无工具调用、无文件创建、对话轮次为1、智能体自述在执行前失败。
失败类别:文档列出可能的执行前问题,包括初始化崩溃(排查系统日志与环境配置)、环境问题(缺失依赖或资源,排查基础设施与权限)、提示解析错误(输入无法处理,排查提示格式与编码)、资源耗尽(超出配额或限制,排查系统容量与速率限制)。
诊断步骤:先用示例函数 is_zero_iteration_failure 校验迭代数、工具调用、产物和消息数量;再在系统日志中查找环境错误、初始化错误、资源错误和解析错误;若确认是零迭代失败,则不要调试智能体逻辑或提示词,而应检查系统初始化日志、环境配置、资源分配与限制、输入解析与校验。
响应动作:分析人员应将其标记为系统级问题,检查基础设施健康度,回顾近期部署、配置变更或配额调整,并转交基础设施或平台团队而非智能体开发者。自动化系统可参考 categorize_failure 函数,将零迭代失败归类为 PRE_EXECUTION_FAILURE,严重度为 HIGH,排查团队为 INFRASTRUCTURE,无需调试智能体。
限制:资料未提供该技能的安装方式、具体集成平台、收费或价格信息;其中的代码为诊断示例,需结合自身执行日志结构适配,不能直接假定可运行。