SuperAPI AI 工具集

google-workspace-memory

办公与效率

查看项目

更新于 11-04 18:23

技能介绍

用途 google-workspace-memory 用于把用户 Google Workspace 中的多类信息汇聚成一个可提问的记忆:它记住用户的主日历、最新收件箱邮件和一个 Drive 文件夹,将这些内容写入 cognee 数据集 google_workspace_memory,然后跨这些来源回答一个问题,默认用于准备客户会议。

主要能力

  • 按来源分别摄取数据,运行输出中会给出 [ingest_calendar]、[ingest_gmail]、[ingest_drive] 等行,说明哪些来源被纳入。
  • 支持通过 --ask 直接提出问题并返回答案([ask] Answer: 之后的内容)。
  • 可用 --no-calendar、--no-gmail、--no-drive 排除不想使用某个应用。
  • 可使用示例数据运行:没有 credentials.json 时自动运行示例工作区(关于一个虚构的陶瓷业务),此时只需 LLM_API_KEY,并明确告知用户答案基于示例数据;也可加 --sample 强制使用示例。示例数据存放在独立数据集 google_workspace_memory_sample,不会与用户数据混合。
  • 支持 --api 模式:当用户在 cognee 服务器上连接了 Google 账户时,由服务器同步并回答,--check 会报告尚未连接的应用。
  • 后续追问可用 scripts/ask.py 针对同一数据提问,不会再次摄取。

使用方式 所有命令需在仓库根目录执行。

  1. 检查环境:uv run python examples/cookbooks/google_workspace_memory/google_workspace_memory.py --check。退出码 0 继续;退出码 2 时按 [setup] MISSING: 行提示用户修复对应项,而不是自行创建凭据;若仅缺 GOOGLE_DRIVE_FOLDER_ID,可询问是否改用 --no-drive。
  2. 运行摄取与提问:uv run python examples/cookbooks/google_workspace_memory/google_workspace_memory.py,可附带 --ask "..."。首次运行会对每个应用打开一次浏览器请求授权,需用户逐项批准。
  3. 对同一数据的追问:uv run python examples/cookbooks/google_workspace_memory/scripts/ask.py --ask "...",若首次使用示例则加 --sample。 若运行在 --check 通过后中断,最后一行 [<step>] 或 traceback 会说明原因,修复后只重跑 scripts/ 中对应步骤的脚本。

适用场景

  • 需要跨日历、邮件与 Drive 统一检索和问答的个人或团队工作流。
  • 准备客户会议时汇总相关多源信息。
  • 在无真实凭据时通过示例数据体验和验证流程。

限制与注意事项

  • Google 访问为只读:不创建、不修改、不发送任何内容。
  • 不要打印 credentials.json、*_token.json 或 .env 的内容。
  • 示例运行会在摄取前清空示例数据集([clear] 行);对用户自身数据仅在明确要求重新开始时才传 --clear,它会遗忘该数据集中的全部内容。
  • 摄取会读取真实的日历、邮箱和 Drive 文件,每次运行都会消耗 LLM 额度;首次运行会对整个主日历做 cognify,可能耗时十分钟以上,应在用户要求时并在开始前告知用户。
  • 清理方式:uv run cognee-cli forget --dataset google_workspace_memory 与 uv run cognee-cli forget --dataset google_workspace_memory_sample。
  • 具体安装步骤、凭据配置细节与脚本说明见 cookbook 的 README.md,其余未提供的信息暂未提供。