ed-donner/agents

掌握 AI Agentic Engineering —— 构建自主 AI Agent

为期 6 周的进阶之旅：使用 OpenAI Agents SDK、CrewAI、LangGraph、AutoGen 和 MCP 编写并部署 AI Agent

如果你正在 Cursor 中查看此文档，请右键点击左侧资源管理器中的文件名，选择“Open preview”以查看格式化版本。

非常欢迎各位加入！这是你开启为期 6 周的旅程的起点，我们将一同探索强大、惊人且时常显得有些超现实的 Agentic AI 世界。

开始之前

我随时准备为你提供帮助，确保你能顺利完成课程！无论是在平台内还是直接给我发邮件（ed@edwarddonner.com），欢迎随时与我联系。与大家在 LinkedIn 上建立联系并共同构建社区是一件非常棒的事，你可以在这里找到我： https://www.linkedin.com/in/eddonner/ 虽然对我来说是新尝试，但我也在 X/Twitter 上开通了账号 @edwarddonner —— 如果你也在用 X，欢迎带我飞 😂

并不复杂的配置指南

也许这是我立下的 flag：但我真心希望我整理的环境配置过程不会太让人抓狂！

• Windows 用户，说明请看 这里
• Mac 用户，说明请看 这里
• Linux 用户，说明请看 这里

如有任何问题，请务必与我联系。

CrewAI 周（第 3 周）的重要注意事项

Windows PC 用户：请务必检查 SETUP-PC 说明顶部的“陷阱 #4” —— 即安装 Microsoft Build Tools。 如果你没做这一步，CrewAI 在执行时会报出一个涉及 Chroma 的晦涩错误。

接下来，你需要确保在项目根目录下的 Cursor 终端中运行以下命令，以便执行 Crew 命令： uv tool install crewai==0.130.0 --python 3.12 如果你之前使用过 Crew，建议运行以下命令以确保版本最新： uv tool upgrade crewai==0.130.0 --python 3.12

此命令将 Crew 锁定在我课程中使用的相同版本。如果你在使用 Crew 时遇到任何问题，也可以尝试通过运行以下命令使用最新版本： uv tool upgrade crewai --python 3.12

在任何时候，你都可以通过以下命令查看已安装的 Crew 版本： uv tool list

注：uv 中的“tool”是指由 uv 全局安装的工具。安装后，你可以直接使用“crewai”作为命令，它会执行与该工具关联的代码。

请注意以下关于 Crew 的事项：

1. 在第 3 周，你可以通过两种方式进行 CrewAI 项目的学习：要么在我演示时查看每个项目的代码，然后运行 crewai run 查看实际效果；或者如果你更倾向于动手实践，可以从零开始创建自己的 Crew 项目来同步练习，例如创建一个 my_debate 与我的 debate 并行，并跟随我一起编写代码。两种方法皆可！
2. Windows 用户：Crew 的某个库最近引入了一个新问题。在修复之前，当你尝试运行 crewai create crew 时，可能会遇到“unicode”错误。如果发生这种情况，请先尝试在终端中运行以下命令：$env:PYTHONUTF8 = "1"
3. Gemini 用户：除了在 .env 文件中设置 GOOGLE_API_KEY 外，你还需要一个相同的 GEMINI_API_KEY。

超级实用的资源

• 包含视频的课程 资源
• guides 部分中有许多基础指南
• 故障排除 笔记本
• 我的综合 常见问题 (FAQ) 页面，涵盖了常见问题与解答

API 费用 —— 请务必阅读！

本课程涉及调用 OpenAI 和其他前沿模型，需要 API Key 并产生少量费用（我们在设置指南中已说明）。如果你不想在 API 调用上付费，也有更便宜的替代方案，如 DeepSeek，或者使用 Ollama 等免费方案！

详细信息请参阅 这里。

请务必监控你的 API 费用，确保你对产生的开销感到满意。对于 OpenAI，仪表板在 这里。

最重要的一点 ——

请在课程中尽情享受乐趣！学习 Agentic AI，现在是最好的时机。希望你能享受每一分钟！如果遇到任何问题，请随时 联系我。