SuperAPI AI 工具集

debug

部署与运维

查看项目

更新于 11-04 16:18

技能介绍

Debug 是一个面向 Fireworks 训练与部署场景的故障诊断技能,来源于 fw-ai-external/cookbook。它的核心用途是帮助用户排查训练运行中出现的卡住、失败、错误信息、质量不佳、检查点与恢复问题以及 LoRA 适配器等相关故障。

主要能力方面,Debug 以只读方式运行,默认不创建任务、不上传数据、不产生费用,除非用户明确要求新的或重试运行并交接给 configure 流程。它从证据出发进行诊断,用通俗语言解释原因,并提出一个具体的修复建议。默认情况下会提出一个对决策关键的问题,并在消息已指明任务或症状时立即开始只读检查。它遵循三振规则:对同一问题三次假设失败后停止猜测,构建包含 UTC 时间戳、资源 ID、模型与形状、CLI 与 SDK 版本、cookbook 提交、重试历史、证据以及已排除项的升级包,并隐去凭据和客户数据。

使用方式上,Debug 通过入口路由处理不同信号:新的训练或已批准的重试路由到 configure;方法、数据或起始示例不明确路由到 research;失败、停滞、质量差、恢复或服务问题则留在 debug。它复用运行的 FIREWORKS_SESSION_ID,若不存在则创建 UUID,并设置 FIREWORKS_CLIENT_SOURCE 环境变量。在首次结构化提问前会展示遥测通知。它使用 AskQuestion 一次只问一个问题然后停止,跳过消息已回答的问题,使用通俗的客户语言。分类问题使用五个注册选项:任务状态、错误、质量、恢复/检查点或部署/服务。

适用场景包括诊断 Fireworks 训练运行中的卡住或失败、错误信息、质量不佳、检查点与恢复问题以及 LoRA 适配器问题。限制方面,Debug 默认只读,不重试或创建资源;成本真实性是硬边界,除非记录中包含实时定价和账户资格读取,否则不能称重试免费或引用训练、推理或部署费率,必须说明 Configure 需在批准前解决成本。training/... 路径位于 fw-ai/cookbook 仓库中,需通过 ../fireworks-training/references/cookbook-code.md 解析。其他具体功能、收费、价格、平台、效果或使用步骤暂未提供。