SuperAPI AI 工具集

firecrawl-observability

部署与运维

查看项目

更新于 10-15 23:26

技能介绍

用途:把 Firecrawl 当作一条流水线来度量,覆盖提交、Firecrawl 处理、源站结果、分页、校验、存储与新鲜度,避免仅凭传输成功就认定内容可用。

主要能力:定义并跟踪已接受结果成功率、端到端延迟、新鲜度、队列等待时长、分页完整性、源站状态分布、输出质量、Webhook 恢复与花费等 SLI/SLO;为各阶段打低基数标签(操作、环境、来源类别、终态、重试类别、策略版本);用 Credit Usage 端点与仪表盘活动看花费,用 Queue Status 看容量,用 job/status API 看异步进度,用 webhookId 标识投递,用 metadata.statusCode 看源站响应,用 creditsUsed 记录用量;对 SLO 燃烧、队列压力、402/403/429 变化、源站错误、Webhook 重试耗尽、schema 拒绝和新鲜度滞后告警。

使用方式:认证的 Cloud 操作从批准的密钥管理器注入 FIRECRAWL_API_KEY,REST 请求使用 Authorization: Bearer;不得打印、提交、传输密钥或把密钥放进 URL。无密钥访问仅在当前文档明确允许且工作负载接受其限制时使用。用 Read、Glob、Grep 检查代码与证据,Write/Edit 仅用于已批准的改动;不要仅因调用本技能就去调用 Firecrawl、轮换密钥、改账户设置、抓取目标或部署。

限制与边界:指标标签不得包含原始 URL、页面内容、提示词、密钥或无界 ID;不透明请求/任务/Webhook ID 只写入受控访问的 trace,URL 需哈希或分类,排除自定义头、正文、抽取值、截图与密钥。增加高基数标签、保留目标标识、导出遥测到新提供商或启用合成网络调用前需审批。异步计费有延迟,告警前应设结算窗口。指标与任务总数不一致时,先停止报告完整性直至分页与终态对账。

输出:SLI/SLO 定义、事件与指标 schema、脱敏与基数规则、仪表盘与告警设计、对账检查、测试结果与 runbook 归属。