@tom_doerr: 专业的AI智能代理管理电子邮件、日历和研究 https://github.com/kaymen99/personal-ai-assistant…

专业AI代理管理邮件、日历和研究工作 https://github.com/kaymen99/personal-ai-assistant… — # kaymen99/personal-ai-assistant 来源：https://github.com/kaymen99/personal-ai-assistant # AI 个人助理 想象一下，你的口袋里有一个个人助理 📱，能处理你的电子邮件 📧、日程 📅、待办事项列表 ✅，及时更新Slack消息 💬，并为你进行在线研究 🔍——全部通过你最喜欢的消息应用完成。 这正是一个AI个人助理能做到的事情！🤖✨ 该项目提供了一个个人助理代理，能够管理你的收件箱、日历、Notion待办事项列表、Slack交互，以及处理你的任何研究需求。该助理通过你选择的通信渠道（Telegram、Slack 或 WhatsApp）与你沟通，随时通知你关于日程、任务、电子邮件、消息的消息，并帮助进行关于主题、人员甚至公司的研究。 这个个人助理是一个分层多代理系统，包含一个监督代理（管理者）和几个专门处理特定任务和工具的次级代理，以实现高效的任务管理。 ## 概述 ### 主要代理：助理管理器 助理管理器是你的个人助理，负责协调任务以及你和次级代理之间的沟通。管理器负责： - 从你选择的通信渠道接收和分析你的消息。 - 将任务委派给相应的次级代理（邮件、日历、Notion、Slack或研究员）。 - 通过你偏好的渠道将更新、消息和任何查询反馈给你。 ### 次级代理 管理器代理可以与五个专门的次级代理通信： 1. 邮件代理： 可以处理所有与邮件相关的任务，包括发送邮件、检索特定邮件、检查联系人列表中的重要消息。 2. 日历代理： 可以管理你的日历，创建新事件，检索和查看已安排的事件。 3. Notion代理： 可以管理你在Notion中的待办事项列表，帮助根据需要添加、删除或勾选任务。 4. Slack代理： 可以管理你的Slack交互，读取频道或私信中的消息，并代表你发送消息。 5. 研究员代理： 可以进行网络研究、抓取网站、从LinkedIn个人资料收集信息，以协助研究任务。 所有次级代理完成任务后都会向助理管理器报告。 ## 技术栈 - LangGraph & LangChain：用于构建AI代理以及与LLM（GPT-4、Llama 3、Gemini）交互的框架。 - LangSmith：用于监控不同的LLM调用和AI代理之间的交互。 - Google APIs：提供对Google服务（如日历、联系人和Gmail）的访问。 - Notion Client：用于与Notion交互，管理和更新待办事项列表。 - Slack SDK：用于与Slack交互，发送和接收消息。 - Tavily Search API：用于执行网络搜索。 - Telegram API：根据你选择的通信渠道而定。 - WhatsApp API via Twilio Sandbox（用于测试）：一种集成WhatsApp通信的方式。 ## 运行方法 ### 前提条件 - Python 3.9+ - 你偏好的LLM提供商的API密钥（OpenAI、Claude、Gemini、Groq等） - Google API凭据（用于访问日历、联系人和Gmail） - Notion API密钥 - Tavily API密钥（用于网络研究） - Slack Bot User OAuth Token和App Token - Telegram Bot Token（如果要使用Telegram） - Twilio Account SID和Auth Token（如果要测试WhatsApp） - 所需的Python库（列在requirements.txt中） ### 设置 1. 克隆仓库： sh git clone https://github.com/kaymen99/AI-personal-assistant cd AI-personal-assistant 2. 创建并激活虚拟环境： sh python -m venv venv source venv/bin/activate # 在Windows上使用 `venv\Scripts\activate` 3. 安装所需包： sh pip install -r requirements.txt 4. 设置环境变量： 在项目根目录中创建一个.env文件，并添加你的API密钥。参见.env.example了解所有需要的参数。 5. 配置Google API凭据： 按照Google的文档设置日历、联系人和Gmail API的凭据。将凭据文件保存到项目文件夹中。 6. 设置通信渠道： - Telegram： - 创建Telegram机器人：要通过Telegram与助理交互，你需要创建一个Telegram机器人并获取机器人令牌。按照这个指南（https://www.youtube.com/watch?v=ozQfKhdNjJU）创建你的机器人并获取必要信息。 - Slack： - 创建Slack应用：按照官方Slack文档创建一个新的Slack应用，添加必要的OAuth作用域（参考提供的代码和文档以了解所需作用域）。 - 将应用安装到你的工作区，并获取你的Bot User OAuth Token和App-Level Token。 - WhatsApp（使用Twilio Sandbox测试）： - 重要提示： 通常情况下，与WhatsApp Business API交互需要一个Meta Business账户。然而，仅用于测试目的，本项目使用Twilio WhatsApp Sandbox。 - Twilio Sandbox限制： 如Twilio文档（https://www.twilio.com/docs/whatsapp/sandbox）所述，“仅将Twilio Sandbox用于WhatsApp测试和探索，不应在生产环境中使用。” - 设置： 1. 创建一个Twilio账户，获取你的Account SID和Auth Token。 2. 按照Twilio的教程设置WhatsApp Sandbox：Twilio WhatsApp Sandbox设置（https://www.twilio.com/docs/whatsapp/sandbox）。 3. 将你的Twilio Account SID、Auth Token和Sandbox号码保存到.env文件中。 7. 运行项目： - 要在Slack或Telegram上运行个人助理，只需运行： bash python app.py - 要在WhatsApp上运行个人助理，需要运行： bash python run app_whatsapp.py 这将启动一个本地FastAPI服务器。要启用与Twilio服务器的通信，需要使用Ngrok将其公之于众： 1. 使用ngrok暴露Webhook URL bash ngrok http 5000 2. 配置Twilio Webhook 1. 前往Twilio控制台 > Messaging > Sandbox for WhatsApp。 2. 在Sandbox设置部分：将“WHEN A MESSAGE COMES IN”的URL设置为你的ngrok URL并保存配置。 现在你可以通过WhatsApp与你的助理对话了 ### 使用 与助理通信：只需向配置好的通信渠道（Telegram、Slack频道或WhatsApp）发送消息，助理将分析消息，将任务委派给相应的次级代理，并将结果反馈给你。 ## 贡献 欢迎fork仓库、创建分支并提交pull request以贡献项目。 ## 联系方式 如有任何疑问或建议，请通过[email protected]联系。