GitHub 热门项目：从头开始代理

? GitHub 项目：agents-from-scratch ?仓库地址：https://github.com/langchain-ai/agents-from-scratch ⭐ 星星：1765 | ? 作者：langchain-ai ? 项目描述：构建具有人机交互和记忆功能的电子邮件助手 =================================================== ? 自述文件内容： =================================================== # 从头开始的代理 该存储库是从头开始构建代理的指南。它构建了一个[“ambient”](https://blog.langchain.dev/introducing-ambient-agents/)代理，可以通过连接到Gmail API来管理您的电子邮件。它分为 4 个部分，每个部分都有一个笔记本和“src/email_assistant”目录中的随附代码。这些部分从代理的基础知识开始，到代理评估，到人机交互，最后到记忆。这些全部都集中在一个可以部署的代理中，并且这些原理可以应用于跨广泛任务的其他代理。  ## 环境设置 ### Python版本 * 确保您使用的是 Python 3.11 或更高版本。 * 需要此版本才能与 LangGraph 实现最佳兼容性。 ````外壳 python3——版本 ```` ### API 密钥 * 如果您没有 OpenAI API 密钥，您可以[此处](https://openai.com/index/openai-api/) 注册。 * [此处](https://smith.langchain.com/) 注册 LangSmith。 * 生成 LangSmith API 密钥。 ### 设置环境变量 * 在根目录下创建`.env`文件： ````外壳 # 将 .env.example 文件复制到 .env cp .env.example .env ```` * 使用以下内容编辑 `.env` 文件： ````外壳 LANGSMITH_API_KEY=your_langsmith_api_key LANGSMITH_TRACING=true LANGSMITH_PROJECT="中断研讨会" OPENAI_API_KEY=your_openai_api_key ```` * 您还可以在终端中设置环境变量： ````外壳 导出 LANGSMITH_API_KEY=your_langsmith_api_key 导出 LANGSMITH_TRACING=true 导出 OPENAI_API_KEY=your_openai_api_key ```` ### 包安装 **推荐：使用 uv（更快、更可靠）** ````外壳 # 如果你还没有安装 uv，请安装 点安装紫外线 # 安装带有开发依赖的包 uv 同步——额外开发 # 激活虚拟环境 源 .venv/bin/activate ```` **替代方案：使用点** ````外壳 $ python3 -m venv .venv $ 源 .venv/bin/activate # 确保您拥有最新版本的 pip（使用 pyproject.toml 进行可编辑安装所需） $ python3 -m pip install --upgrade pip # 以可编辑模式安装包 $ pip install -e 。 ```` > **⚠️ 重要**：不要跳过软件包安装步骤！为了使笔记本电脑正常工作，**需要**此可编辑的安装。该软件包安装为“interrupt_workshop”，导入名称为“email_assistant”，允许您使用“from email_assistant import ...”从任何地方导入 ## 结构 该存储库分为 4 个部分，每个部分都有一个笔记本，并在“src/email_assistant”目录中附带代码。 ### 前言：LangGraph 101 有关 LangGraph 的简要介绍以及本存储库中使用的一些概念，请参阅 [LangGraph 101 笔记本](notebooks/langgraph_101.ipynb)。本笔记本解释了聊天模型、工具调用、代理与工作流程、LangGraph 节点/边/内存和 LangGraph Studio 的基础知识。 ### 建立代理 * 笔记本：[notebooks/agent.ipynb](/notebooks/agent.ipynb) * 代码：[s