用途:以最小、低敏感度的元数据查询验证 Fireflies GraphQL 传输是否可用,确认身份、响应结构与数据最小化控制,而不是用真实会议转录做快速验证。
主要能力:公开 API 为基于 POST 的 GraphQL;最小化的 user 或 users 选择即文档中的快速入门。客户端即使收到 HTTP 200,也必须检查顶层 errors 数组,并只请求冒烟测试所需字段。
认证:已认证操作需从获批的密钥管理器注入 FIREFLIES_API_KEY,仅以 Authorization: Bearer REDACTED_KEY 发送到 https://api.fireflies.ai/graphql。不得打印、提交、放入 URL、转发到浏览器或写入证据;Webhook 签名密钥是独立凭据,不可复用为 API 密钥。
使用方式:确认密钥所有者与测试环境已获授权;选择 user 查询并只取不透明标识符或其他获批元数据;由服务端客户端发送一次带 JSON query 与 variables 的 POST 请求;断言 HTTP 成功、无 GraphQL 错误、存在 data 且响应结构符合预期;仅记录耗时、操作名、关联 ID 与通过/失败状态;在不暴露 bearer 密钥的前提下演练一次合成失败;若数据访问与请求预算可接受,才保留该冒烟测试。
工具纪律与审批边界:用 Read、Glob、Grep 检查代码、配置、测试与证据,Write/Edit 仅用于获批的实现或文档变更。不得仅因调用本技能就去查询 Fireflies、获取会议内容、创建 AskFred 线程、上传媒体、更改账户状态、重放事件或部署。选择邮箱、集成、转录、句子、摘要、音频 URL 或其他会议派生字段前需获得批准。
输出与验证:返回确切的操作或事件面、环境、授权类别、所选字段组、验证结果、无内容指标、决策与简明通过/失败回执,密钥与会议派生内容不得进入通用输出。报告成功前重跑最小确定性检查,比对实际状态与请求结果及当前契约,确认日志与产物中无密钥或会议派生内容,并明确记录未解决的不确定性。
错误处理:空数据需区分合法空结果与授权或查询错误;GraphQL 校验错误需对照当前文档或 schema 证据核对所选字段;遇到速率限制应停止重试,遵守当前套餐与 retryAfter 值。
限制:资料未提供具体套餐、价格、字段清单或平台支持范围,使用前应查阅官方 Fireflies.ai 证据。