掌握智能体工程——构建自主智能体

为期6周的旅程：使用OpenAI Agents SDK、CrewAI、LangGraph、AutoGen和MCP编码并部署智能体

如果您正在Cursor中查看本文档，请在左侧资源管理器中右键单击文件名，然后选择“打开预览”，以查看格式化后的版本。

我无比激动地欢迎您的加入！这将是您开启为期6周的冒险之旅的起点，深入探索强大、令人惊叹且常常充满超现实感的智能体AI世界。

在开始之前

我将竭诚为您提供帮助，助您取得最大成功！如果您需要任何协助，请随时通过平台或直接发送邮件至ed@edwarddonner.com与我联系。我也非常乐意在LinkedIn上与大家交流，共同建设社区——您可以在这里找到我：
https://www.linkedin.com/in/eddonner/
另外，这是我第一次尝试使用X/Twitter（@edwarddonner），如果您也在X上，请多多指教 😂

并不可怕的环境搭建说明

也许这是临别赠言：但我真心希望我已经为您准备了一个不会过于复杂的环境搭建流程！

• 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固定为与课程中使用的相同版本。如果遇到任何问题，您可以尝试使用最新版本，方法是运行：
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。

超实用资源

• 课程资源及视频
• 指南部分中的众多重要文档
• 故障排除笔记本
• 我的综合常见问题解答页面，涵盖常见问题与解答

API费用——请务必阅读！

本课程涉及调用OpenAI及其他前沿模型的API，因此需要API密钥和少量费用，这些已在环境搭建说明中完成配置。如果您不想产生API费用，也可以选择DeepSeek等更经济的替代方案，或者使用Ollama等免费选项！

详细信息请参阅此处。

请务必密切关注您的API费用支出，确保对任何开销都感到满意。对于OpenAI，您可以访问其仪表板：此处。

最重要的是——

请尽情享受本次课程！现在正是学习智能体AI的最佳时机。衷心祝愿您每一分钟都能收获乐趣！如果您在学习过程中遇到任何困难，请随时联系我。

AI 智能体工程快速上手指南

本指南基于 agents 开源项目，旨在帮助开发者在 6 周内掌握使用 OpenAI Agents SDK、CrewAI、LangGraph、AutoGen 和 MCP 构建自主 AI 智能体的核心技能。

环境准备

系统要求

• 操作系统：Windows、macOS 或 Linux
• Python 版本：推荐 Python 3.12（项目强依赖此版本，特别是 CrewAI 部分）
• 编辑器：推荐使用 Cursor 或 VS Code（需支持 Markdown 预览和终端操作）

前置依赖

• API Key：需准备 OpenAI API Key。若希望降低成本或使用免费方案，可配置 DeepSeek 或本地 Ollama 模型。
• 网络环境：确保能访问 GitHub 及 Python 包索引（如遇到下载慢，可配置国内镜像源）。
• 特定工具：
  • Windows 用户必装：Microsoft Build Tools（否则 CrewAI 安装会因 Chroma 依赖报错）。
  • 包管理器：项目推荐使用 uv 进行环境和工具管理。

安装步骤

请根据你的操作系统选择对应的详细设置文档执行基础环境配置：

• Windows: 参考 setup/SETUP-PC.md
• macOS: 参考 setup/SETUP-mac.md
• Linux: 参考 setup/SETUP-linux.md

核心工具安装 (CrewAI 专项)

进入项目根目录，在终端中执行以下命令以安装课程指定的 CrewAI 版本（基于 Python 3.12）：

uv tool install crewai==0.130.0 --python 3.12

若需升级至最新版或修复版本问题，可运行：

uv tool upgrade crewai --python 3.12

验证安装版本：

uv tool list

注意：uv tool 会将工具全局安装，安装完成后即可直接在命令行使用 crewai 命令。

特殊配置说明

• Windows 用户：若运行 crewai create crew 时出现 "unicode" 错误，请先在终端执行：

  $env:PYTHONUTF8 = "1"
  

• Gemini 用户：除 .env 文件中的 GOOGLE_API_KEY 外，还需添加相同的 key 作为 GEMINI_API_KEY。

基本使用

本项目主要通过周次任务驱动学习，以下是第 3 周（CrewAI）的快速启动示例：

方式一：运行现有项目

直接查看课程提供的示例代码（如 debate），并在项目目录下运行：

crewai run

方式二：从零创建项目

你可以模仿示例创建自己的智能体项目（例如创建一个名为 my_debate 的项目）：

crewai create crew my_debate

创建后，进入目录编写代码并运行。

成本与模型替代

默认配置可能调用付费 API。若需切换至低成本或本地模型（如 Ollama），请参考 guides/09_ai_apis_and_ollama.ipynb 中的配置说明，修改 .env 文件中的模型端点和 Key。

---

提示：开发过程中请随时监控 API 用量。如遇阻碍，建议查阅项目内的 guides 文件夹或官方故障排除笔记 setup/troubleshooting.ipynb。