用途
Company brain: agent for follow-up 是 cognee 仓库中的一个示例型智能体,用于自动跟进最近一次通话。它运行 examples/cookbooks/company_brain/follow_up_agent/ 下的 follow-up agent cookbook,将 Granola 通话、Linear issue 与 Gmail 收件箱的内容整合进 cognee 数据集 follow_up_agent,然后推导最新通话的下一步行动,并发布到 Slack 或直接打印出来。
主要能力
- 从最近一次通话中提取下一步行动,包括负责人、团队、截止日期,以及已经跟踪这些事项的 Linear issue。
- 整合多个来源:Granola 通话、Linear issue、Gmail 收件箱。
- 发布结果到 Slack,或在终端打印步骤。
- 支持按时间范围筛选(--days N)。
- 支持排除某个来源(--no-linear、--no-email)。
- 提供数据检查与错误定位机制,脚本失败时会以退出码 1 并给出说明行。
使用方式
所有命令需从仓库根目录运行。
-
环境检查: uv run python examples/cookbooks/company_brain/follow_up_agent/follow_up_agent.py --check 退出码 0 表示可进入下一步;退出码 2 时,每条 [setup] MISSING: 行对应一个需要修复的项,需按 README 的 “What it needs” 表提示用户具体修复哪一行并停止,不要自行创建凭据。
-
运行智能体: uv run python examples/cookbooks/company_brain/follow_up_agent/follow_up_agent.py 用户指明时间范围时加 --days N;不希望使用某来源时加 --no-linear 或 --no-email。
结果位于 [follow_up] Posted to Slack: 或 [follow_up] Steps 行之后,需一并告知用户这些步骤来自哪次通话([follow_up] Call: 行)、使用了哪些来源([ingest_*] 行)以及是否已发布。
若脚本失败,follow_up_agent.py 会以退出码 1 退出并给出说明行;可在 examples/cookbooks/company_brain/follow_up_agent/scripts/ 下单独运行该脚本进一步排查。
适用场景
适用于希望把会议通话自动转化为可执行待办并同步到协作工具的工作流,例如把 Granola 通话结论落到 Linear issue,并通知到 Slack 频道。
限制与注意事项
- 未配置 Granola、Linear 和 Gmail 时,命令基于示例通话、issue 和邮件运行,跟随的是虚构通话,不会发布到 Slack,此时只需 LLM_API_KEY,需告知用户步骤来自示例数据。
- 可通过 --sample 在账户已配置的情况下仍使用示例数据。
- Gmail 访问为只读。
- 配置 Slack 后,每次运行都会发布到用户真实频道;每次运行都会读取用户真实通话、issue 和邮箱并消耗 LLM 额度,因此仅在用户明确要求时运行。
- 不要打印 credentials.json、token.json 或 .env 的内容。
- 示例运行会在摄取前遗忘 cookbook 的数据集 follow_up_agent([clear] 行);在用户自有数据上,仅当用户要求重新开始时才传 --clear,因为它会遗忘数据集中的全部内容。
- 除非用户要求浏览图结构,否则不要传 --ui,该模式会持续运行直到 Ctrl+C。
清理
uv run cognee-cli forget --dataset follow_up_agent