用途:该技能面向 Fireflies 集成故障排查,用于区分 HTTP 传输失败、GraphQL 顶层错误与领域状态问题,覆盖认证失败、对象未找到、参数无效、权限提升要求、AI 额度要求、限流、平台不支持及处理状态为空等情形。
主要能力:先采集操作名、HTTP 状态、安全的 GraphQL 错误码、retryAfter、请求 ID 与时序,再对故障分类,之后才考虑修改查询、权限或重试策略。对 object_not_found 在不做枚举的前提下验证授权与 ID;遇到权限或额度错误即停止并转交责任人;遇到限流则遵循 retryAfter 与对应操作上限。
使用方式:仅在有明确仓库或集成路径与运营目标时使用。认证操作需从许可的密钥管理器注入 FIREFLIES_API_KEY,并只以 Authorization: Bearer REDACTED_KEY 形式发送到 https://api.fireflies.ai/graphql;禁止打印、提交、放入 URL、转发给浏览器或写入证据,Webhook 签名密钥不可当作 API 密钥复用。用合成变量或仅元数据选择复现问题。工具上使用 Read、Glob、Grep 检查代码与配置,Write/Edit 仅用于获批的实现或文档改动。
限制:不应仅因调用本技能就去查询 Fireflies、获取会议内容、创建 AskFred 线程、上传媒体、更改账户状态、重放事件或部署。变更角色、套餐、密钥、隐私、会议访问或重放变更前须获批准。HTTP 200 但含 errors 时须判定操作失败;重复重试失败应转事件而非无限扩大退避。未知错误文本须保留代码与安全元数据后查询最新错误文档。涉及具体字段、过滤、事件、权限、套餐上限与处理状态时,应先查阅官方证据。资料未提供具体版本号、价格或平台兼容清单。