transcript-search

会议记录搜索

概述

通过全文搜索和发言者归属信息，搜索并检索 Fireflies.ai 和 Google Drive 中的会议记录。

快速决策树

Where are your transcripts?
│
├── Fireflies.ai (API)
│   └── references/fireflies.md
│   └── Script: scripts/fireflies_transcript_search.py
│
└── Google Drive (uploaded files)
    └── references/drive-transcripts.md
    └── Script: scripts/gdrive_transcript_search.py

环境设置

# For Fireflies
FIREFLIES_API_KEY=your_api_key

# For Google Drive
# OAuth credentials (mycreds.txt) - see google-workspace skill

获取 Fireflies API 密钥：https://app.fireflies.ai/integrations（Custom Integrations）

常见用法

按公司搜索 Fireflies

python scripts/fireflies_transcript_search.py "Microsoft" --days-back 30

获取完整会议记录

python scripts/fireflies_transcript_search.py --id 01KCM2G0YX1GMPWYQ8GPAABBCK --content

保存格式化后的会议记录

python scripts/fireflies_transcript_search.py --id abc123 --content --save transcript.md

搜索 Drive 中的会议记录

python scripts/gdrive_transcript_search.py "Acme Corp" --days 30

输出格式

搜索结果

• 会议记录 ID、标题、日期、时长
• AI 生成的摘要、关键词、行动项
• 包含姓名的发言者列表

完整会议记录

• 带发言者标签的完整文本
• 每句话的时间戳
• 格式化的 Markdown 输出

费用

服务	费用
Fireflies API	免费（需订阅）
Google Drive	免费

安全说明

凭据处理

• 将 FIREFLIES_API_KEY 存储在 .env 文件中（切勿提交到 git）
• Google Drive 的 Google OAuth 凭据（参见 google-workspace skill）
• 如果 Fireflies API 密钥泄露，请通过 Custom Integrations 重新生成
• 切勿在脚本输出中记录或打印 API 密钥

数据隐私

• 会议记录包含会议对话的逐字内容
• 发言者的姓名和声音可以识别其身份
• 商务讨论可能包含机密信息
• 行动项和摘要可能包含敏感决策
• 未经授权，请勿分享完整会议记录

访问范围

• Fireflies API：可完整访问用户有权访问的会议记录
• Google Drive：可访问已上传的会议记录文件
• 会议记录继承会议参与者的访问权限

合规注意事项

• 录音同意：确保所有会议参与者都同意录音
• 发言者隐私：会议记录会通过姓名标识发言者
• 机密会议：某些会议不应转录
• GDPR：包含欧盟参与者的会议录音需要获得同意
• 数据保留：遵循会议记录保留和删除政策
• 法律保全：会议记录可能需要接受法律取证
• 客户保密：客户会议内容属于敏感信息
• 仅供内部使用：在适当情况下将会议记录标记为机密

故障排除

常见问题

问题：找不到会议记录

症状： 已知会议仍提示“找不到会议记录” 原因： 会议记录 ID 无效、无权访问或尚未处理完成 解决方案：

• 在 Fireflies 控制面板中确认会议记录 ID
• 检查录音是否仍在处理中（等待后重试）
• 确保 API 密钥有权访问该会议记录
• 确认会议确实已录制并转录

问题：API 未授权

症状： 出现 401 错误或“API 密钥无效” 原因： API 密钥已过期、无效或未设置 解决方案：

• 在 https://app.fireflies.ai/integrations 重新生成 API 密钥
• 确认已在 .env 中正确设置 FIREFLIES_API_KEY
• 检查密钥前后是否有空格
• 确保 Fireflies 中已启用 Custom Integration

问题：搜索结果为空

症状： 虽然存在会议，搜索却没有返回会议记录 原因： 搜索查询范围太窄、日期范围有误或访问受限 解决方案：

• 扩大搜索范围（减少关键词）
• 使用 --days-back 参数扩大日期范围
• 检查会议记录是否已共享给你的账户
• 确认搜索使用了正确的字段（标题、参与者、内容）

问题：会议记录内容缺失

症状： 已返回元数据，但完整内容为空 原因： 会议记录仍在处理中，或内容访问受到限制 解决方案：

• 等待会议记录处理完成（在 Fireflies 控制面板中检查）
• 显式使用 --content 标志请求完整会议记录
• 确认订阅套餐包含 API 内容访问权限
• 检查会议记录是否存在处理错误

问题：缺少发言人归属信息

症状： 有转录文本，但无法识别发言人 原因： 音频质量较差，或发言人尚未录入 解决方案：

• 发言人识别取决于音频质量
• 在 Fireflies 中录入经常发言的人，以提高识别效果
• 这是 Fireflies 的处理问题，不是 API 问题
• 如果可能，请重新上传音质更好的录音

问题：Google Drive 转录文本搜索失败

症状： 找不到存储在 Drive 中的转录文本 原因： OAuth 问题、文件夹结构或文件格式问题 解决方案：

• 确认 Google OAuth 正常工作（参见 google-workspace skill）
• 检查转录文本是否位于可搜索的文件夹中
• 确保转录文本采用可读格式（txt、md、docx）
• 如果全文搜索失败，请按确切文件名搜索

资源

• references/fireflies.md - Fireflies.ai API 指南
• references/drive-transcripts.md - Drive 转录文本搜索

集成模式

转录文本转摘要

技能： transcript-search → content-generation 使用场景： 创建会议摘要和行动项文档 流程：

1. 从 Fireflies 获取完整转录文本
2. 提取关键讨论要点和决策
3. 通过 content-generation 生成格式化摘要文档

转录文本转语音 Agent

技能： transcript-search → voice-agents 使用场景： 构建了解上下文的语音 Agent 流程：

1. 搜索与客户过往的会议
2. 提取关系历史和之前的讨论
3. 在语音 Agent 提示词中加入上下文，以实现个性化通话

转录文本转 CRM

技能： transcript-search → attio-crm 使用场景： 将会议记录添加到 CRM 记录中 流程：

1. 搜索客户会议的转录文本
2. 提取摘要、行动项和关键引述
3. 在 Attio 公司记录中创建会议详情备注