核心用法
Fireflies 技能通过 Maton 托管网关提供对 Fireflies.ai GraphQL API 的完整访问能力。用户需先配置 MATON_API_KEY 环境变量，并在 ctrl.maton.ai 完成 OAuth 授权建立连接。支持的操作包括：查询用户信息与权限、检索会议转录文本与元数据、获取 AI 生成的会议摘要（含行动项、关键词、大纲）、管理频道与联系人、创建/查询 AskFred 智能问答线程，以及上传音频、删除转录、修改会议隐私设置等变更操作。所有请求均以 POST 方式发送至统一 GraphQL 端点，支持变量传参与分页过滤。
显著优点
- 托管式 OAuth：Maton 网关自动处理令牌生命周期，开发者无需维护刷新逻辑
- AI 原生能力：内置 AskFred 自然语言查询，可直接对历史会议内容进行语义检索
- 完整数据访问：除基础转录外，提供句子级时间戳、发言人分离、音视频原始链接等多维数据
- 企业功能覆盖：支持用户组管理、实时会议控制、Soundbite 剪辑等高级场景
潜在缺点与局限性
- 网关依赖：API 调用需经过 Maton 网关代理，增加单点故障与网络延迟风险
- 配额限制：免费计划每日限 50 次 API 调用，大规模应用需升级 Business 方案
- GraphQL 门槛：相比 REST，查询构造与错误调试对初学者有一定学习成本
- 隐私合规：会议内容需经第三方云端处理，敏感行业需评估数据跨境与存储合规性
适合人群
- 需自动化会议记录整理的产品经理与运营团队
- 希望构建会议知识库、实现对话数据语义搜索的开发者
- 远程协作工具集成商，需将 Fireflies 数据同步至内部 CRM 或项目管理系统的工程师
常规风险
- 密钥泄露：
MATON_API_KEY若硬编码或泄露，可能导致账户数据被非法访问 - 过度授权：OAuth 连接建立后长期有效，离职人员或废弃系统可能残留数据访问权限
- 数据残留：删除转录操作不可逆，但云端备份策略需向 Fireflies 官方确认