视频教程

观看此Youtube 视频教程，获取安装流程的分步演示：

文字教程

Python 版本要求

CrewAI 要求 Python >=3.10 and <3.14。你可以通过以下方式检查当前版本：

  1. python3 --version

如果你需要升级 Python，请访问 python.org/downloads

OpenAI SDK 要求

CrewAI 0.175.0 要求 openai >= 1.13.3。如果你是自行管理依赖，请确保当前环境满足该约束，以避免导入或运行时问题。

CrewAI 使用 uv 作为依赖管理和包处理工具。它简化了项目搭建与执行流程，带来更顺畅的使用体验。

如果你尚未安装 uv，请先按照步骤 1快速完成安装；如果已经安装，可以直接跳到步骤 2。

步骤1：安装 uv

  • 在 macOS/Linux 上： 使用 curl 下载脚本并通过 sh 执行：

    1.   curl -LsSf https://astral.sh/uv/install.sh | sh

    如果你的系统中没有 curl，也可以使用 wget：

    1.   wget -qO- https://astral.sh/uv/install.sh | sh

  • 在 Windows 上：

    使用 irm 下载脚本，并通过 iex 执行：

    1.   powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

    如果你遇到任何问题，请参考 UV 的安装指南 获取更多信息。:

步骤 2： 安装 CrewAI 🚀

  • 运行以下命令安装 crewai CLI：

    1.   uv tool install crewai

    如果遇到 PATH 警告，请运行以下命令更新你的 shell：

    1.   uv tool update-shell

    如果你在 Windows 上遇到 chroma-hnswlib==0.7.6 构建错误（fatal error C1083: Cannot open include file: 'float.h'），请安装 Visual Studio Build Tools，并勾选 使用 C++ 的桌面开发。

  • 要验证 crewai 是否安装成功，请运行：

    1.   uv tool list
  • 你应该会看到类似如下内容：
    1.   crewai v0.102.0
    2.   - crewai
  • 如果你需要更新 crewai，请运行：
    1.   uv tool install crewai --upgrade
    安装成功！你已经准备好创建你的第一个 crew 了！🎉 ````

创建一个 CrewAI 项目

我们推荐使用 YAML 模板脚手架，以更有条理地定义 agents 和 tasks。开始方式如下：

生成项目脚手架

  • 运行 crewai CLI 命令：
  1. crewai create crew <你的项目名称>
  1. - 这将创建一个具有如下结构的新项目：
  2.   ```
  3.   my_project/
  4.   ├── .gitignore
  5.   ├── knowledge/
  6.   ├── pyproject.toml
  7.   ├── README.md
  8.   ├── .env
  9.   └── src/
  10.       └── my_project/
  11.           ├── __init__.py
  12.           ├── main.py
  13.           ├── crew.py
  14.           ├── tools/
  15.           │   ├── custom_tool.py
  16.           │   └── __init__.py
  17.           └── config/
  18.               ├── agents.yaml
  19.               └── tasks.yaml
  20.   ```

自定义你的项目

  • 你的项目将包含以下核心文件：
文件 用途
agents.yaml 定义你的 AI agent 及其角色
tasks.yaml 配置 agent 任务与工作流
.env 存储 API 密钥和环境变量
main.py 项目入口与执行流程
crew.py Crew 编排与协同
tools/ 自定义 agent 工具目录
knowledge/ 知识库目录
  • 首先编辑 agents.yaml 和 tasks.yaml，定义你的 crew 行为。
  • 像 API 密钥这样的敏感信息请保存在 .env 中。

运行你的 Crew

  • 在运行你的 crew 之前，请先执行：
    1. crewai install
  • 如果你需要安装额外的包，请使用：
    1. uv add <package-name>
  • 要运行你的 crew，请在项目根目录执行以下命令：
    1. crewai run

企业版安装选项

对于团队和组织，CrewAI 提供企业级部署选项，可免除复杂的安装配置：

CrewAI AMP（SaaS）

  • 无需安装——只需前往 app.crewai.com 免费注册
  • 自动更新与维护
  • 托管式基础设施与弹性扩展
  • 无需编写代码即可构建 Crews

CrewAI Factory（自托管）

  • 面向自有基础设施的容器化部署
  • 支持任意云厂商，包括本地私有化部署
  • 可集成你现有的安全系统