用途:该技能用于分析智能体任务执行记录,识别在任务执行开始前就失败的“零迭代失败”,并据此正确归类、路由排查方向。此类失败需要系统级调查,而非智能体层面的调试。
适用判定条件:当智能体任务执行出现以下情况时使用:迭代次数为 0;未调用任何工具;未创建任何文件、文档或输出;对话日志极少或没有,仅存在用户指令而无智能体响应。
识别清单:迭代次数报告为 0;工具调用为无;创建文件为无;对话轮次为 1(仅用户指令);智能体自述表明在执行开始前即失败。
失败分类:零迭代失败通常对应以下执行前问题之一:初始化崩溃(智能体在设置阶段失败,调查系统日志与环境配置)、环境问题(缺少依赖或资源,调查基础设施与权限)、提示解析错误(输入无法处理,调查提示格式与编码)、资源耗尽(配额或限制超限,调查系统容量与速率限制)。
诊断步骤:第一步,用代码校验零迭代指标,检查迭代数、工具调用数、产物数与消息数是否同时满足零迭代特征;第二步,在系统日志中查找环境错误(缺少包、权限拒绝、路径不存在)、初始化错误(连接失败、设置超时)、资源错误(内存超限、配额限制、速率限制)、解析错误(无效 JSON、编码问题、输入格式错误);第三步,若确认是零迭代失败,则不要调试智能体逻辑或提示指令,而应调查系统初始化日志、环境配置、资源分配与限制、输入解析与校验。
响应动作:对分析师而言,应标记为系统级问题,不归因于智能体行为;检查基础设施健康状况;回顾近期变更如部署、配置更新或配额调整;并将问题升级给基础设施或平台团队,而非智能体开发者。对自动化系统,则提供了 categorize_failure 代码示例:若为零迭代失败,返回类别 PRE_EXECUTION_FAILURE、严重度 HIGH、调查团队 INFRASTRUCTURE、无需智能体调试,并建议检查系统初始化日志、核实环境配置、审查资源配额与限制、校验输入解析管道;否则返回 EXECUTION_FAILURE、严重度 MEDIUM、调查团队 AGENT_DEVELOPMENT、需要智能体调试。
示例分析:任务 69a8ef86-phase1 的迭代为 0、无工具调用、无文件创建、仅用户指令、智能体报告“在执行任何迭代前失败”,判定为 PRE_EXECUTION_FAILURE,应调查系统环境而非智能体提示;对比任务 abc123 有 3 次迭代、调用 read_file/write_file/shell_agent、创建 output.txt、有多轮响应,判定为 EXECUTION_FAILURE,应调试智能体推理与工具使用。
要点:零迭代等于执行前失败,说明智能体从未开始工作;这是系统级而非智能体级问题,应调试基础设施而非提示;严重度高,可能表明影响多个任务的系统性问题;应作为独立失败模式与正常执行失败分开处理。
限制:资料未提供该技能的具体安装方式、运行命令、兼容平台或收费信息,暂未提供。