SuperAPI AI 工具集

firecrawl-incident-runbook

部署与运维

查看项目

更新于 10-15 23:26

技能介绍

用途:该技能面向 Firecrawl 集成事故的响应与缓解,目标是先稳定受影响的工作流、保留隐私安全证据,再通过经过验证的降级模式或回滚恢复服务,并区分 Firecrawl 服务健康、目标源站行为与内部流水线故障。

主要能力:按官方错误目录对失败分类,仅重试文档中标注为可重试的类别,遵守 Retry-After 并限制尝试次数;处理异步任务的 job/status/取消接口,用队列状态区分容量压力;在 Webhook 延迟或耗尽时改用状态轮询恢复。当前文档的事件列表中,crawl webhook 集合不包含 crawl.failed 事件。

使用方式:先声明事故负责人、严重级别、受影响操作与环境、开始时间、客户影响、数据风险、批准的沟通渠道和下次更新时间;在调查前暂停或限制生产者,避免重试、爬取范围或按量付费放大成本与目标负载;检查内部部署与依赖、Firecrawl 服务证据、凭证、额度、团队限制、队列/并发、任务状态、Webhook 投递和目标源站状态;选择可逆缓解措施,如降低并发、收窄限制、切换轮询、提供上次批准内容、关闭昂贵选项或回滚应用发布;用合成或批准的 canary 验证恢复,确认队列排空、错误率、输出质量、数据完整性和支出稳定。

认证:认证的 Cloud 操作需从批准的密钥管理器注入 FIRECRAWL_API_KEY,REST 请求使用 Authorization: Bearer 携带密钥;不得打印、提交、传输密钥或将其放入 URL。无密钥访问仅适用于当前文档明确允许且工作负载接受其限制的场景。

限制与边界:仅用 Read、Glob、Grep 检查代码、配置、测试和证据,Write/Edit 仅用于批准的实现或文档变更;不得仅因调用该技能就调用 Firecrawl、轮换密钥、更改账户设置、抓取目标或部署。密钥轮换、套餐或按量付费变更、流量故障转移、目标范围变更、禁用安全/保留控制或向供应商披露,均需事故指挥批准。服务状态不明时应暂停生产者并收集有限证据,而非大规模重试;缓解措施影响数据质量或新鲜度时需标注降级输出并获得产品负责人接受;疑似凭证或内容暴露时走安全事件路径并保留证据。输出应包含时间线、影响、分类、缓解措施、批准、canary 与恢复证据、剩余风险、下次更新和事后行动。